NormalizedAmplitudeToMask

El nodo NormalizedAmplitudeToMask recibe como entrada un array de números de punto flotante que representan la amplitud de audio, con su rango de valores limitado entre 0 y 1.

El nodo NormalizedAmplitudeToMask es una herramienta impulsada por audio que convierte datos de amplitud de audio normalizados en una máscara de imagen. Este nodo actúa como un puente entre el procesamiento de audio y la generación de imágenes, permitiendo a los usuarios generar o influenciar elementos visuales de forma dinámica según la intensidad del sonido.
Funciona como puente hacia los nodos AudioScheduler.

Funcionalidad del Nodo

Este nodo recibe como entrada un array de números de punto flotante que representan la amplitud de audio, con su rango de valores limitado entre 0 y 1. Su mecanismo central ajusta la alineación temporal de los datos de amplitud mediante un parámetro opcional de desplazamiento de fotogramas (frame_offset), y luego genera la máscara correspondiente en un lienzo definido por el usuario, según la forma, posición, tamaño y modo de color especificados. Admite la generación de regiones de máscara con formas circulares, cuadradas, triangulares o sin forma específica.

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

Entradas (Inputs)

Nombre del Parámetro	Tipo de Dato	Requerido	Valor por Defecto	Rango/Opciones	Descripción
`normalized_amp`	NORMALIZED_AMPLITUDE	Sí	-	-	normalized_amp (parámetro de entrada): Introduce los datos de amplitud de audio normalizados, cuyos valores deben estar entre 0 y 1. Estos son los datos centrales que impulsan la generación de la máscara.

Parámetros de Control (Parameters)

Nombre del Parámetro	Tipo de Dato	Requerido	Valor por Defecto	Rango/Opciones	Descripción
`shape`	COMBO	Sí	none	"none", "circle", "square", "triangle"	"Círculo", "Cuadrado" o "Triángulo".
`color`	COMBO	Sí	white	"white", "amplitude"	color (parámetro de entrada): Determina el valor (color) dentro de la región de la máscara. Opciones: "white" (blanco, valor 1) o "amplitude" (utiliza el valor de amplitud normalizado de entrada como intensidad para esa región).
`width`	INT	Sí	512	16 - 4096 (step: 1)	width (parámetro de entrada): Establece el ancho de la imagen de máscara de salida. Rango de 16 a 4096 píxeles, con un paso de 1.
`height`	INT	Sí	512	16 - 4096 (step: 1)	height (parámetro de entrada): Establece la altura de la imagen de máscara de salida. Rango de 16 a 4096 píxeles, con un paso de 1.
`frame_offset`	INT	Sí	0	-255 - 255 (step: 1)	frame_offset (parámetro de entrada): Número de fotogramas para desplazar temporalmente los datos de amplitud de entrada, utilizado para ajustar la sincronización entre audio y video. Rango de -255 a 255, con un paso de 1.
`location_x`	INT	Sí	256	0 - 4096 (step: 1)	location_x (parámetro de entrada): Especifica la posición horizontal central (coordenada X) de la forma dibujada en el lienzo. Rango de 0 a 4096, con un paso de 1.
`location_y`	INT	Sí	256	0 - 4096 (step: 1)	location_y (parámetro de entrada): Especifica la posición vertical central (coordenada Y) de la forma dibujada en el lienzo. Rango de 0 a 4096, con un paso de 1.
`size`	INT	Sí	128	8 - 4096 (step: 1)	size (parámetro de entrada): Controla el tamaño básico de la forma dibujada (por ejemplo, radio o longitud del lado). Rango de 8 a 4096, con un paso de 1.

Salida (Output)

Nombre del Parámetro	Tipo de Dato	Descripción
MASK	MASK	MASK (parámetro de salida): Salida de la máscara de imagen generada según la amplitud de audio.

Casos de Uso

Este nodo es muy útil en flujos de trabajo de generación de video o animación. Por ejemplo, puedes conectar el ritmo (amplitud) de una pieza musical al nodo para generar una máscara circular cuyo tamaño cambie con el pulso de la música, y luego usar esta máscara para controlar el área de visualización de otra capa, creando así un efecto de visualización musical. Suele utilizarse en conjunto con otros nodos de audio como AudioScheduler.

Consideraciones

Al usarlo, es importante tener en cuenta que los datos de amplitud de entrada deben ser un array ya normalizado al rango [0, 1]. El tamaño de la máscara generada está limitado por el ancho y alto del lienzo establecidos por el usuario, y los parámetros de posición y tamaño de la forma no deben exceder los límites del lienzo; de lo contrario, parte de la región de la máscara no será visible.

Enlace al Código Fuente del Nodo NormalizedAmplitudeToMask

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