NormalizedAmplitudeToMask

Узел NormalizedAmplitudeToMask принимает на вход массив чисел с плавающей запятой, представляющих амплитуду аудио, со значениями, ограниченными диапазоном от 0 до 1.

Узел NormalizedAmplitudeToMask — это инструмент, управляемый аудио, который преобразует нормализованные данные амплитуды аудио в маску изображения. Этот узел служит мостом, соединяющим обработку аудио и генерацию изображений, позволяя пользователям динамически создавать или влиять на визуальные элементы на основе громкости звука.
Работает как мост к узлам AudioScheduler.

Функциональность узла

Этот узел принимает на вход массив чисел с плавающей запятой, представляющих амплитуду аудио, со значениями, ограниченными диапазоном от 0 до 1. Основной механизм заключается в корректировке временного выравнивания данных амплитуды с помощью необязательного параметра смещения кадров, а затем в генерации соответствующей маски на заданном пользователем холсте в соответствии с указанной формой, положением, размером и режимом цвета. Поддерживается создание областей маски в форме круга, квадрата, треугольника или без указания формы.

Описание параметров узла — NormalizedAmplitudeToMask

Входные соединения (Inputs)

Имя параметра	Тип данных	Обязательный	Значение по умолчанию	Диапазон значений/Опции	Описание
`normalized_amp`	NORMALIZED_AMPLITUDE	Да	-	-	normalized_amp (входной параметр): Входные нормализованные данные амплитуды аудио. Значения должны быть в диапазоне от 0 до 1. Это основные данные, управляющие генерацией маски.

Параметры управления (Parameters)

Имя параметра	Тип данных	Обязательный	Значение по умолчанию	Диапазон значений/Опции	Описание
`shape`	КОМБО	Да	none	"none", "circle", "square", "triangle"	Форма области маски: "circle" (круг), "square" (квадрат) или "triangle" (треугольник).
`color`	КОМБО	Да	amplitude	"white", "amplitude"	color (входной параметр): Определяет значение (цвет) внутри области маски. Доступны варианты "white" (белый, значение 1) или "amplitude" (использование входного нормализованного значения амплитуды в качестве интенсивности для этой области).
`width`	ЦЕЛОЕ	Да	512	16 - 4096 (шаг: 1)	width (входной параметр): Устанавливает ширину выходного изображения маски. Диапазон от 16 до 4096 пикселей, шаг 1.
`height`	ЦЕЛОЕ	Да	512	16 - 4096 (шаг: 1)	height (входной параметр): Устанавливает высоту выходного изображения маски. Диапазон от 16 до 4096 пикселей, шаг 1.
`frame_offset`	ЦЕЛОЕ	Да	0	-255 - 255 (шаг: 1)	frame_offset (входной параметр): Смещение входных данных амплитуды по времени в кадрах, используется для корректировки синхронизации аудио и видео. Диапазон от -255 до 255, шаг 1.
`location_x`	ЦЕЛОЕ	Да	256	0 - 4096 (шаг: 1)	location_x (входной параметр): Задает горизонтальную позицию центра (координата X) рисуемой формы на холсте. Диапазон от 0 до 4096, шаг 1.
`location_y`	ЦЕЛОЕ	Да	256	0 - 4096 (шаг: 1)	location_y (входной параметр): Задает вертикальную позицию центра (координата Y) рисуемой формы на холсте. Диапазон от 0 до 4096, шаг 1.
`size`	ЦЕЛОЕ	Да	128	8 - 4096 (шаг: 1)	size (входной параметр): Управляет базовым размером рисуемой формы (например, радиусом или длиной стороны). Диапазон от 8 до 4096, шаг 1.

Выходные данные (Output)

Имя параметра	Тип данных	Описание
MASK	MASK	MASK (выходной параметр): Выводит сгенерированную на основе амплитуды аудио маску изображения.

Сценарии использования

Этот узел очень полезен в рабочих процессах генерации видео или анимации. Например, можно подключить ритм музыкальной дорожки (амплитуду) к узлу, чтобы сгенерировать круглую маску, размер которой меняется в такт ударам барабанов, а затем использовать эту маску для управления областью отображения другого слоя, создавая таким образом эффект визуализации музыки. Он часто используется совместно с аудиоузлами, такими как AudioScheduler.

Важные замечания

При использовании необходимо учитывать, что входные данные амплитуды должны быть уже нормализованным массивом в диапазоне [0, 1]. Размер генерируемой маски ограничен установленной пользователем шириной и высотой холста, а параметры положения и размера формы не должны выходить за границы холста, иначе часть области маски будет невидима.

Ссылка на исходный код узла NormalizedAmplitudeToMask

Узел NormalizedAmplitudeToMask взят из пакета узлов ComfyUI-KJNodes.