ImageTransformByNormalizedAmplitude

El nodo ImageTransformByNormalizedAmplitude recibe técnicamente un array de tipo NORMALIZED_AMPLITUDE y un lote de imágenes IMAGE como entrada.

El nodo ImageTransformByNormalizedAmplitude es un nodo de procesamiento de imágenes que puede transformar imágenes dinámicamente según los datos de amplitud de audio de entrada. Su función principal es mapear los valores de amplitud normalizada del audio a operaciones de escala y desplazamiento de la imagen, creando así efectos visuales que cambian sincronizados con el ritmo del audio.

Funcionalidad del Nodo

Técnicamente, este nodo recibe un array de tipo NORMALIZED_AMPLITUDE y un lote de imágenes IMAGE como entrada. Internamente, recorta los valores de amplitud al rango [0, 1] y calcula las dimensiones de recorte de la imagen en función del valor de amplitud, logrando un efecto de zoom. Además, el nodo admite un modo acumulativo, que puede sumar los cambios de amplitud continuos para producir un impacto visual más intenso. Las imágenes procesadas se emiten en formato IMAGE, manteniendo la misma estructura de lote que la entrada.

Explicación de los Parámetros del Nodo - ImageTransformByNormalizedAmplitude

Entradas (Inputs)

Nombre del Parámetro	Tipo de Dato	Obligatorio	Valor por Defecto	Rango/Opciones	Descripción
`normalized_amp`	NORMALIZED_AMPLITUDE	Sí	-	-	normalized_amp (parámetro de entrada): Recibe datos de amplitud de audio normalizados para impulsar la transformación de la imagen. El rango de valores está limitado entre 0.0 y 1.0.
`image`	IMAGE	Sí	-	-	image (parámetro de entrada): Introduce el lote de imágenes originales a transformar.

Parámetros de Control (Parameters)

Nombre del Parámetro	Tipo de Dato	Obligatorio	Valor por Defecto	Rango/Opciones	Descripción
`zoom_scale`	FLOTANTE	Sí	0.0	-1.0 - 1.0 (paso: 0.001)	zoom_scale (parámetro de entrada): Controla el coeficiente base que afecta al zoom de la imagen según la amplitud. El rango de valores es de -1.0 a 1.0, con un paso de 0.001.
`x_offset`	ENTERO	Sí	0	-	x_offset (parámetro de entrada): Establece el desplazamiento base de la imagen en la dirección horizontal (eje X). El rango de valores está limitado por la resolución máxima del sistema.
`y_offset`	ENTERO	Sí	0	-	y_offset (parámetro de entrada): Establece el desplazamiento base de la imagen en la dirección vertical (eje Y). El rango de valores está limitado por la resolución máxima del sistema.
`cumulative`	BOOLEANO	Sí	falso	-	cumulative (parámetro de entrada): Habilita el modo acumulativo. Cuando se establece en verdadero, el efecto de amplitud se acumula fotograma a fotograma, aumentando la intensidad de la transformación.

Salida (Output)

Nombre del Parámetro	Tipo de Dato	Descripción
IMAGE	IMAGE	IMAGE (parámetro de salida): Emite el lote de imágenes transformadas impulsado por la amplitud.

Casos de Uso

Un caso de uso típico es en un flujo de trabajo que combina audio para generar vídeo. El usuario puede conectar los datos de amplitud normalizada emitidos por el nodo AudioScheduler a este nodo, mientras introduce simultáneamente un conjunto de imágenes de fotogramas clave. El nodo realizará automáticamente diferentes grados de zoom y desplazamiento en cada fotograma de imagen según la amplitud del audio en tiempo real, generando así una secuencia de vídeo dinámica que "late" o "respira" al ritmo de la música.

Consideraciones

Tenga en cuenta que este nodo está diseñado para funcionar con la extensión ComfyUI-AudioScheduler para garantizar el formato correcto de los datos de amplitud. El número de imágenes en el lote de entrada debe coincidir con la longitud del array de amplitud; de lo contrario, podría producirse un error.

Enlace al Código Fuente del Nodo ImageTransformByNormalizedAmplitude

El nodo ImageTransformByNormalizedAmplitude proviene del paquete de nodos ComfyUI-KJNodes.