NormalizedAmplitudeToMask

Le nœud NormalizedAmplitudeToMask reçoit en entrée un tableau de nombres flottants représentant l'amplitude audio, dont les valeurs sont limitées entre 0 et 1.

Le nœud NormalizedAmplitudeToMask est un outil piloté par l'audio qui convertit des données d'amplitude audio normalisées en masques d'image. Ce nœud sert de pont entre le traitement audio et la génération d'images, permettant aux utilisateurs de générer ou d'influencer dynamiquement des éléments visuels en fonction de l'intensité sonore.
Fonctionne comme un pont vers les nœuds AudioScheduler.

Fonctionnalités du nœud

Ce nœud reçoit en entrée un tableau de nombres flottants représentant l'amplitude audio, dont les valeurs sont limitées entre 0 et 1. Son mécanisme central consiste à ajuster l'alignement temporel des données d'amplitude via un paramètre optionnel de décalage de trame (frame offset), puis à générer le masque correspondant sur une toile définie par l'utilisateur, selon la forme, la position, la taille et le mode de couleur spécifiés. Il prend en charge la génération de zones de masque de forme circulaire, carrée, triangulaire ou sans forme spécifiée.

Explication des paramètres du nœud - NormalizedAmplitudeToMask

Entrées (Inputs)

Nom du paramètre	Type de données	Requis	Valeur par défaut	Plage/Valeurs possibles	Description
`normalized_amp`	NORMALIZED_AMPLITUDE	Oui	-	-	normalized_amp (paramètre d'entrée) : Données d'amplitude audio normalisées en entrée. Les valeurs doivent être comprises entre 0 et 1. Ce sont les données centrales qui pilotent la génération du masque.

Paramètres de contrôle (Parameters)

Nom du paramètre	Type de données	Requis	Valeur par défaut	Plage/Valeurs possibles	Description
`shape`	COMBO	Oui	none	"none", "circle", "square", "triangle"	"circle" (cercle), "square" (carré) ou "triangle" (triangle).
`color`	COMBO	Oui	amplitude	"white", "amplitude"	color (paramètre d'entrée) : Détermine la valeur (couleur) à l'intérieur de la zone du masque. Options : "white" (blanc, valeur 1) ou "amplitude" (utilise la valeur d'amplitude normalisée en entrée comme intensité pour cette zone).
`width`	INT	Oui	512	16 - 4096 (pas: 1)	width (paramètre d'entrée) : Définit la largeur de l'image masque en sortie. Plage de 16 à 4096 pixels, avec un pas de 1.
`height`	INT	Oui	512	16 - 4096 (pas: 1)	height (paramètre d'entrée) : Définit la hauteur de l'image masque en sortie. Plage de 16 à 4096 pixels, avec un pas de 1.
`frame_offset`	INT	Oui	0	-255 - 255 (pas: 1)	frame_offset (paramètre d'entrée) : Nombre de trames de décalage temporel appliqué aux données d'amplitude en entrée, utilisé pour ajuster la synchronisation audio/vidéo. Plage de -255 à 255, avec un pas de 1.
`location_x`	INT	Oui	256	0 - 4096 (pas: 1)	location_x (paramètre d'entrée) : Spécifie la position horizontale du centre (coordonnée X) de la forme dessinée sur la toile. Plage de 0 à 4096, avec un pas de 1.
`location_y`	INT	Oui	256	0 - 4096 (pas: 1)	location_y (paramètre d'entrée) : Spécifie la position verticale du centre (coordonnée Y) de la forme dessinée sur la toile. Plage de 0 à 4096, avec un pas de 1.
`size`	INT	Oui	128	8 - 4096 (pas: 1)	size (paramètre d'entrée) : Contrôle la taille de base de la forme dessinée (par exemple, rayon ou longueur du côté). Plage de 8 à 4096, avec un pas de 1.

Sortie (Output)

Nom du paramètre	Type de données	Description
MASK	MASK	MASK (paramètre de sortie) : Masque d'image généré en fonction de l'amplitude audio.

Cas d'utilisation

Ce nœud est très utile dans les flux de travail de génération vidéo ou d'animation. Par exemple, vous pouvez connecter le rythme (amplitude) d'une musique au nœud pour générer un masque circulaire dont la taille varie avec les battements de la musique, puis utiliser ce masque pour contrôler la zone d'affichage d'un autre calque, créant ainsi un effet de visualisation musicale. Il est souvent utilisé en conjonction avec d'autres nœuds audio comme AudioScheduler.

Notes importantes

Lors de l'utilisation, il est essentiel de noter que les données d'amplitude en entrée doivent être un tableau déjà normalisé dans la plage [0, 1]. Les dimensions du masque généré sont limitées par la largeur et la hauteur de la toile définies par l'utilisateur. De plus, les paramètres de position et de taille de la forme ne doivent pas dépasser les limites de la toile, sinon une partie de la zone du masque sera invisible.

Lien vers le code source du nœud NormalizedAmplitudeToMask

Le nœud NormalizedAmplitudeToMask provient du pack de nœuds ComfyUI-KJNodes.