ImageTransformByNormalizedAmplitude

Узел ImageTransformByNormalizedAmplitude технически принимает на вход массив типа NORMALIZED_AMPLITUDE и пакет изображений IMAGE.

ImageTransformByNormalizedAmplitude — это узел обработки изображений, способный динамически преобразовывать изображения на основе входных данных амплитуды аудио. Его основная функция заключается в сопоставлении нормализованных значений амплитуды аудио с операциями масштабирования и смещения изображения, создавая визуальные эффекты, синхронизированные с ритмом аудио.

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

Технически этот узел принимает на вход массив типа NORMALIZED_AMPLITUDE и пакет изображений IMAGE. Внутри он обрезает значения амплитуды до диапазона [0, 1] и вычисляет размер обрезки изображения на основе значения амплитуды, реализуя эффект масштабирования. Кроме того, узел поддерживает кумулятивный режим, который позволяет накапливать последовательные изменения амплитуды для создания более сильного визуального воздействия. Обработанные изображения выводятся в формате IMAGE, сохраняя ту же структуру пакета, что и на входе.

Описание параметров узла - ImageTransformByNormalizedAmplitude

Входные подключения (Inputs)

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

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

Имя параметра	Тип данных	Обязательный	Значение по умолчанию	Диапазон значений/Опции	Описание
`zoom_scale`	FLOAT	Да	0.0	-1.0 - 1.0 (шаг: 0.001)	zoom_scale (входной параметр): Управляет базовым коэффициентом влияния амплитуды на масштабирование изображения. Диапазон значений от -1.0 до 1.0 с шагом 0.001.
`x_offset`	INT	Да	0	-	x_offset (входной параметр): Задает базовое смещение изображения по горизонтальной оси (X). Диапазон значений ограничен максимальным разрешением системы.
`y_offset`	INT	Да	0	-	y_offset (входной параметр): Задает базовое смещение изображения по вертикальной оси (Y). Диапазон значений ограничен максимальным разрешением системы.
`cumulative`	BOOLEAN	Да	False	-	cumulative (входной параметр): Включает кумулятивный режим. При значении True эффект амплитуды накапливается от кадра к кадру, усиливая интенсивность преобразования.

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

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

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

Типичный пример использования — в рабочих процессах создания видео с аудио. Пользователь может подключить нормализованные данные амплитуды, выводимые узлом AudioScheduler, к этому узлу, одновременно подав на вход набор ключевых кадров изображений. Узел будет автоматически применять различную степень масштабирования и смещения к каждому кадру на основе текущей амплитуды аудио, генерируя тем самым динамическую видео-последовательность, которая "пульсирует" или "дышит" в ритме музыки.

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

Обратите внимание, что этот узел предназначен для совместного использования с расширением ComfyUI-AudioScheduler, чтобы обеспечить корректный формат данных амплитуды. Количество изображений во входном пакете должно соответствовать длине массива амплитуды, иначе может возникнуть ошибка.

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

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