Create Audio Mask (CreateAudioMask) - ComfyUI-KJNodes

Obsoleto: Este nodo ha sido marcado como obsoleto y se ha movido a la categoría KJNodes/deprecated. Es posible que se elimine en futuras actualizaciones. Considere usar nodos alternativos para la generación de máscaras basadas en audio.

El nodo Create Audio Mask carga un archivo de audio WAV desde una ruta especificada y utiliza la biblioteca librosa para calcular su transformada de Fourier de tiempo corto (STFT) y obtener datos espectrales.

El nodo Create Audio Mask genera dinámicamente una serie de máscaras de imagen basadas en la información espectral de un archivo de audio. Su función principal es transformar las variaciones de amplitud del audio en una secuencia visual de máscaras circulares, proporcionando elementos visuales sincronizados con el ritmo del audio para el posterior procesamiento de imágenes o composición de vídeo.

Funcionalidad del Nodo

Este nodo carga un archivo de audio WAV desde una ruta especificada y utiliza la biblioteca librosa para calcular su transformada de Fourier de tiempo corto (STFT) y obtener datos espectrales. Según el número de fotogramas establecido, el nodo extrae la amplitud promedio del segmento de tiempo correspondiente del espectro. Luego, multiplica este valor de amplitud por un factor de escala para calcular el radio de un círculo, generando finalmente una imagen de un círculo blanco (o un círculo negro invertido) en el centro de un lienzo del tamaño especificado.

Explicación de los Parámetros del Nodo - Create Audio Mask

Parámetros de Control (Parameters)

Nombre del Parámetro	Tipo de Dato	Obligatorio	Valor por Defecto	Rango de Valores/Opciones	Descripción
`invert`	BOOLEAN	Sí	False	-	invert (parámetro de entrada): Invierte el color de la máscara. Cuando es False, genera un círculo negro sobre fondo blanco; cuando es True, genera un círculo blanco sobre fondo negro.
`frames`	INT	Sí	16	1 - 255 (incremento: 1)	frames (parámetro de entrada): Establece el número total de fotogramas de máscaras de imagen a generar. El rango de valores es de 1 a 255.
`scale`	FLOAT	Sí	0.5	0.0 - 2.0 (incremento: 0.01)	scale (parámetro de entrada): Controla el factor de escala para el radio del círculo. El rango de valores es de 0.0 a 2.0, con un incremento de 0.01.
`audio_path`	STRING	Sí	audio.wav	-	audio_path (parámetro de entrada): Especifica la ruta del archivo de audio de entrada como una cadena de texto. Por defecto, lee el archivo "audio.wav" en el directorio actual.
`width`	INT	Sí	256	16 - 4096 (incremento: 1)	width (parámetro de entrada): Establece el valor en píxeles del ancho de la imagen de máscara de salida. El rango de valores es de 16 a 4096.
`height`	INT	Sí	256	16 - 4096 (incremento: 1)	height (parámetro de entrada): Establece el valor en píxeles del alto de la imagen de máscara de salida. El rango de valores es de 16 a 4096.

Salida (Output)

Nombre del Parámetro	Tipo de Dato	Descripción
IMAGE	IMAGE	IMAGE (parámetro de salida): Secuencia de imágenes generada, que corresponde a la máscara visual del espectro de frecuencia del audio.

Casos de Uso

Este nodo es muy útil en flujos de trabajo para crear visualizaciones musicales cortas o efectos que requieren sincronización entre audio e imagen. Puedes conectar la secuencia de imágenes generada (máscaras) a nodos de mezcla de imágenes o de repintado de regiones para controlar el área donde ciertos elementos (como destellos o partículas) aparecen o desaparecen siguiendo el ritmo de la música, logrando así un efecto visual impulsado por el audio.

Consideraciones

Este nodo depende de la biblioteca librosa. Si no está instalada, causará un error de ejecución. La ruta de audio por defecto es "audio.wav". Si el archivo no se encuentra en el directorio raíz de ComfyUI, puede ser necesario usar una ruta absoluta para asegurar que el nodo pueda leer el archivo correctamente.

Enlace al Código Fuente del Nodo Create Audio Mask

El nodo Create Audio Mask proviene del paquete de nodos ComfyUI-KJNodes.

Create Audio Mask(CreateAudioMask)