OffsetMaskByNormalizedAmplitude

El nodo OffsetMaskByNormalizedAmplitude recibe como entradas principales una máscara de tipo MASK y una secuencia de amplitud normalizada de tipo NORMALIZED_AMPLITUDE. Sirve como puente a los nodos AudioScheduler (https://github.com/a1lazydog/ComfyUI-AudioScheduler).

El nodo OffsetMaskByNormalizedAmplitude es una herramienta de transformación de máscaras impulsada por audio. Su función principal es desplazar o rotar dinámicamente la imagen de la máscara en función de los valores de amplitud normalizada de entrada, transformando así los cambios de ritmo o intensidad del audio en efectos visuales dinámicos.

Funcionalidad del Nodo

Este nodo recibe como entradas principales una máscara de tipo MASK y una secuencia de amplitud normalizada de tipo NORMALIZED_AMPLITUDE. Internamente, calcula el desplazamiento o el ángulo de rotación de la máscara para cada fotograma multiplicando los valores de amplitud por un desplazamiento predefinido (x, y) o por un multiplicador de ángulo (angle_multiplier), y ejecuta la transformación utilizando las funciones roll y rotate de PyTorch. Los valores de amplitud se recortan automáticamente al rango [0, 1], garantizando la estabilidad de la transformación.

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

Entradas (Inputs)

Nombre del Parámetro	Tipo de Dato	Obligatorio	Valor por Defecto	Rango/Opciones	Descripción
`normalized_amp`	NORMALIZED_AMPLITUDE	Sí	-	-	: Secuencia de amplitud normalizada, cuyo rango está limitado entre 0.0 y 1.0, utilizada para impulsar la cantidad de desplazamiento y rotación de la máscara.
`mask`	MASK	Sí	-	-	: La máscara que se va a desplazar o rotar.

Parámetros de Control (Parameters)

Nombre del Parámetro	Tipo de Dato	Obligatorio	Valor por Defecto	Rango/Opciones	Descripción
`x`	INT	Sí	0	-4096 - MAX_RESOLUTION (paso: 1)	: Controla la intensidad base del desplazamiento horizontal (eje X) de la máscara. El rango de valores es de -4096 a MAX_RESOLUTION, con un paso de 1.
`y`	INT	Sí	0	-4096 - MAX_RESOLUTION (paso: 1)	: Controla la intensidad base del desplazamiento vertical (eje Y) de la máscara. El rango de valores es de -4096 a MAX_RESOLUTION, con un paso de 1.
`rotate`	BOOLEAN	Sí	False	-	: Interruptor booleano. Cuando se establece en True, habilita la función de rotación de máscara basada en la amplitud.
`angle_multiplier`	FLOAT	Sí	0.0	-1.0 - 1.0 (paso: 0.001)	: Multiplicador del ángulo de rotación, que junto con la amplitud determina el ángulo de rotación. El rango de valores es de -1.0 a 1.0, con un paso de 0.001.

Salida (Output)

Nombre del Parámetro	Tipo de Dato	Descripción
mask	MASK	: La nueva máscara después de aplicar la transformación de desplazamiento o rotación.

Casos de Uso

En aplicaciones concretas, este nodo suele utilizarse junto con nodos de la serie AudioScheduler para crear visualizaciones musicales o animaciones reactivas al audio. Por ejemplo, en un flujo de trabajo de generación de vídeo, se puede introducir el resultado del análisis de amplitud de una pieza musical en este nodo para controlar la posición o rotación de una máscara en primer plano, sincronizando el movimiento de la máscara con el ritmo de la música y generando así efectos visuales dinámicos y atractivos.

Consideraciones

Al utilizarlo, es importante tener en cuenta que el desplazamiento y la rotación de la máscara se calculan en función de los valores instantáneos de la amplitud. Valores de desplazamiento excesivamente grandes pueden provocar efectos de envoltura no deseados en los bordes de la imagen. Además, se debe asegurar que la entrada de amplitud sean datos normalizados.

Enlace al Código Fuente del Nodo OffsetMaskByNormalizedAmplitude

El nodo OffsetMaskByNormalizedAmplitude pertenece al paquete de nodos ComfyUI-KJNodes.