OffsetMaskByNormalizedAmplitude

Le nœud OffsetMaskByNormalizedAmplitude reçoit un masque de type MASK et une séquence d'amplitude normalisée de type NORMALIZED_AMPLITUDE comme entrées principales. Il sert de pont vers les nœuds AudioScheduler (https://github.com/a1lazydog/ComfyUI-AudioScheduler).

Le nœud OffsetMaskByNormalizedAmplitude est un outil de transformation de masque piloté par l'audio. Sa fonction principale est de décaler ou de faire pivoter dynamiquement une image de masque en fonction des valeurs d'amplitude normalisée en entrée, transformant ainsi les variations de rythme ou d'intensité audio en effets visuels dynamiques.

Fonctionnalité du nœud

Ce nœud prend en entrée principale un masque de type MASK et une séquence d'amplitude normalisée de type NORMALIZED_AMPLITUDE. En interne, il calcule le déplacement ou l'angle de rotation du masque pour chaque image en multipliant la valeur d'amplitude par un décalage prédéfini (x, y) ou un multiplicateur d'angle (angle_multiplier), et exécute la transformation à l'aide des fonctions roll et rotate de PyTorch. Les valeurs d'amplitude sont automatiquement recadrées dans la plage [0, 1] pour garantir la stabilité de la transformation.

Explication des paramètres du nœud - OffsetMaskByNormalizedAmplitude

Entrées de connexion (Inputs)

Nom du paramètre	Type de données	Requis	Valeur par défaut	Plage de valeurs/Options	Description
`normalized_amp`	NORMALIZED_AMPLITUDE	Oui	-	-	: Séquence d'amplitude normalisée, dont les valeurs sont limitées entre 0.0 et 1.0, utilisée pour piloter le décalage et la rotation du masque.
`mask`	MASK	Oui	-	-	: Le masque à décaler ou à pivoter.

Paramètres de contrôle (Parameters)

Nom du paramètre	Type de données	Requis	Valeur par défaut	Plage de valeurs/Options	Description
`x`	INT	Oui	0	-4096 - MAX_RESOLUTION (pas: 1)	: Contrôle l'intensité du décalage de base du masque dans la direction horizontale (axe X). Plage de valeurs de -4096 à MAX_RESOLUTION, avec un pas de 1.
`y`	INT	Oui	0	-4096 - MAX_RESOLUTION (pas: 1)	: Contrôle l'intensité du décalage de base du masque dans la direction verticale (axe Y). Plage de valeurs de -4096 à MAX_RESOLUTION, avec un pas de 1.
`rotate`	BOOLEAN	Oui	False	-	: Interrupteur booléen. Lorsqu'il est défini sur True, active la fonction de rotation du masque basée sur l'amplitude.
`angle_multiplier`	FLOAT	Oui	0.0	-1.0 - 1.0 (pas: 0.001)	: Multiplicateur d'angle de rotation, qui détermine l'angle de rotation conjointement avec l'amplitude. Plage de valeurs de -1.0 à 1.0, avec un pas de 0.001.

Sortie (Output)

Nom du paramètre	Type de données	Description
mask	MASK	: Le nouveau masque après transformation par décalage ou rotation.

Scénarios d'utilisation

Dans des applications concrètes, ce nœud est souvent utilisé en conjonction avec les nœuds de la série AudioScheduler pour créer des visualisations musicales ou des animations réactives à l'audio. Par exemple, dans un flux de travail de génération vidéo, les résultats de l'analyse de l'amplitude d'un morceau de musique peuvent être transmis à ce nœud pour contrôler la position ou la rotation d'un masque de premier plan, synchronisant ainsi le mouvement du masque avec le rythme musical pour générer des effets visuels dynamiques.

Points d'attention

Lors de l'utilisation, il est important de noter que le décalage et la rotation du masque sont calculés sur la base de la valeur instantanée de l'amplitude. Des valeurs de déplacement trop importantes peuvent entraîner des effets d'enroulement indésirables aux bords de l'image. De plus, il convient de s'assurer que les données d'amplitude en entrée sont bien normalisées.

Lien vers le code source du nœud OffsetMaskByNormalizedAmplitude

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