ImageTransformByNormalizedAmplitude

Le nœud ImageTransformByNormalizedAmplitude reçoit techniquement un tableau de type NORMALIZED_AMPLITUDE et un lot d'images IMAGE en entrée.

Le nœud ImageTransformByNormalizedAmplitude est un nœud de traitement d'image capable de transformer dynamiquement des images en fonction des données d'amplitude audio fournies en entrée. Sa fonction principale consiste à mapper les valeurs d'amplitude audio normalisées vers des opérations de mise à l'échelle (zoom) et de déplacement (offset) de l'image, créant ainsi des effets visuels qui évoluent en synchronisation avec le rythme audio.

Fonctionnalités du nœud

Techniquement, ce nœud reçoit un tableau de type NORMALIZED_AMPLITUDE et un lot d'images IMAGE en entrée. En interne, il recadre les valeurs d'amplitude dans la plage [0, 1] et calcule les dimensions de recadrage de l'image en fonction de ces valeurs, réalisant ainsi l'effet de zoom. Le nœud prend également en charge un mode cumulatif, permettant d'accumuler les variations d'amplitude sur plusieurs trames consécutives pour produire un impact visuel plus marqué. Les images traitées sont renvoyées au format IMAGE, en conservant la même structure de lot que l'entrée.

Spécifications des paramètres - ImageTransformByNormalizedAmplitude

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) : Reçoit les données d'amplitude audio normalisées utilisées pour piloter la transformation de l'image. Les valeurs sont limitées à la plage de 0.0 à 1.0.
`image`	IMAGE	Oui	-	-	image (paramètre d'entrée) : Lot d'images originales à transformer.

Paramètres de contrôle (Parameters)

Nom du paramètre	Type de données	Requis	Valeur par défaut	Plage/Valeurs possibles	Description
`zoom_scale`	FLOAT	Oui	0.0	-1.0 - 1.0 (pas: 0.001)	zoom_scale (paramètre d'entrée) : Contrôle le coefficient de base de l'influence de l'amplitude sur le zoom de l'image. Plage de -1.0 à 1.0, avec un pas de 0.001.
`x_offset`	INT	Oui	0	-	x_offset (paramètre d'entrée) : Définit le décalage de base de l'image sur l'axe horizontal (X). La plage est limitée par la résolution maximale du système.
`y_offset`	INT	Oui	0	-	y_offset (paramètre d'entrée) : Définit le décalage de base de l'image sur l'axe vertical (Y). La plage est limitée par la résolution maximale du système.
`cumulative`	BOOLEAN	Oui	False	-	cumulative (paramètre d'entrée) : Active le mode cumulatif. Lorsqu'il est défini sur True, l'effet de l'amplitude s'accumule d'une trame à l'autre, augmentant l'intensité de la transformation.

Sortie (Output)

Nom du paramètre	Type de données	Description
IMAGE	IMAGE	IMAGE (paramètre de sortie) : Lot d'images transformées, pilotées par l'amplitude.

Cas d'utilisation

Un cas d'utilisation typique se trouve dans un flux de travail de génération vidéo combiné à de l'audio. L'utilisateur peut connecter les données d'amplitude normalisées en sortie d'un nœud AudioScheduler à ce nœud, tout en fournissant un ensemble d'images clés en entrée. Le nœud appliquera alors automatiquement différents niveaux de zoom et de décalage à chaque trame d'image en fonction de l'amplitude audio en temps réel, générant ainsi une séquence vidéo dynamique qui "pulse" ou "respire" au rythme de la musique.

Notes importantes

Veuillez noter que ce nœud est conçu pour fonctionner avec l'extension ComfyUI-AudioScheduler afin de garantir le format correct des données d'amplitude. Le nombre d'images dans le lot d'entrée doit correspondre à la longueur du tableau d'amplitude, sinon une erreur peut survenir.

Lien vers le code source du nœud ImageTransformByNormalizedAmplitude

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