Effect

Effect

Un Effect (ou « Effet ») est un objet indépendant qui génère des variations automatiques de valeurs DMX dans le temps (mouvements, couleurs, intensités) pour les projecteurs ciblés. L'Effect est basé sur une séquence de courbes (stockées dans les EffectRow) et contrôlé par des paramètres globaux de vitesse et de taille.

Paramètres de Contrôle Globaux

Ces paramètres définissent les propriétés d'identification, la priorité, l'activation et les niveaux maîtres de l'Effet, ainsi que ses timings de transition.

Paramètre	Type	Rôle
ID	Int	L'identifiant unique de l'Effet.
Name	String	Nom de l'Effet.
Layer	Int	Layer de calcul de l'Effet. Un ID plus élevé signifie une priorité plus grande.
Solo Pool	Int	Si supérieur à zéro, un seul objet de ce pool peut être actif à la fois.
Is Effect On	Bool	État actif/inactif de l'Effet.
Auto Start And Stop	Bool	Démarre ou arrête automatiquement l'Effet si le paramètre "size value" change.
No Loop	Bool	L'Effet ne boucle pas et s'arrête après un cycle complet.
Speed	Float	Vitesse de lecture de l'effet (en Cycles par Minute, ou BPM).
Size Value	Float	Niveau maître pour l'amplitude/taille de l'effet.
Flash Value	Float	Niveau maître utilisé lors de l'activation de l'effet en Flash ou Swop.
Fade In Time	Float	Durée (en secondes) du fondu lors du démarrage (action Start).
Fade Out Time	Float	Durée (en secondes) du fondu lors de l'arrêt (action Stop).
Beat Per Cycle	Float	Nombre de « beats » par cycle pour la fonction Tap Tempo.

Actions (Triggers)

Ces commandes immédiates modifient l'état de lecture ou le timing de l'Effet.

Action	Description
Start	Déclenche l'Effet avec le temps de fondu défini par Fade In Time.
Stop	Arrête l'Effet avec le temps de fondu défini par Fade Out Time.
Tap Tempo	Permet de régler la vitesse (Speed) en tapant en rythme.

EffectRow

Une EffectRow définit une courbe temporelle et la lie à une Selection de projecteurs. Chaque EffectRow contient un ou plusieurs EffectParam qui définissent quels canaux sont affectés par cette courbe.

Paramètre	Type	Rôle
Selection	CommandSelectionManager	Définit la Selection de projecteurs qui seront affectés par cette courbe.
Speed	Float	Multiplicateur de vitesse, relatif à la Speed globale de l'Effet.
Direction	Enum	Direction de lecture de la courbe (Forward, Backward, Bounce).
Curve Type	Enum	Mode de génération de la courbe : Drawed (dessinée), Preset (pré-enregistrée) ou Chaser (mode poursuite).
Curve	Automation	Courbe dessinée par l'utilisateur (si mode Drawed).
Preset ID	Int	L'ID du preset de courbe (si mode Preset).
Chaser Fade	Float	Temps de fondu entre les pas du Chaser (si mode Chaser).
Chaser Buddying	Int	Regroupement de projecteurs lors de l'exécution en mode Chaser.
Parameters	BaseManager<EffectParam>	Liste des EffectParam qui définissent les canaux spécifiques affectés.

EffectParam

Un EffectParam définit comment la courbe de l'EffectRow module un ChannelType des fixtures séléctionnées. Il gère le mode d'application et la dispersion spatiale de l'effet sur les projecteurs.

Paramètre	Type	Rôle
Channel type	Target	Définit le type de canal affecté.
Effect Mode	Enum	Règle de mélange de l'effet avec la valeur DMX actuelle.
	Relative	Ajoute la valeur de l'effet à la valeur de sortie courante.
	Absolute	Utilise une valeur de base et ajoute l'effet ; les valeurs HTP ne sont modifiées que si l'effet est supérieur.
	Attracted	Calcule la valeur absolue de l'effet au maximum et interpole vers cette valeur en fonction de la taille maître ; les valeurs HTP ne sont modifiées que si l'effet est supérieur.
Base Value	Float	Valeur de référence appliquée aux canaux (caché si Mode Relatif).
Size	Float	Multiplicateur d'amplitude de la courbe pour ce canal spécifique.
First Element position	Float	Position du premier élément, relative à la courbe.
Elements Spread	Float	Taille de la distribution de l'effet sur la sélection.
Buddying	Int	Nombre de projecteurs qui s'allument "ensemble" (parallélisation).
Blocks	Int	Nombre de répétitions (blocs) du motif.
Wings	Int	Répétitions symétriques du motif.
Invert wings selection	Bool	Les sélections sont inversées dans les **Wings**.
Invert wings value	Bool	Les valeurs des **Wings** sont inversées.
Disable wings centered solo value	Bool	Désactive la valeur pour les projecteurs sur l'axe de symétrie des **Wings**.