BlinderKitten Documentation - Contributions [fr]

Cue

2026-01-26T22:22:06Z

Norb :

<languages>
</languages>
<translate>
== Cue ==

Un '''Cue''' (ou « État Lumineux ») est l'unité de base de stockage d'états dans BlinderKitten. Il stocke une liste de [[Command|commandes]] à lancer lors de son exécution, ainsi que des informations de timing et des tâches. Il est contenu et séquencé par une [[Cuelist]].

=== Paramètres de Base du Cue ===

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''ID''' || Float || L'identifiant numérique du Cue (permet un re-numérotage décimal dans la [[Cuelist]]).
|-
| '''Name''' || String || Nom affiché du Cue.
|-
| '''Cue text''' || String || Texte descriptif du Cue (ce qui se passe sur scène).
|-
| '''Go text''' || String || Texte affiché pour l'action GO (l'instruction pour l'opérateur).
|-
| '''Auto Follow''' || Enum || Définit si le Cue démarre automatiquement le Cue suivant après un délai.
|-
| '''Auto Follow Timing''' || Float || Le temps à attendre (en secondes) avant de déclencher le Cue suivant en mode Auto Follow.
|-
| '''Can be randomly called''' || Bool || Permet à ce Cue d'être appelé aléatoirement par la Cuelist parent.
|-
| '''Load Window Break Line''' || Bool || Insère une ligne de séparation dans la fenêtre de load.
|-
| '''Release Current Tracking''' || Bool || Force le relâchement des valeurs traquées lors du déclenchement.
|-
| '''Reuse Cue''' || Target || Permet à ce Cue d'hériter de toutes les commandes et tâches d'un autre Cue sans les stocker localement (réutilisation par référence).
|}

=== Timing (Conteneur `timingContainer`) ===

Ces paramètres définissent la gestion des délais et des fondus (fades) pour les valeurs HTP et LTP du Cue. Ils écrasent les réglages globaux de la [[Cuelist]] si définis localement.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''HTP In Delay''' || Float || Délai avant que les valeurs HTP du Cue commencent à s'appliquer (en GO).
|-
| '''HTP Out Delay''' || Float || Délai avant que les valeurs HTP du Cue commencent à s'éteindre (en OFF).
|-
| '''LTP Delay''' || Float || Délai avant que les valeurs LTP du Cue commencent à s'appliquer.
|-
| '''HTP In Fade''' || Float || Durée du fondu d'entrée pour les valeurs HTP.
|-
| '''HTP Out Fade''' || Float || Durée du fondu de sortie pour les valeurs HTP.
|-
| '''LTP Fade''' || Float || Durée du fondu pour les valeurs LTP.
|-
| '''Fade Curve''' || Automation || Courbe de fondu personnalisée (s'applique aux fades).
|-
| '''Delay Curve''' || Automation || Courbe de fondu personnalisée (s'applique aux délais).
|}

=== Conteneurs Internes (Managers) ===

Le Cue contient plusieurs gestionnaires qui stockent son contenu :

{| class="wikitable" style="margin:auto"
|-
! Conteneur !! Type !! Rôle
|-
| '''Commands''' || BaseManager<Command> || Liste des commandes [[Command]] DMX stockées par ce Cue (valeurs de projecteur).
|-
| '''Tasks''' || BaseManager<Task> || Liste des [[Task]]s à exécuter lorsque le Cue est déclenché (action GO).
|-
| '''Tasks off''' || BaseManager<Task> || Liste des [[Task]]s à exécuter lorsque le Cue est désactivé (action OFF).
|}

=== Actions (Triggers) ===

Ces actions sont des commandes immédiates (boutons) qui agissent sur l'état ou le contenu du Cue.

{| class="wikitable" style="margin:auto"
|-
! Action !! Description
|-
| '''GO''' || Déclenche l'exécution des commandes et des Tasks du Cue.
|-
| '''OFF''' || Désactive le Cue et exécute ses Tasks off.
|-
| '''Load Content''' || Charge le contenu (commandes) de la cue dans le [[Programmer]].
|-
| '''Replace Content''' || Remplace tout le contenu du Cue par celui du [[Programmer]].
|-
| '''Merge Content''' || Ajoute le contenu du [[Programmer]] au contenu du Cue.
|-
| '''Clean Unused''' || Supprime les commandes et tâches qui ne sont plus liées à des projecteurs existants.
|}

</translate>

Cue

2026-01-26T22:21:24Z

Norb :

<languages>
</languages>
== Cue ==

Un '''Cue''' (ou « État Lumineux ») est l'unité de base de stockage d'états dans BlinderKitten. Il stocke une liste de [[Command|commandes]] à lancer lors de son exécution, ainsi que des informations de timing et des tâches. Il est contenu et séquencé par une [[Cuelist]].

=== Paramètres de Base du Cue ===

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''ID''' || Float || L'identifiant numérique du Cue (permet un re-numérotage décimal dans la [[Cuelist]]).
|-
| '''Name''' || String || Nom affiché du Cue.
|-
| '''Cue text''' || String || Texte descriptif du Cue (ce qui se passe sur scène).
|-
| '''Go text''' || String || Texte affiché pour l'action GO (l'instruction pour l'opérateur).
|-
| '''Auto Follow''' || Enum || Définit si le Cue démarre automatiquement le Cue suivant après un délai.
|-
| '''Auto Follow Timing''' || Float || Le temps à attendre (en secondes) avant de déclencher le Cue suivant en mode Auto Follow.
|-
| '''Can be randomly called''' || Bool || Permet à ce Cue d'être appelé aléatoirement par la Cuelist parent.
|-
| '''Load Window Break Line''' || Bool || Insère une ligne de séparation dans la fenêtre de load.
|-
| '''Release Current Tracking''' || Bool || Force le relâchement des valeurs traquées lors du déclenchement.
|-
| '''Reuse Cue''' || Target || Permet à ce Cue d'hériter de toutes les commandes et tâches d'un autre Cue sans les stocker localement (réutilisation par référence).
|}

=== Timing (Conteneur `timingContainer`) ===

Ces paramètres définissent la gestion des délais et des fondus (fades) pour les valeurs HTP et LTP du Cue. Ils écrasent les réglages globaux de la [[Cuelist]] si définis localement.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''HTP In Delay''' || Float || Délai avant que les valeurs HTP du Cue commencent à s'appliquer (en GO).
|-
| '''HTP Out Delay''' || Float || Délai avant que les valeurs HTP du Cue commencent à s'éteindre (en OFF).
|-
| '''LTP Delay''' || Float || Délai avant que les valeurs LTP du Cue commencent à s'appliquer.
|-
| '''HTP In Fade''' || Float || Durée du fondu d'entrée pour les valeurs HTP.
|-
| '''HTP Out Fade''' || Float || Durée du fondu de sortie pour les valeurs HTP.
|-
| '''LTP Fade''' || Float || Durée du fondu pour les valeurs LTP.
|-
| '''Fade Curve''' || Automation || Courbe de fondu personnalisée (s'applique aux fades).
|-
| '''Delay Curve''' || Automation || Courbe de fondu personnalisée (s'applique aux délais).
|}

=== Conteneurs Internes (Managers) ===

Le Cue contient plusieurs gestionnaires qui stockent son contenu :

{| class="wikitable" style="margin:auto"
|-
! Conteneur !! Type !! Rôle
|-
| '''Commands''' || BaseManager<Command> || Liste des commandes [[Command]] DMX stockées par ce Cue (valeurs de projecteur).
|-
| '''Tasks''' || BaseManager<Task> || Liste des [[Task]]s à exécuter lorsque le Cue est déclenché (action GO).
|-
| '''Tasks off''' || BaseManager<Task> || Liste des [[Task]]s à exécuter lorsque le Cue est désactivé (action OFF).
|}

=== Actions (Triggers) ===

Ces actions sont des commandes immédiates (boutons) qui agissent sur l'état ou le contenu du Cue.

{| class="wikitable" style="margin:auto"
|-
! Action !! Description
|-
| '''GO''' || Déclenche l'exécution des commandes et des Tasks du Cue.
|-
| '''OFF''' || Désactive le Cue et exécute ses Tasks off.
|-
| '''Load Content''' || Charge le contenu (commandes) de la cue dans le [[Programmer]].
|-
| '''Replace Content''' || Remplace tout le contenu du Cue par celui du [[Programmer]].
|-
| '''Merge Content''' || Ajoute le contenu du [[Programmer]] au contenu du Cue.
|-
| '''Clean Unused''' || Supprime les commandes et tâches qui ne sont plus liées à des projecteurs existants.
|}

OSC Remote

2025-12-17T00:00:22Z

Norb : Page créée avec « = OSC Remote = La fonctionnalité '''OSC Remote''' permet de contrôler BlinderKitten à distance via le protocole OSC (Open Sound Control). Une fois activée, BlinderKitten écoute des messages OSC entrants et interprète leurs adresses comme des commandes internes (cuelists, effects, faders, etc.). == Activation == Le contrôle OSC distant doit être activé dans les préférences de BlinderKitten. BlinderKitten écoute alors sur un port OSC et accepte les... »

= OSC Remote =

La fonctionnalité '''OSC Remote''' permet de contrôler BlinderKitten à distance via le protocole OSC (Open Sound Control).

Une fois activée, BlinderKitten écoute des messages OSC entrants et interprète leurs adresses comme des commandes internes (cuelists, effects, faders, etc.).

== Activation ==

Le contrôle OSC distant doit être activé dans les préférences de BlinderKitten.

BlinderKitten écoute alors sur un port OSC et accepte les messages entrants.

== Syntaxe générale ==

Un message OSC est composé :
* d’une adresse (path), par exemple '''/cuelist/1/go'''
* d’un ou plusieurs arguments (int ou float)

Les valeurs flottantes sont généralement normalisées entre '''0 et 1'''.

= Cuelists =

Les commandes OSC pour les cuelists utilisent l’identifiant de la cuelist dans l’adresse.

{| class="wikitable" style="margin:auto"
|-
! Adresse OSC !! Argument !! Description
|-
| /cuelist/{id}/go(/cueId) || int || Lance la cuelist ou va à la cue donnée.
|-
| /cuelist/{id}/goback || – || Revient à la cue précédente.
|-
| /cuelist/{id}/gorandom || – || Va à une cue aléatoire.
|-
| /cuelist/{id}/off || – || Arrête la cuelist (soft stop).
|-
| /cuelist/{id}/kill || – || Arrêt immédiat.
|-
| /cuelist/{id}/toggle || – || Bascule l’état On / Off.
|-
| /cuelist/{id}/load(/cueId) || int || Charge une cue sans la lancer.
|-
| /cuelist/{id}/loadandgo(/cueId) || int || Charge et lance la cue.
|-
| /cuelist/{id}/loadrandom || – || Charge une cue aléatoire.
|-
| /cuelist/{id}/flash || int || Flash (1 = press, 0 = release).
|-
| /cuelist/{id}/swop || int || Swop (1 = press, 0 = release).
|-
| /cuelist/{id}/htplevel || float || Niveau HTP (0–1).
|-
| /cuelist/{id}/ltplevel || float || Niveau LTP (0–1).
|-
| /cuelist/{id}/flashlevel || float || Niveau de flash (0–1).
|}

= Effects =

{| class="wikitable" style="margin:auto"
|-
! Adresse OSC !! Argument !! Description
|-
| /effect/{id}/start || – || Démarre l’effet.
|-
| /effect/{id}/stop || – || Arrête l’effet.
|-
| /effect/{id}/taptempo || – || Tap tempo.
|-
| /effect/{id}/size || float || Taille de l’effet (0–1).
|-
| /effect/{id}/speed || float || Vitesse de l’effet.
|}

= Carousels =

{| class="wikitable" style="margin:auto"
|-
! Adresse OSC !! Argument !! Description
|-
| /carousel/{id}/start || – || Démarre le carousel.
|-
| /carousel/{id}/stop || – || Arrête le carousel.
|-
| /carousel/{id}/taptempo || – || Tap tempo.
|-
| /carousel/{id}/size || float || Taille du carousel.
|-
| /carousel/{id}/speed || float || Vitesse du carousel.
|}

= Mappers =

{| class="wikitable" style="margin:auto"
|-
! Adresse OSC !! Argument !! Description
|-
| /mapper/{id}/start || – || Active le mapper.
|-
| /mapper/{id}/stop || – || Désactive le mapper.
|-
| /mapper/{id}/size || float || Taille / influence du mapper.
|}

= Virtual Buttons, Faders et Encoders =

Les contrôles virtuels utilisent leur position dans la grille.

{| class="wikitable" style="margin:auto"
|-
! Adresse OSC !! Argument !! Description
|-
| /virtbutton/{page}/{col}/{row} || float || Bouton virtuel.
|-
| /virtbutton/{col}/{row} || float || Bouton (page courante).
|-
| /virtabove/{page}/{col}/{row} || float || Fader au-dessus.
|-
| /virtabove/{col}/{row} || float || Fader au-dessus (page courante).
|-
| /virtbelow/{page}/{col}/{row} || float || Fader en dessous.
|-
| /virtbelow/{col}/{row} || float || Fader en dessous (page courante).
|-
| /virtrotary/{page}/{col}/{row} || float || Encodeur virtuel.
|-
| /virtrotary/{col}/{row} || float || Encodeur (page courante).
|-
| /virtfader/{page}/{col} || float || Fader vertical.
|-
| /virtfader/{col} || float || Fader vertical (page courante).
|}

= Encoders système =

{| class="wikitable" style="margin:auto"
|-
! Adresse OSC !! Description
|-
| /encoders/hl || Active ou désactive le Highlight.
|-
| /encoders/blind || Active ou désactive le Blind.
|-
| /encoders/mode || Change le mode des encodeurs.
|-
| /encoders/encoderRange || Change la plage de variation.
|-
| /encoders/numbersOrNames || Alterne noms / numéros.
|-
| /encoders/littleMoveLeft || Petit déplacement à gauche.
|-
| /encoders/littleMoveRight || Petit déplacement à droite.
|-
| /encoders/bigMoveLeft || Grand déplacement à gauche.
|-
| /encoders/bigMoveRight || Grand déplacement à droite.
|-
| /encoders/commandUp || Monte la commande.
|-
| /encoders/commandDown || Descend la commande.
|-
| /encoders/explodeCommand || Explose la commande.
|}

= Commandes globales =

{| class="wikitable" style="margin:auto"
|-
! Adresse OSC !! Argument !! Description
|-
| /grandmaster || float || Modifie le Grand Master (0–1).
|-
| /key || string || Réception d’une chaîne libre.
|}

OSCInterface

2025-12-16T23:54:15Z

Norb : Page créée avec « = Interface OSC = Une '''Interface OSC''' permet de connecter BlinderKitten à des applications ou contrôleurs externes via le protocole OSC (Open Sound Control). Elle permet : * de recevoir des messages OSC pour piloter BlinderKitten, * de mapper ces messages vers des actions internes, * d’envoyer des feedbacks OSC (valeurs ou textes), * de communiquer avec des logiciels tiers (TouchOSC, Lemur, Max, Pure Data, etc.). = Paramètres de l’interface OSC = {... »

= Interface OSC =

Une '''Interface OSC''' permet de connecter BlinderKitten à des applications ou contrôleurs externes via le protocole OSC (Open Sound Control).

Elle permet :
* de recevoir des messages OSC pour piloter BlinderKitten,
* de mapper ces messages vers des actions internes,
* d’envoyer des feedbacks OSC (valeurs ou textes),
* de communiquer avec des logiciels tiers (TouchOSC, Lemur, Max, Pure Data, etc.).

= Paramètres de l’interface OSC =

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Internal mappings''' || Bool || Si activé, interprète automatiquement les mappings internes BlinderKitten / OrganicUI.
|-
| '''Internal feedbacks''' || Bool || Envoie automatiquement les feedbacks internes vers les sorties OSC.
|}

= Entrée OSC =

L’interface OSC peut recevoir des messages OSC sur un port local configurable.

== Paramètres d’entrée OSC ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Local Port''' || Int || Port local utilisé pour recevoir les messages OSC.
|-
| '''Enabled''' || Bool || Active ou désactive la réception OSC.
|}

Lorsqu’un message OSC est reçu :
* il peut être traité par des OSC Mappings,
* il peut être interprété comme un mapping interne,
* il peut déclencher des actions dans BlinderKitten.

= Sorties OSC =

L’interface OSC peut envoyer des messages OSC vers un ou plusieurs destinataires.

Chaque sortie OSC définit une destination indépendante.

== Paramètres d’une sortie OSC ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Local''' || Bool || Envoie les messages vers l’ordinateur local (127.0.0.1).
|-
| '''Remote Host''' || String || Adresse IP ou nom d’hôte distant.
|-
| '''Remote port''' || Int || Port OSC du destinataire.
|-
| '''Enabled''' || Bool || Active ou désactive cette sortie.
|}

Les messages OSC sont envoyés de manière asynchrone afin de ne pas bloquer le moteur.

= OSC Mapping =

Un '''OSC Mapping''' permet d’associer une adresse OSC entrante à une ou plusieurs actions internes.

Chaque mapping surveille une adresse précise et convertit la valeur reçue en une valeur normalisée.

== Paramètres d’un OSC Mapping ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Address''' || String || Adresse OSC écoutée (ex : /fader/1).
|-
| '''Input Range''' || Point2D || Plage de valeurs attendues en entrée.
|-
| '''Output Range''' || Point2D || Plage de valeurs envoyées aux actions.
|-
| '''Learn''' || Bool || Active l’apprentissage automatique de l’adresse OSC.
|-
| '''Learn range''' || Bool || Apprend automatiquement la plage de valeurs reçues.
|}

Lorsque l’adresse correspond :
* la valeur OSC est lue,
* elle est remappée,
* les actions associées sont déclenchées.

= OSC Feedback =

Le '''OSC Feedback''' permet d’envoyer automatiquement des messages OSC lorsque l’état interne de BlinderKitten change.

Le feedback peut transmettre :
* une valeur numérique,
* ou un texte.

== Paramètres d’un OSC Feedback ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Data type''' || Enum || Type de donnée envoyée : Value ou Text.
|-
| '''Source type''' || Enum || Élément observé (Virtual fader, bouton, encoder, Grand Master, Blackout, etc.).
|-
| '''Source ID''' || Int || Identifiant de la source.
|-
| '''Source Page''' || Int || Page concernée (0 = page courante).
|-
| '''Only if current page''' || Bool || Envoie le feedback uniquement si la page est active.
|-
| '''Address''' || String || Adresse OSC de sortie.
|-
| '''OSC Output Range''' || Point2D || Plage de valeurs envoyées (mode Value).
|-
| '''On Value''' || Int || Valeur envoyée lorsque la source est active.
|-
| '''Off Value''' || Int || Valeur envoyée lorsque la source est inactive.
|-
| '''On Loaded Value''' || Int || Valeur envoyée lorsque la cuelist est active et chargée.
|-
| '''Off Loaded Value''' || Int || Valeur envoyée lorsque la cuelist est inactive mais chargée.
|-
| '''Current Cue Value''' || Int || Valeur envoyée lorsque la cue courante correspond.
|-
| '''Loaded Cue Value''' || Int || Valeur envoyée lorsque la cue chargée correspond.
|}

= Feedback interne OSC =

Lorsque '''Internal feedbacks''' est activé, BlinderKitten envoie automatiquement des messages OSC reflétant son état interne.

Exemples :
* valeurs de faders virtuels,
* état des boutons,
* Grand Master,
* Blackout,
* Blind / Highlight.

Ces messages utilisent les adresses internes standard de BlinderKitten.

= Zeroconf (découverte réseau) =

L’interface OSC publie automatiquement un service Zeroconf lorsque la réception est activée.

Cela permet aux applications compatibles de détecter BlinderKitten automatiquement sur le réseau.

MIDIInterface

2025-12-16T23:52:08Z

Norb : Page créée avec « = Interface MIDI = Une '''Interface MIDI''' permet de connecter BlinderKitten à un contrôleur MIDI externe (clavier, surface de contrôle, contrôleur à pads, console MIDI, etc.). Elle gère : * l’entrée MIDI (notes, CC, pitch wheel), * le mapping des messages MIDI vers des actions internes, * le feedback MIDI vers le contrôleur (LEDs, écrans, motorisation), * l’envoi optionnel de messages SysEx au démarrage. = Paramètres de l’interface MIDI =... »

= Interface MIDI =

Une '''Interface MIDI''' permet de connecter BlinderKitten à un contrôleur MIDI externe
(clavier, surface de contrôle, contrôleur à pads, console MIDI, etc.).

Elle gère :
* l’entrée MIDI (notes, CC, pitch wheel),
* le mapping des messages MIDI vers des actions internes,
* le feedback MIDI vers le contrôleur (LEDs, écrans, motorisation),
* l’envoi optionnel de messages SysEx au démarrage.

= Paramètres de l’interface MIDI =

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Device''' || Device || Périphérique MIDI utilisé pour l’entrée et la sortie.
|-
| '''Infos''' || String || Notes libres concernant le contrôleur.
|-
| '''Auto add''' || Bool || Crée automatiquement un mapping lors de la réception d’un message MIDI non mappé.
|-
| '''Start sysex''' || Int || Nombre d’octets envoyés au démarrage (message SysEx).
|}

= SysEx de démarrage =

L’interface MIDI peut envoyer un message SysEx automatiquement à l’ouverture de la sortie MIDI.
Les octets sont définis individuellement et encadrés automatiquement par F0 / F7.

= MIDI Mapping =

Un '''MIDI Mapping''' associe un message MIDI entrant à une ou plusieurs actions internes
(Go, Stop, fader, bouton, valeur, etc.).

Chaque mapping écoute un type de message précis et transforme la valeur reçue en une valeur normalisée (0 → 1).

== Paramètres de MIDI Mapping ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Mode''' || Enum || Mode de fonctionnement : Linear ou Encoder.
|-
| '''Type''' || Enum || Type de message MIDI surveillé : Note, Control Change ou Pitch Wheel.
|-
| '''Channel''' || Int || Canal MIDI écouté (0 = tous).
|-
| '''Pitch Or Number''' || Int || Pitch (Note) ou numéro (CC).
|-
| '''Input Range''' || Point2D || Plage de valeurs MIDI utilisée (7 bits).
|-
| '''Input Range 14b''' || Point2D || Plage de valeurs MIDI utilisée (14 bits).
|-
| '''Up range''' || Point2D || Zone considérée comme incrément positif (mode Encoder).
|-
| '''Down range''' || Point2D || Zone considérée comme incrément négatif (mode Encoder).
|-
| '''Value range''' || Point2D || Variation appliquée à chaque incrément (mode Encoder).
|-
| '''Learn''' || Bool || Active l’apprentissage automatique du message MIDI.
|-
| '''Learn range''' || Bool || Apprend automatiquement la plage d’entrée.
|}

= Mode Linear =

En mode '''Linear''', la valeur MIDI est directement remappée vers une valeur normalisée (0 → 1).
Ce mode est adapté aux faders, potards ou contrôles absolus.

= Mode Encoder =

En mode '''Encoder''', le message MIDI est interprété comme un incrément ou décrément.
Les zones '''Up range''' et '''Down range''' définissent le sens du mouvement.

Ce mode est particulièrement adapté aux encodeurs rotatifs sans butée.

= Actions associées =

Chaque mapping possède une liste d’actions cibles
(faders virtuels, boutons, paramètres, etc.).

Lorsqu’un message MIDI valide est reçu :
* la valeur est convertie,
* les actions associées sont déclenchées,
* la valeur peut être relative ou absolue selon le mode.

= MIDI Feedback =

Le '''MIDI Feedback''' permet d’envoyer des informations de BlinderKitten vers le contrôleur MIDI :
* allumer des LEDs,
* afficher du texte,
* positionner des faders motorisés.

Le feedback est déclenché automatiquement lorsque la valeur source change.

== Paramètres de MIDI Feedback ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Source type''' || Enum || Élément observé (Virtual fader, button, encoder, Grand Master, Blackout, etc.).
|-
| '''Source ID''' || Int || Identifiant de la source.
|-
| '''Source Page''' || Int || Page concernée (0 = page courante).
|-
| '''Only if current page''' || Bool || N’envoie le feedback que si la page est active.
|-
| '''Midi Type''' || Enum || Type de message envoyé : Note, Control Change, Pitch Wheel ou Text.
|-
| '''Midi Channel''' || Int || Canal MIDI utilisé pour l’envoi.
|-
| '''Midi Pitch Or Number''' || Int || Pitch ou numéro CC utilisé.
|-
| '''Midi Output Range''' || Point2D || Plage de sortie MIDI (7 bits).
|-
| '''Midi Output Range 14b''' || Point2D || Plage de sortie MIDI (14 bits).
|-
| '''Different Channels''' || Bool || Utilise des canaux différents selon l’état.
|-
| '''On Value''' || Int || Valeur envoyée lorsque la source est active.
|-
| '''Off Value''' || Int || Valeur envoyée lorsque la source est inactive.
|-
| '''Text mode''' || Enum || Mode texte pour contrôleurs MCU / X-Touch.
|-
| '''MCU column''' || Int || Colonne utilisée pour l’affichage texte.
|}

= Feedback texte (MCU / X-Touch) =

Le feedback texte permet d’afficher des libellés sur les écrans de contrôleurs compatibles
(Mackie Control, X-Touch, extensions).

Les textes sont automatiquement découpés et envoyés via SysEx.

DMXInterface

2025-12-16T23:45:22Z

Norb : Page créée avec « = Interface DMX = Une '''Interface DMX''' permet à BlinderKitten d’envoyer et de recevoir des données DMX vers des équipements externes (consoles, nodes Art-Net / sACN, interfaces USB, etc.). Elle constitue le point de sortie final du moteur lumière et peut également servir de point d’entrée pour piloter BlinderKitten depuis un univers DMX externe. = Paramètres de l’interface DMX = {| class="wikitable" style="margin:auto" |- ! Paramètre !! Typ... »

= Interface DMX =

Une '''Interface DMX''' permet à BlinderKitten d’envoyer et de recevoir des données DMX vers des équipements externes
(consoles, nodes Art-Net / sACN, interfaces USB, etc.).

Elle constitue le point de sortie final du moteur lumière et peut également servir de point d’entrée pour piloter BlinderKitten depuis un univers DMX externe.

= Paramètres de l’interface DMX =

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''DMX Type''' || Enum || Type d’interface DMX utilisée (USB, Art-Net, sACN, etc.).
|-
| '''Connected''' || Bool || Indique si l’interface est actuellement connectée (information uniquement).
|-
| '''Enabled''' || Bool || Active ou désactive l’interface DMX.
|-
| '''Input to programmer''' || Trigger || Crée automatiquement des commandes dans le Programmer à partir des valeurs DMX reçues.
|}

= Fonctionnement général =

L’interface DMX reçoit en permanence les valeurs calculées par le moteur BlinderKitten
et les transmet au périphérique DMX sélectionné.

Chaque interface gère un univers DMX de 512 canaux.

L’interface peut également :
* recevoir des valeurs DMX entrantes,
* les mapper vers des actions internes,
* ou les convertir en commandes dans le Programmer.

= Pass-through DMX =

Une interface DMX peut rediriger ses données vers une ou plusieurs autres interfaces DMX.

Ce mécanisme permet de dupliquer un univers DMX.

Le pass-through s’effectue canal par canal et conserve les valeurs telles quelles.

= Entrée DMX =

Lorsqu’une interface reçoit des données DMX en entrée :
* chaque canal peut être analysé individuellement,
* les changements sont détectés en temps réel,
* ces valeurs peuvent déclencher des actions internes via des mappings.

= Input to Programmer =

L’action '''Input to programmer''' permet de transformer un univers DMX entrant en commandes BlinderKitten.

Fonctionnement :
* chaque canal modifié est analysé,
* les fixtures et subfixtures correspondantes sont identifiés,
* des commandes sont automatiquement créées dans le Programmer,
* les valeurs Pan/Tilt, couleurs ou intensités sont correctement reconstruites (y compris en 16 bits).

Cette fonction est particulièrement utile pour :
* capturer une scène depuis une console externe,
* importer un état DMX réel,
* ou reproduire un show existant.

= DMX Mapping =

Les '''DMX Mappings''' permettent d’associer un canal DMX entrant à des actions internes dans BlinderKitten
(Play, Stop, Trigger, fader, etc.).

== Paramètres d’un DMX Mapping ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Channel Number''' || Int || Numéro du canal DMX surveillé (1–512).
|-
| '''Enabled''' || Bool || Active ou désactive ce mapping.
|}

Lorsqu’un canal correspondant change de valeur, celle-ci est transmise aux actions associées.

Interface

2025-12-16T23:40:39Z

Norb :

Les interfaces sont les entrées et sorties physiques et/ou numériques de Blinderkitten.

Il existe actuellement 3 types d'interfaces :

* [[DMXInterface|Interface DMX]], pour contrôler des machines externes via des nodes DMX. Lorsqu'une interface DMX est sélectionnée dans le [[DMX Tester]], elle apparait en surbrillance rose/violette.

* [[MIDIInterface|Interface MIDI]], pour permettre à des contrôleurs MIDI de piloter Blinderkitten ainsi que de leur envoyer un feedback.

* [[OSCInterface|Interface OSC]], pour permettre à des contrôleurs OSC de piloter Blinderkitten ainsi que de leur envoyer un feedback. La liste des contrôles OSC intégrés à Blinderkitten est disponible ici : [[OSC Remote]].

Mappers

2025-12-15T23:27:03Z

Norb : Norb a déplacé la page Mappers vers Mapper

#REDIRECTION [[Mapper]]

Mapper

2025-12-15T23:27:03Z

Norb : Norb a déplacé la page Mappers vers Mapper

= Mapper =

Un '''Mapper''' applique des valeurs à des SubFixtures en fonction d’un canal suivi et d’une série de steps.

Il agit comme un [[Carousel]], mais la valeur de la subfixture ne dépend plus de sa position dans le carousel mais de la valeur du canal suivi.

Cela permet de faire varier la couleur en fonction de l'intensité, ou le focus en fonction du zoom par exemple.

== Paramètres ==

{| class="wikitable" style="margin:auto"
|-
! Nom !! Type !! Description
|-
| '''ID''' || Int || Identifiant du Mapper.
|-
| '''Name''' || String || Nom utilisateur du Mapper.
|-
| '''Layer''' || Int || Priorité du Mapper. Une valeur plus élevée prend le dessus sur les layers plus bas.
|-
| '''is ON''' || Bool || Indique si le Mapper est actuellement actif.
|-
| '''Start''' || Trigger || Active immédiatement le Mapper.
|-
| '''Stop''' || Trigger || Désactive le Mapper.
|-
| '''Auto Start / Stop''' || Bool || Active automatiquement le Mapper selon la valeur de Size.
|-
| '''Size''' || Float || Facteur global d’influence du Mapper (0–1).
|}

= MapperRow =

Un '''MapperRow''' définit :
* un '''Followed Channel''' (canal suivi),
* une [[Selection]] de SubFixtures,
* une '''liste de MapperStep''' servant à produire les valeurs finales.

== Paramètres MapperRow ==

{| class="wikitable" style="margin:auto"
|-
! Nom !! Type !! Description
|-
| '''Followed Channel''' || Target(ChannelType) || Canal dont la valeur sert de position dans la séquence des steps.
|}

= MapperStep =

Un '''MapperStep''' représente une étape de la carte de transformation.
Chaque step définit des valeurs ou des presets à appliquer selon la position issue du MapperRow.

== Paramètres MapperStep ==

{| class="wikitable" style="margin:auto"
|-
! Nom !! Type !! Description
|-
| '''Step value''' || Float || Position relative du step (définit la "durée" du step comparée aux autres).
|}

Layer

2025-12-15T23:25:29Z

Norb : Page créée avec « = Layers = Les '''Layers''' définissent l’ordre de priorité des différentes sources de valeurs dans BlinderKitten. Ils déterminent **quelle valeur gagne** lorsqu’un même canal est modifié par plusieurs objets en même temps. Un Layer n’est pas un objet en soi, mais un '''paramètre commun''' présent dans de nombreux éléments du logiciel. = Principe général = Chaque source de valeur (Command, Effect, Carousel, Mapper, Tracker, Selection Mast... »

= Layers =

Les '''Layers''' définissent l’ordre de priorité des différentes sources de valeurs dans BlinderKitten.
Ils déterminent **quelle valeur gagne** lorsqu’un même canal est modifié par plusieurs objets en même temps.

Un Layer n’est pas un objet en soi, mais un '''paramètre commun''' présent dans de nombreux éléments du logiciel.

= Principe général =

Chaque source de valeur (Command, Effect, Carousel, Mapper, Tracker, Selection Master, etc.) possède un '''Layer''' exprimé par un nombre entier.

Plus le numéro de layer est élevé, plus la priorité est forte.

Lors du calcul final, les valeurs sont évaluées couche par couche, du layer le plus bas à celui le plus haut,
Chaque layer calcule ses éléments dans cet ordre :
* [[Cuelist|Cuelists]]
* [[Programmer|Programmers]]
* [[Tracker|Trackers]]
* [[Mapper|Mappers]]
* [[Carousel|Carousels]]
* [[Effect|Effects]]
* [[SelectionMaster|Selection Masters]]

SelectionMaster

2025-12-15T23:18:19Z

Norb : Page créée avec « = Selection Master = Un '''Selection Master''' est un maître appliqué uniquement à une '''Selection''' donnée. Il agit comme un modulateur global sur un type de canal précis (Dimmer, Color, Pan, etc.), en s’appliquant **après les commandes, effets, mappers, trackers**, mais avant la sortie finale. Contrairement à un Grand Master global, le Selection Master permet de contrôler une partie précise du parc. == Paramètres du Selection Master == {|... »

= Selection Master =

Un '''Selection Master''' est un maître appliqué uniquement à une '''Selection''' donnée.
Il agit comme un modulateur global sur un type de canal précis (Dimmer, Color, Pan, etc.),
en s’appliquant **après les commandes, effets, mappers, trackers**, mais avant la sortie finale.

Contrairement à un Grand Master global, le Selection Master permet de contrôler une partie précise du parc.

== Paramètres du Selection Master ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''ID''' || Int || Identifiant unique du Selection Master.
|-
| '''Name''' || String || Nom utilisateur du Selection Master.
|-
| '''Layer''' || Int || Priorité du Selection Master (plus élevé = appliqué plus tard).
|-
| '''Followed Channel''' || Target(ChannelType) || Type de canal affecté par ce master.
|-
| '''Master mode''' || Enum || Mode d’action du master : Scale, Inhibit ou Offset.
|-
| '''is ON''' || Bool || Indique si le Selection Master est actif.
|-
| '''Start''' || Trigger || Active le Selection Master.
|-
| '''Stop''' || Trigger || Désactive le Selection Master.
|-
| '''Auto Start / Stop''' || Bool || Démarre ou arrête automatiquement le master lorsque la valeur de Size change.
|-
| '''Size''' || Float || Valeur du master (interprétation dépend du mode).
|}

= Sélection =

Chaque Selection Master possède sa propre '''Selection'''.
Seuls les subfixtures appartenant à cette sélection **et possédant le Channel Type suivi** sont affectés.

Toute modification de la sélection ou du type de canal entraîne un recalcul automatique.

= Modes de fonctionnement =

Le comportement du Selection Master dépend du paramètre '''Master mode'''.

== Scale ==

Le master agit comme un multiplicateur.

Exemples :
* Size = 1 → aucune modification
* Size = 0.5 → valeur divisée par deux
* Size = 0 → sortie forcée à zéro

== Inhibit ==

Le master agit comme une limite maximale.

Exemples :
* Size = 1 → aucune limite
* Size = 0.7 → la valeur ne dépassera jamais 70 %
* Size = 0 → blackout de la sélection

== Offset ==

Le master ajoute une valeur à la sortie.

Exemples :
* Size = 0 → aucune modification
* Size = +0.2 → boost de la valeur
* Size = -0.3 → atténuation

Tracker

2025-12-15T23:16:42Z

Norb : Page créée avec « = Tracker = Un '''Tracker''' est un objet spécial qui permet de piloter automatiquement les canaux '''Pan''' et '''Tilt''' des fixtures afin qu’elles pointent vers une position cible dans l’espace. Le Tracker calcule en temps réel les valeurs Pan/Tilt nécessaires pour que chaque fixture sélectionnée vise une position 3D donnée, en tenant compte : * de la position et rotation des fixtures, * des plages physiques Pan/Tilt, * des inversions éventuelles,... »

= Tracker =

Un '''Tracker''' est un objet spécial qui permet de piloter automatiquement les canaux '''Pan''' et '''Tilt''' des fixtures afin qu’elles pointent vers une position cible dans l’espace.

Le Tracker calcule en temps réel les valeurs Pan/Tilt nécessaires pour que chaque fixture sélectionnée vise une position 3D donnée, en tenant compte :
* de la position et rotation des fixtures,
* des plages physiques Pan/Tilt,
* des inversions éventuelles,
* et des corrections de patch.

Le Tracker agit comme un modulateur continu, appliqué par-dessus les autres sources de valeurs.

== Paramètres du Tracker ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''ID''' || Int || Identifiant unique du Tracker.
|-
| '''Name''' || String || Nom du Tracker.
|-
| '''Layer''' || Int || Priorité du Tracker (plus élevé = priorité plus forte).
|-
| '''is ON''' || Bool || Indique si le Tracker est actuellement actif.
|-
| '''Start''' || Trigger || Active le Tracker.
|-
| '''Stop''' || Trigger || Désactive le Tracker.
|-
| '''Auto Start / Stop''' || Bool || Démarre ou arrête automatiquement le Tracker lorsque la valeur de '''Size''' change.
|-
| '''Size''' || Float || Intensité globale du Tracker (0 = aucun effet, 1 = effet complet).
|-
| '''Target position''' || Point3D || Position 3D cible vers laquelle les fixtures doivent pointer.
|}

= Sélection =

Le Tracker utilise une '''Selection''' pour déterminer quelles fixtures ou subfixtures sont concernées.
Seules les fixtures disposant de canaux Pan et Tilt sont prises en compte.

La sélection est recalculée automatiquement lors de chaque mise à jour.

Path

2025-12-15T23:15:34Z

Norb : Page créée avec « = Paths = Un '''Path''' (ou BKPath) définit une disposition géométrique utilisée dans un '''Layout''' pour positionner des fixtures ou des subfixtures. Les paths servent à la fois à la visualisation dans le layout et comme base de calcul pour les filtres spatiaux (Direction, Circle, Wake, Perlin…). Un path associe chaque fixture ou subfixture sélectionnée à une position 2D calculée selon un type de path. == Paramètres généraux == {| class="wi... »

= Paths =

Un '''Path''' (ou BKPath) définit une disposition géométrique utilisée dans un '''Layout''' pour positionner des fixtures ou des subfixtures.
Les paths servent à la fois à la visualisation dans le layout et comme base de calcul pour les filtres spatiaux (Direction, Circle, Wake, Perlin…).

Un path associe chaque fixture ou subfixture sélectionnée à une position 2D calculée selon un type de path.

== Paramètres généraux ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Type''' || Enum || Type de path utilisé (Point, Line, Rod, Grid, Circle, Preset).
|-
| '''Position''' || Point2D || Position d’origine du path dans le layout.
|-
| '''Spread Subfixtures''' || Bool || Si activé, les subfixtures sont réparties individuellement sur le path, sinon la position est calculée par fixture.
|}

= Apparence des tiles =

Ces paramètres contrôlent l’affichage visuel des fixtures dans le layout pour ce path.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Tiles size''' || Point2D || Taille graphique des tiles.
|-
| '''Text size''' || Float || Taille du texte affiché.
|-
| '''Custom Text''' || String || Texte personnalisé affiché sur la tile.
|-
| '''Label position''' || Enum || Position du label (center, top, bottom, left, right, hidden).
|-
| '''Override stroke color''' || Bool || Active une couleur de contour personnalisée.
|-
| '''Stroke color''' || Color || Couleur du contour.
|-
| '''Override fill color''' || Bool || Active une couleur de remplissage personnalisée.
|-
| '''Fill color''' || Color || Couleur de remplissage.
|}

= Path Type : Point =

Le path '''Point''' place toutes les fixtures ou subfixtures exactement au même endroit.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Position''' || Point2D || Position unique utilisée pour tous les éléments.
|}

= Path Type : Line =

Le path '''Line''' distribue les éléments le long d’un segment entre deux points.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Position''' || Point2D || Point de départ de la ligne.
|-
| '''End position''' || Point2D || Point de fin de la ligne.
|}

= Path Type : Rod =

Le path '''Rod''' est une ligne centrée sur la position d’origine, définie par une longueur et un angle.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Rod size''' || Float || Longueur totale du rod.
|-
| '''Rod angle''' || Float || Angle du rod en degrés.
|}

= Path Type : Grid =

Le path '''Grid''' place les éléments sur une grille 2D configurable.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Size''' || Point2D || Taille totale de la grille.
|-
| '''Grid Angle''' || Float || Angle de rotation de la grille.
|-
| '''Number per line''' || Int || Nombre d’éléments par ligne.
|-
| '''Orientation''' || Enum || Orientation principale de la grille.
|-
| '''Zig zag''' || Bool || Inverse la direction à chaque ligne.
|-
| '''Reverse lines''' || Bool || Inverse l’ordre des lignes.
|}

= Path Type : Circle =

Le path '''Circle''' répartit les éléments sur un arc ou un cercle.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Radius''' || Float || Rayon du cercle.
|-
| '''From angle''' || Float || Angle du premier élément.
|-
| '''To angle''' || Float || Angle du dernier élément.
|}

= Path Type : Preset =

Le path '''Preset''' utilise un '''Path Preset''' existant comme source de positions.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Preset ID''' || Int || Identifiant du path preset utilisé.
|-
| '''Preset scale''' || Float || Facteur d’échelle appliqué au preset.
|-
| '''Preset angle''' || Float || Rotation appliquée au preset.
|}

= Utilisation des Paths =

Les paths sont utilisés :

* pour positionner les fixtures dans un layout,
* comme base géométrique pour les filtres de sélection spatiaux,
* pour calculer des ratios normalisés (0 → 1) selon la position,
* pour déclencher des sélections par clic dans le layout.

Lorsqu’un path est modifié, toutes les positions associées sont automatiquement recalculées.

Layout

2025-12-15T23:11:59Z

Norb : Page créée avec « = Layout = Un '''Layout''' représente une vue 2D (ou un plan) permettant de positionner graphiquement les fixtures et subfixtures. Il est utilisé à la fois pour la visualisation (Layout Viewer) et comme base de calcul pour certains filtres de sélection (Layout Direction, Wake, Circle, Perlin…). Un layout contient des chemins (paths) qui associent des positions à des fixtures ou subfixtures. == Paramètres... »

= Layout =

Un '''Layout''' représente une vue 2D (ou un plan) permettant de positionner graphiquement les [[Fixture|fixtures]] et subfixtures.
Il est utilisé à la fois pour la visualisation (Layout Viewer) et comme base de calcul pour certains filtres de [[Selection|sélection]] (Layout Direction, Wake, Circle, Perlin…).

Un layout contient des chemins ([[Path|paths]]) qui associent des positions à des [[Fixture|fixtures]] ou subfixtures.

== Paramètres du Layout ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''ID''' || Int || Identifiant unique du layout.
|-
| '''Name''' || String || Nom du layout.
|-
| '''From To X''' || Point2D || Limites horizontales du layout.
|-
| '''From To Y''' || Point2D || Limites verticales du layout.
|-
| '''Tiles scale''' || Point2D || Échelle d’affichage des fixtures.
|-
| '''Text scale''' || Float || Taille des textes affichés (ID, noms).
|-
| '''View output''' || Bool || Si activé, la couleur des fixtures reflète leur sortie réelle.
|}

= Affichage et grille =

Ces paramètres contrôlent l’affichage du fond et de la grille du layout.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Background image''' || File || Image de fond du layout.
|-
| '''Background transparency''' || Float || Transparence de l’image de fond.
|-
| '''View grid''' || Bool || Affiche une grille sur le layout.
|-
| '''Grid size''' || Point2D || Taille des cellules de la grille.
|-
| '''Grid color''' || Color || Couleur de la grille.
|-
| '''Grid snap size''' || Float || Pas d’aimantation à la grille.
|}

= Tracker =

Un layout peut être lié à un [[Tracker|tracker]] pour représenter une scène en 3D projetée sur un plan 2D.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''controlTracker''' || Bool || Active le contrôle par un tracker.
|-
| '''trackerId''' || Int || Identifiant du tracker utilisé.
|-
| '''trackerPlane''' || Enum || Plan de projection utilisé (XY, XZ ou YZ).
|-
| '''trackerThirdValue''' || Float || Valeur fixe sur l’axe non projeté.
|}

= Notes =

* Les paths définissent la position réelle des fixtures dans le layout.
* Un layout peut être utilisé uniquement pour la sélection, sans affichage visuel.
* Les layouts sont recalculés automatiquement dès qu’un path ou un paramètre change.

Values

2025-12-15T22:40:12Z

Norb : Page créée avec « = Values = Un élément '''Value''' définit une ou plusieurs valeurs à appliquer à un type de canal. Ces valeurs peuvent être des valeurs brutes, des presets, ou un ordre de « release ». Elles peuvent aussi s’interpoler via un '''thru''', être symétriques, ou aléatoires. == Paramètres des Values == {| class="wikitable" style="margin:auto" |- ! Paramètre !! Type !! Description |- | '''Value type''' || Enum || Sélectionne le mode : Raw Values,... »

= Values =

Un élément '''Value''' définit une ou plusieurs valeurs à appliquer à un type de canal.
Ces valeurs peuvent être des valeurs brutes, des presets, ou un ordre de « release ».
Elles peuvent aussi s’interpoler via un '''thru''', être symétriques, ou aléatoires.

== Paramètres des Values ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Value type''' || Enum || Sélectionne le mode : Raw Values, Preset ou Release.
|-
| '''Channel type''' || Target || Définit le type de canal affecté (Dimmer, Color, Pan, etc.).
|-
| '''Value''' || Float || Valeur du premier élément (mode Raw).
|-
| '''ID From''' || Int || ID du preset de départ (mode Preset).
|-
| '''Thru''' || Bool || Active une interpolation ou un « range » de valeur/preset.
|-
| '''Value To''' || Float || Valeur du dernier élément (mode Raw + Thru).
|-
| '''ID To''' || Int || Preset final (mode Preset + Thru).
|-
| '''Symmetry''' || Bool || Applique l'interpolation en miroir.
|-
| '''Randomize''' || Bool || Permet de randomiser les valeurs par subfixture.
|-
| '''HTP Override''' || Bool || Force le canal à se comporter en LTP (utile pour certains dimmers).
|}

Command

2025-12-15T22:39:50Z

Norb :

Cuelist

2025-12-15T22:38:54Z

Norb :

== Cuelist ==

Une '''Cuelist''' (ou « Liste de [[Cue|Cues]] ») est l'élément central du système de lecture et de séquencement dans BlinderKitten. Elle est responsable de la gestion d'une série de [[Cue]]s (états lumineux) et de leurs transitions. Chaque cuelist peut être transformée en '''Chaser'''.

=== Paramètres de Base de la cuelist ===

Ces paramètres définissent les propriétés d'identification, de priorité, et les niveaux maîtres de la liste de Cues.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''ID''' || Int || L'identifiant unique de la cuelist.
|-
| '''Name''' || String || Nom de la cuelist.
|-
| '''Layer ID''' || Int || [[Layer]] de calcul de la cuelist. Un ID plus élevé signifie une priorité plus grande.
|-
| '''Solo Pool''' || Int || Si supérieur à zéro, numéro du [[solo pool]] utilisé : un seul objet avec ce numéro de pool peut être actif à la fois.
|-
| '''Tracking''' || Enum || Définit la persistance des valeurs (traquées) des [[Cue]]s précédents dans la séquence.
|-
| '''Loop''' || Enum || Comportement de la cuelist à la fin des Cues (Off ou Loop).
|-
| '''Off If Overwritten''' || Bool || La Cuelist s'éteint automatiquement si tous ses paramètres sont écrasés par d'autres Cuelists.
|-
| '''Auto Start / Auto Stop''' || Bool || Démarre ou arrête automatiquement la Cuelist si un des niveaux passe de ou vers zéro.
|-
| '''MIB Delay''' || Float || Délai à attendre pour le '''Move In Black''' (MIB) après l'extinction des projecteurs.
|-
| '''HTP Level''' || Float || Maître de niveau pour les canaux '''HTP''' (Highest Takes Priority). Agit comme un fader principal.
|-
| '''LTP Level''' || Float || Maître de niveau pour les canaux '''LTP''' (Latest Takes Priority).
|-
| '''Flash Level''' || Float || Niveau maître utilisé lors de l'activation d'un '''Flash''' ou d'un '''Swop'''.
|-
| '''Flash with LTP level''' || Bool || Si coché, le niveau LTP est appliqué lors de l'action Flash.
|-
| '''Absolute LTP value''' || Bool || Si coché, le niveau LTP agit comme un multiplicateur. Sinon, il agit comme un crossfade.
|-
| '''Off Fade''' || Float || Temps de fondu par défaut lors de l'extinction de la cuelist.
|-
| '''Off Fade Curve''' || Automation || Courbe d'atténuation utilisée pour l'extinction.
|}

=== Options Chaser (`chaserOptions`) ===

Ce conteneur gère tous les paramètres nécessaires à l'exécution de la séquence en mode Poursuite (Chaser).

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''Is Chaser''' || Bool || Active ou désactive le mode chaser.
|-
| '''Direction''' || Enum || Direction du chaser (Normal, Reverse, Bounce, Random).
|-
| '''Speed''' || Float || Vitesse du chaser (en GO / minute).
|-
| '''In fade / Out fade''' || Float || Durées de fondu (en nombre de pas, non pas en secondes) pour les étapes entrantes et sortantes du Chaser.
|-
| '''Run X times''' || Float || Nombre de cycles du Chaser (0 pour infini).
|-
| '''In curve / Out curve''' || Automation || Courbes d'atténuation personnalisées pour les fondus (In/Out) du Chaser.
|}

=== Génération Automatique de Chaser (`chaserGenContainer`) ===

Ce conteneur fournit des outils pour créer rapidement un Chaser à partir d'un groupe.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''Group ID''' || Int || L'ID du [[Group]] à utiliser comme base pour la génération automatique du Chaser.
|-
| '''Buddying''' || Int || Nombre de projecteurs qui s'allument "ensemble" (parallélisation) lors de la génération.
|-
| '''Blocks''' || Int || Nombre de répétitions du Chaser.
|-
| '''Wings''' || Int || Répétitions symétriques (effet d'aile) lors de la génération.
|-
| '''Fixtures only''' || Bool || N'utilise que les projecteurs principaux (sans les sous-fixtures) pour la création du Chaser.
|}

=== Actions (Triggers) ===

Ces actions sont des commandes immédiates (boutons) qui modifient l'état de lecture de la cuelist ou sa structure interne.

{| class="wikitable" style="margin:auto"
|-
! Action !! Description
|-
| '''GO''' || Déclenche le [[Cue]] suivant (ou le premier si la cuelist est inactive).
|-
| '''GO back''' || Déclenche le [[Cue]] précédent dans la séquence.
|-
| '''OFF''' || Éteint la cuelist avec le temps de fondu défini par '''Off Fade'''.
|-
| '''KILL''' || Tue la cuelist immédiatement (Off avec un fondu de 0).
|-
| '''Toggle''' || Allume et éteint la cuelist alternativement.
|-
| '''Tap Tempo''' || Permet de régler la vitesse du Chaser en tapant manuellement l'action.
|-
| '''Set main conductor''' || Définit cette cuelist comme conduite principale du projet, c'est cette cuelist qui est affichée dans le [[Conductor infos]] et dans la [[Cuelist sheet]].
|-
| '''Load Content''' || Charge les commandes de la cue active dans le programmeur.
|-
| '''Clean all cues''' || Supprime toutes les commandes inutilisées dans tous les Cues de la liste.
|-
| '''Renumber cues''' || Réinitialise les ID de tous les Cues de la liste.
|-
| '''Insert cue before/after''' || Insère un nouveau [[Cue]] avant ou après le Cue sélectionné.
|-
| '''Regenerate Chaser''' || Déclenche la génération du Chaser en utilisant les paramètres du conteneur '''chaserGenContainer'''.
|}

Cue

2025-12-11T00:24:58Z

Norb :

== Cue ==

Un '''Cue''' (ou « État Lumineux ») est l'unité de base de stockage d'états dans BlinderKitten. Il stocke une liste de [[Command|commandes]] à lancer lors de son exécution, ainsi que des informations de timing et des tâches. Il est contenu et séquencé par une [[Cuelist]].

=== Paramètres de Base du Cue ===

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''ID''' || Float || L'identifiant numérique du Cue (permet un re-numérotage décimal dans la [[Cuelist]]).
|-
| '''Name''' || String || Nom affiché du Cue.
|-
| '''Cue text''' || String || Texte descriptif du Cue (ce qui se passe sur scène).
|-
| '''Go text''' || String || Texte affiché pour l'action GO (l'instruction pour l'opérateur).
|-
| '''Auto Follow''' || Enum || Définit si le Cue démarre automatiquement le Cue suivant après un délai.
|-
| '''Auto Follow Timing''' || Float || Le temps à attendre (en secondes) avant de déclencher le Cue suivant en mode Auto Follow.
|-
| '''Can be randomly called''' || Bool || Permet à ce Cue d'être appelé aléatoirement par la Cuelist parent.
|-
| '''Load Window Break Line''' || Bool || Insère une ligne de séparation dans la fenêtre de load.
|-
| '''Release Current Tracking''' || Bool || Force le relâchement des valeurs traquées lors du déclenchement.
|-
| '''Reuse Cue''' || Target || Permet à ce Cue d'hériter de toutes les commandes et tâches d'un autre Cue sans les stocker localement (réutilisation par référence).
|}

=== Timing (Conteneur `timingContainer`) ===

Ces paramètres définissent la gestion des délais et des fondus (fades) pour les valeurs HTP et LTP du Cue. Ils écrasent les réglages globaux de la [[Cuelist]] si définis localement.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''HTP In Delay''' || Float || Délai avant que les valeurs HTP du Cue commencent à s'appliquer (en GO).
|-
| '''HTP Out Delay''' || Float || Délai avant que les valeurs HTP du Cue commencent à s'éteindre (en OFF).
|-
| '''LTP Delay''' || Float || Délai avant que les valeurs LTP du Cue commencent à s'appliquer.
|-
| '''HTP In Fade''' || Float || Durée du fondu d'entrée pour les valeurs HTP.
|-
| '''HTP Out Fade''' || Float || Durée du fondu de sortie pour les valeurs HTP.
|-
| '''LTP Fade''' || Float || Durée du fondu pour les valeurs LTP.
|-
| '''Fade Curve''' || Automation || Courbe de fondu personnalisée (s'applique aux fades).
|-
| '''Delay Curve''' || Automation || Courbe de fondu personnalisée (s'applique aux délais).
|}

=== Conteneurs Internes (Managers) ===

Le Cue contient plusieurs gestionnaires qui stockent son contenu :

{| class="wikitable" style="margin:auto"
|-
! Conteneur !! Type !! Rôle
|-
| '''Commands''' || BaseManager<Command> || Liste des commandes [[Command]] DMX stockées par ce Cue (valeurs de projecteur).
|-
| '''Tasks''' || BaseManager<Task> || Liste des [[Task]]s à exécuter lorsque le Cue est déclenché (action GO).
|-
| '''Tasks off''' || BaseManager<Task> || Liste des [[Task]]s à exécuter lorsque le Cue est désactivé (action OFF).
|}

=== Actions (Triggers) ===

Ces actions sont des commandes immédiates (boutons) qui agissent sur l'état ou le contenu du Cue.

{| class="wikitable" style="margin:auto"
|-
! Action !! Description
|-
| '''GO''' || Déclenche l'exécution des commandes et des Tasks du Cue.
|-
| '''OFF''' || Désactive le Cue et exécute ses Tasks off.
|-
| '''Load Content''' || Charge le contenu (commandes) de la cue dans le [[Programmer]].
|-
| '''Replace Content''' || Remplace tout le contenu du Cue par celui du [[Programmer]].
|-
| '''Merge Content''' || Ajoute le contenu du [[Programmer]] au contenu du Cue.
|-
| '''Clean Unused''' || Supprime les commandes et tâches qui ne sont plus liées à des projecteurs existants.
|}

Timing

2025-12-11T00:24:23Z

Norb :

= Command Timing =

Une '''Command Timing''' définit le comportement temporel de la commande :
delays, fades, interpolations, symétries, randomisation.
Elle peut utiliser ses propres valeurs ou puiser dans un preset de timing.

== Paramètres de Command Timing ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Timing type''' || Enum || Source du timing :
'''Cue timing''' (héritage),
'''Raw timing''' (manuel),
'''Preset''' (via ID).
|-
| '''ID''' || Int || ID du timing preset (si Timing type = Preset).
|-
| '''Delay''' || Float || Delay du premier élément (en secondes).
|-
| '''Thru delay''' || Bool || Active une interpolation de delay.
|-
| '''Delay To''' || Float || Delay final (si ThruDelay est activé).
|-
| '''Delay Symmetry''' || Bool || Applique les delays de manière symétrique.
|-
| '''Delay random''' || Bool || Randomise les delays.
|-
| '''Fade''' || Float || Fade du premier élément.
|-
| '''Thru fade''' || Bool || Active une interpolation de fade.
|-
| '''Fade To''' || Float || Fade final.
|-
| '''Fade Symmetry''' || Bool || Applique les fades en symétrie.
|-
| '''Fade random''' || Bool || Randomise les fades.
|}

== Explications supplémentaires ==

=== Delay ===
Le délai retarde le début de la transition du subfixture.
Exemples :
* Delay = 0 → transition immédiate.
* Delay = 1 → démarre 1 seconde après le déclenchement
* Delay = 0 thru 5 → décalage régulier entre 0 (première subfixture) et 5s (dernière subfixture)

=== Fade ===
Le fade correspond à la durée du fondu de valeur.

=== Symmetry ===
Applique les delays/fades en miroir autour du centre de la sélection.

=== Random ===
Remplace l’interpolation par un tirage aléatoire pour chaque subfixture.

=== Timing type ===
Détermine comment le timing est obtenu :
* '''Cue timing''' → hérité de la cuelist
* '''Raw timing''' → défini dans cette commande
* '''Preset''' → reprend un timing prédéfini dans la bibliothèque

Value

2025-12-11T00:24:08Z

Norb :

= Command Value =

Une '''Command Value''' décrit ce qu’une commande applique réellement :
une valeur brute, un preset, ou un ordre de release.
Chaque Value s’applique à un type de canal, avec éventuellement une interpolation (thru), une symétrie ou une randomisation.

Les valeurs sont évaluées pour chaque subfixture de la sélection associée à la commande.

== Paramètres de Command Value ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Value type''' || Enum || Type de valeur appliquée :
'''Raw''' (valeur numérique),
'''Preset''' (ID de preset),
'''Release''' (libère le canal).
|-
| '''Channel type''' || Target(ChannelType) || Canal ciblé par la Value (Dimmer, Pan, Red, etc.).
|-
| '''Value''' || Float || Valeur appliquée pour le premier subfixture (mode Raw).
|-
| '''ID From''' || Int || ID du preset de départ (mode Preset).
|-
| '''Thru''' || Bool || Active une interpolation de valeurs ou de presets.
|-
| '''Value To''' || Float || Valeur finale (mode Raw + Thru).
|-
| '''ID To''' || Int || Preset final (mode Preset + Thru).
|-
| '''Symmetry''' || Bool || Applique l'interpolation en miroir.
|-
| '''Randomize''' || Bool || Randomise la Value pour chaque subfixture.
|-
| '''HTP Override''' || Bool || Force le canal à se comporter en LTP lorsqu’il est normalement HTP.
|}

== Explications supplémentaires ==

=== Raw Values ===
Les valeurs numériques sont exprimées en 0–1.

=== Thru ===
Permet de définir une interpolation entre deux valeurs ou deux presets.
Exemples :
* 0 → 1 sur 8 subfixtures crée un gradient.
* Preset 2 → Preset 5 permet un fondu entre deux presets.

=== Symmetry ===
Inverse l’ordre des valeurs dans la seconde moitié de la sélection.

=== Randomize ===
Chaque subfixture reçoit une valeur différente, dans la plage définie par Value/Value To ou ID From/ID To.

Value

2025-12-11T00:23:55Z

Norb :

Timing

2025-12-11T00:23:37Z

Norb :

Value

2025-12-11T00:20:01Z

Norb : Page créée avec « = Command Value = Une '''Command Value''' décrit ce qu’une commande applique réellement : une valeur brute, un preset, ou un ordre de release. Chaque Value s’applique à un type de canal, avec éventuellement une interpolation (thru), une symétrie ou une randomisation. Les valeurs sont évaluées pour chaque subfixture de la sélection associée à la commande. == Paramètres de Command Value == {| class="wikitable" style="margin:auto" |- ! Paramè... »

Timing

2025-12-11T00:18:12Z

Norb : Page créée avec « = Command Timing = Une '''Command Timing''' définit le comportement temporel de la commande : delays, fades, interpolations, symétries, randomisation. Elle peut utiliser ses propres valeurs ou puiser dans un preset de timing. == Paramètres de Command Timing == {| class="wikitable" style="margin:auto" |- ! Paramètre !! Type !! Description |- | '''Timing type''' || Enum || Source du timing : '''Cue timing''' (héritage), '''Raw timing''' (manuel),... »

= Command Timing =

Une '''Command Timing''' définit le comportement temporel de la commande :
delays, fades, interpolations, symétries, randomisation.
Elle peut utiliser ses propres valeurs ou puiser dans un preset de timing.

== Paramètres de Command Timing ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Timing type''' || Enum || Source du timing :
'''Cue timing''' (héritage),
'''Raw timing''' (manuel),
'''Preset''' (via ID).
|-
| '''ID''' || Int || ID du timing preset (si Timing type = Preset).
|-
| '''Delay''' || Float || Delay du premier élément (en secondes).
|-
| '''Thru delay''' || Bool || Active une interpolation de delay.
|-
| '''Delay To''' || Float || Delay final (si ThruDelay est activé).
|-
| '''Delay Symmetry''' || Bool || Applique les delays de manière symétrique.
|-
| '''Delay random''' || Bool || Randomise les delays.
|-
| '''Fade''' || Float || Fade du premier élément.
|-
| '''Thru fade''' || Bool || Active une interpolation de fade.
|-
| '''Fade To''' || Float || Fade final.
|-
| '''Fade Symmetry''' || Bool || Applique les fades en symétrie.
|-
| '''Fade random''' || Bool || Randomise les fades.
|}

== Explications supplémentaires ==

=== Delay ===
Le délai retarde le début de la transition du subfixture.
Exemples :
* Delay = 0 → transition immédiate.
* Delay = 1 → chaque subfixture démarre 1 seconde après le précédent, s’il y a interpolation.

=== Fade ===
Le fade correspond à la durée du changement de valeur.

=== Thru ===
Assez similaire aux Values :
active une interpolation linéaire entre le premier et le dernier élément.

=== Symmetry ===
Applique les delays/fades en miroir autour du centre de la sélection.

=== Random ===
Remplace l’interpolation par un tirage aléatoire pour chaque subfixture.

=== Timing type ===
Détermine comment le timing est obtenu :
* '''Cue timing''' → hérité de la cuelist
* '''Raw timing''' → défini dans cette commande
* '''Preset''' → reprend un timing prédéfini dans la bibliothèque

= Notes =

* Command Value + Command Timing + Selection = l’ensemble complet d’une commande.
* Les interpolations sont toujours ordonnées selon la sélection, **pas** selon le patch DMX.
* Les Random sont déterministes si utilisés dans une cuelist (répétables).

Command

2025-12-11T00:16:48Z

Norb : Page créée avec « = Command = Une '''Command''' (ou « commande ») est l’élément fondamental qui définit une action lumière : Selection de fixtures, valeurs à appliquer, timings, et comportements spéciaux comme le Move In Black. Une commande contient trois sous-éléments principaux : * une Selection (les cibles) * des Values (les valeurs appliquées aux canaux) * un Timing (le comportement temporel) Cette page décrit uniquement les paramètres de la C... »

= Command =

Une '''Command''' (ou « commande ») est l’élément fondamental qui définit une action lumière : [[Selection]] de fixtures, valeurs à appliquer, timings, et comportements spéciaux comme le Move In Black.

Une commande contient trois sous-éléments principaux :
* une [[Selection]] (les cibles)
* des [[Values]] (les valeurs appliquées aux canaux)
* un [[Timing]] (le comportement temporel)

Cette page décrit uniquement les paramètres de la Command elle-même.
Les pages '''Selection''', '''Command Value''' et '''Command Timing''' disposent de sections dédiées.

== Paramètres de la Command ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Do not track''' || Bool || Empêche la commande d’être suivie par le tracking.
|-
| '''MIB Delay''' || Float || Délai en secondes appliqué avant un move-in-black manuel.
|-
| '''Use values as path''' || Bool || Si activé, les valeurs successives sont enchaînées pour former un chemin plutôt qu’une interpolation directe.
|-
| '''Explode Selection''' || Trigger || Transforme la commande en plusieurs commandes : une par subfixture sélectionné.
|}

= Values =

Un élément '''Value''' définit une ou plusieurs valeurs à appliquer à un type de canal.
Ces valeurs peuvent être des valeurs brutes, des presets, ou un ordre de « release ».
Elles peuvent aussi s’interpoler via un '''thru''', être symétriques, ou aléatoires.

== Paramètres des Values ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Value type''' || Enum || Sélectionne le mode : Raw Values, Preset ou Release.
|-
| '''Channel type''' || Target || Définit le type de canal affecté (Dimmer, Color, Pan, etc.).
|-
| '''Value''' || Float || Valeur du premier élément (mode Raw).
|-
| '''ID From''' || Int || ID du preset de départ (mode Preset).
|-
| '''Thru''' || Bool || Active une interpolation ou un « range » de valeur/preset.
|-
| '''Value To''' || Float || Valeur du dernier élément (mode Raw + Thru).
|-
| '''ID To''' || Int || Preset final (mode Preset + Thru).
|-
| '''Symmetry''' || Bool || Applique l'interpolation en miroir.
|-
| '''Randomize''' || Bool || Permet de randomiser les valeurs par subfixture.
|-
| '''HTP Override''' || Bool || Force le canal à se comporter en LTP (utile pour certains dimmers).
|}

= Timing =

Chaque commande possède un sous-module de timing, permettant d’appliquer :
* des délais individuels,
* des fades individuels,
* des interpolations,
* des courbes d’enchaînement,
* ou l’utilisation d’un preset de timing global.

== Paramètres du Timing ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Timing type''' || Enum || Source du timing : Cue timing, Raw timing, ou Preset.
|-
| '''ID''' || Int || ID du timing preset (si Timing type = Preset).
|-
| '''Delay''' || Float || Delay du premier élément (en secondes).
|-
| '''Thru delay''' || Bool || Active une variation de delay entre les éléments.
|-
| '''Delay To''' || Float || Delay du dernier élément.
|-
| '''Delay Symmetry''' || Bool || Applique le delay en symétrie.
|-
| '''Delay random''' || Bool || Randomise les delays.
|-
| '''Fade''' || Float || Fade du premier élément.
|-
| '''Thru fade''' || Bool || Active une variation de fade.
|-
| '''Fade To''' || Float || Fade du dernier élément.
|-
| '''Fade Symmetry''' || Bool || Applique le fade en symétrie.
|-
| '''Fade random''' || Bool || Randomise les fades.
|}

== Courbes de Timing ==

Certaines courbes sont disponibles en interne pour modeler la répartition du fade et du delay.
Elles ne sont pas affichées ici car elles ne sont pas des paramètres standards (courbes internes non listées dans l'UI principale).

= Explications complémentaires =

== Explode Selection ==
Cette action génère une nouvelle commande par subfixture de la sélection courante.
Très utile pour travailler fixture par fixture à partir d'une commande globale.

== Use values as path ==
Au lieu d’appliquer instantanément une valeur finale, chaque step devient une étape du chemin.
Permet des effets de « trajectoire » (pan/tilt, color sweep, etc.).

Selection

2025-12-11T00:07:20Z

Norb : Page créée avec « = Selection = Une '''Selection''' détermine quels Fixtures ou SubFixtures sont ciblés par une commande (Effects, Carousels, Mappers, Cuelists, etc.). == Paramètres de Selection == {| class="wikitable" style="margin:auto" |- ! Paramètre !! Type !! Description |- | '''Action''' || Enum || Ajoute (+) ou retire (-) des éléments de la sélection. |- | '''Target type''' || Enum || Cible la sélection sur des Fixtures ou des Groups. |- | '''ID''' || Int || Iden... »

= Selection =

Une '''Selection''' détermine quels Fixtures ou SubFixtures sont ciblés par une commande (Effects, Carousels, Mappers, Cuelists, etc.).

== Paramètres de Selection ==

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Action''' || Enum || Ajoute (+) ou retire (-) des éléments de la sélection.
|-
| '''Target type''' || Enum || Cible la sélection sur des Fixtures ou des Groups.
|-
| '''ID''' || Int || Identifiant de départ (fixture ou group).
|-
| '''Thru''' || Bool || Active la sélection d’une plage d’ID.
|-
| '''Last ID''' || Int || Identifiant final de la plage (si '''Thru''' est activé).
|-
| '''SubFixtures''' || Bool || Active la sélection uniquement sur certains subfixtures.
|-
| '''SubFixtures From''' || Int || ID du premier subfixture.
|-
| '''SubFixtures Thru''' || Bool || Active la sélection d’une plage de subfixtures.
|-
| '''SubFixtures To''' || Int || ID du dernier subfixture.
|}

= Filtres =

Les filtres transforment la sélection de base : inversion, motifs, aléatoire, conditions, ou tri spatial via les Layouts.

== Filtres Pattern / Divide ==

Les filtres pattern et divide permettent de ne garde qu'un sous ensemble de la selection via un pattern composé de 1 et de 0.

Le filtre '''Divide''' applique le filtre sur l'ensemble de la selection et ne garde que la partie 1. Par exemple le pattern "10" sur 8 subfixtures ne garde que les 4 premières.
Le filtre '''Pattern''' applique le filtre sur les subfixture les unes après les autres. Par exemple, le pattern "10" sur 8 fixture selectionne une fixture sur deux ( n°1 n°3 n°5 n°7 )

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Pattern''' || String || Motif utilisé pour filtrer la sélection (ex : 101).
|-
| '''Symmetry''' || Bool || Applique le motif en symétrie.
|}

== Filtres Shuffle / Pick Random / Begin / End ==

Le filtre '''Shuffle''' permet de changer l'ordre des sous fixtures.

Le filtre '''pick random''' permet de ne selectionner que certaines sous fixtures au hasard.

Les filtres shuffle et pick random utilisent un nombre entier "seed" pour la génération. Si ce nombre est égal à 0, un tirage différent sera fait a chaque appel de la sélection. Sinon, le tirage aura le même résultat aà chaque tirage.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Seed''' || Int || Graine aléatoire (0 = sélection différente à chaque appel).
|-
| '''Number of subfixtures''' || Int || Nombre d’éléments conservés.
|-
| '''Buddying''' || Int || Taille des groupes d’éléments qui restent ensemble.
|-
| '''Block''' || Int || Nombre de répétitions du motif.
|-
| '''Wings''' || Int || Nombre de symétries du motif.
|}

== Filtre Output Condition ==

Le filtre '''output condition''' permet de séléctionner des subfixtures en fonction d'un test logique sur leur valeur de sortie.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Channel type''' || Target(ChannelType) || Canal évalué pour la condition.
|-
| '''Test''' || Enum || Type de comparaison (égal, différent, <, >, ≤, ≥).
|-
| '''Value''' || Float || Valeur de référence utilisée pour le test.
|}

== Filtres Layout (Direction, Wake, Circle, Droplet, Perlin) ==

Les filtres layout permettent de selectionner les machines en fonction de leur position dans un layout 2D. Le type de filtre définit le type de balayage du layout.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Layout ID''' || Int || Identifiant du Layout utilisé pour le tri.
|-
| '''Direction angle''' || Float || Angle de direction pour le tri (Layout Direction / Wake).
|-
| '''Circle Origin''' || Point2D || Centre utilisé pour les tris circulaires ou radiaux.
|-
| '''Start angle''' || Float || Angle de départ pour le balayage circulaire.
|-
| '''Complete revolution''' || Bool || Indique si le balayage couvre tout le cercle.
|-
| '''Counter Clockwise''' || Bool || Sens du balayage (anti-horaire si coché).
|-
| '''Perlin Seed''' || Int || Graine utilisée pour le mode Layout Perlin.
|-
| '''Perlin scale''' || Float || Échelle de la carte Perlin.
|-
| '''Wake anchor''' || Point2D || Point de départ de l’onde (Layout Wake).
|-
| '''Wake angle''' || Float || Ouverture de l’onde (Layout Wake).
|}

Mapper

2025-12-10T23:51:22Z

Norb : Page créée avec « = Mapper = Un '''Mapper''' applique des valeurs à des SubFixtures en fonction d’un canal suivi et d’une série de steps. Il agit comme un Carousel, mais la valeur de la subfixture ne dépend plus de sa position dans le carousel mais de la valeur du canal suivi. Cela permet de faire varier la couleur en fonction de l'intensité, ou le focus en fonction du zoom par exemple. == Paramètres == {| class="wikitable" style="margin:auto" |- ! Nom !! Type !!... »

FixtureType

2025-12-10T23:43:21Z

Norb : Page créée avec « = Fixture Type = Une '''Fixture Type''' définit la structure d’une fixture : ses canaux physiques, ses canaux virtuels et son apparence dans le layout. Elle contient des Channels qui doivent correspondre à la charte DMX du matériel utilisé Le container Virtual channel permet de créer des canaux virtuels. == Paramètres FixtureType == {| class="wikitable" style="margin:auto" |- ! Nom !! Type !! Description |- | '''Layout stroke color''' || Color || Coule... »

= Fixture Type =

Une '''Fixture Type''' définit la structure d’une fixture : ses canaux physiques, ses canaux virtuels et son apparence dans le layout.
Elle contient des Channels qui doivent correspondre à la charte DMX du matériel utilisé
Le container Virtual channel permet de créer des canaux virtuels.

== Paramètres FixtureType ==

{| class="wikitable" style="margin:auto"
|-
! Nom !! Type !! Description
|-
| '''Layout stroke color''' || Color || Couleur de contour par défaut dans le layout.
|-
| '''Layout fill color''' || Color || Couleur de remplissage par défaut dans le layout.
|-
| '''Layout icon''' || File || Icône PNG affichée dans le layout.
|}

Les icones des projecteurs peuvent être personnalisés. Pour fire vor propres icones, vous dever dessiner en rouge ce qui sera coloré avec la couleur '''Layout stroke color''' et en vert ce qui sera colorié avec le '''layout fill color'''.

La couleur '''Layout fill color''' est automatiquement ajustée si la fixture contient des paramètres rouge, vert, bleu, blanc, ambre, UV.

== Paramètres FixtureTypeChannel ==

Un '''FixtureTypeChannel''' décrit un canal DMX physique du type (Intensity, Red, Pan, etc.).

{| class="wikitable" style="margin:auto"
|-
! Nom !! Type !! Description
|-
| '''Channel type''' || Target(ChannelType) || Type de données de ce canal DMX.
|-
| '''Resolution''' || Enum || Résolution du canal : '''8bits''', '''16bits''' ou '''Fine channel only'''. Un canal en 16bits prends automatiquement deux canaux DMX à la suite.
|-
| '''SubFixture ID''' || Int || ID du subfixture auquel appartient ce canal.
|-
| '''Default value''' || Float || Valeur par défaut du canal (0–1).
|-
| '''Highlight value''' || Float || Valeur utilisée en highlight (0–1, peut être désactivée).
|-
| '''Killed By SWOP''' || Bool || Si coché, ce canal revient à sa valeur par défaut lorsqu’une cuelist SWOP sans commande pour lui est appelée.
|-
| '''Fade or snap''' || Enum || Mode de transition : '''Fade''' (fondu) ou '''Snap''' (changement immédiat).
|-
| '''Invert output''' || Bool || Inverse la valeur de sortie DMX.
|-
| '''DMX Channel''' || Int || Position du canal dans la charte DMX (delta par rapport à l’adresse de patch).
|-
| '''Virtual Master''' || Target(FixtureTypeVirtualChannel) || Master virtuel appliqué à ce canal.
|-
| '''Physical range''' || Point2D || Plage physique (actuellement utilisé seulement pour les pan / tilt dans les [[trackers]]).
|}

== Paramètres FixtureTypeVirtualChannel ==

Un '''FixtureTypeVirtualChannel''' représente un canal logique (virtuel) utilisé comme master ou valeur abstraite.

{| class="wikitable" style="margin:auto"
|-
! Nom !! Type !! Description
|-
| '''Channel type''' || Target(ChannelType) || Type de données de ce canal virtuel.
|-
| '''SubFixture ID''' || Int || ID du subfixture associé.
|-
| '''Default value''' || Float || Valeur par défaut (0–1).
|-
| '''Highlight value''' || Float || Valeur utilisée en highlight (0–1).
|-
| '''Killed By SWOP''' || Bool || Si coché, ce canal virtuel revient à sa valeur par défaut lorsqu’une cuelist SWOP sans commande pour lui est appelée.
|-
| '''Fade or snap''' || Enum || Mode de transition : '''Fade''' ou '''Snap'''.
|}

= Fixture Type Preset =

Les presets de Fixture Type permettent de définir des valeurs réutilisables pour les subfixtures d’un type (par exemple des positions ou couleurs de base).

== Paramètres FixtureTypePreset ==

{| class="wikitable" style="margin:auto"
|-
! Nom !! Type !! Description
|-
| '''Import from grid''' || Trigger || Importe les valeurs du preset depuis la grille globale de presets.
|-
| '''Export to grid''' || Trigger || Exporte les valeurs du preset dans la grille (en créant le preset s’il n’existe pas).
|-
| '''Import data from grid''' || Trigger || Importe les données de presets liées à ce Fixture Type depuis la grille (par nom de preset).
|-
| '''Export in existing grid''' || Trigger || Exporte les presets de ce Fixture Type vers la grille sans créer de nouveaux presets.
|-
| '''Create missing in grid''' || Trigger || Exporte tous les presets et crée automatiquement ceux manquants dans la grille.
|}

= Helper =

La partie '''Helper''' regroupe les outils d’aide à la duplication de subfixtures pour un Fixture Type.

== Paramètres Helper ==

{| class="wikitable" style="margin:auto"
|-
! Nom !! Type !! Description
|-
| '''Template ID''' || Int || ID du subfixture utilisé comme modèle (template).
|-
| '''Copy until ID''' || Int || ID maximal jusqu’auquel le modèle est dupliqué.
|-
| '''Copy template''' || Trigger || Duplique les canaux (physiques et virtuels) du subfixture modèle vers tous les subfixtures entre '''Template ID''' et '''Copy until ID'''.
|}

Accueil

2025-12-10T23:16:15Z

Norb :

<languages>
</languages>
<translate>
= BlinderKitten – Documentation officielle = 


Bienvenue sur la documentation du logiciel '''BlinderKitten''', une régie lumière moderne, open-source et pensée pour les techniciens du spectacle vivant.


__TOC__


== Présentation ==
BlinderKitten est un logiciel de contrôle lumière gratuit, open source et sans restriction.

== Glossaire ==

*[[Assistant]]
*[[Carousel]]
*[[ChannelType|Channel/Parameter]]
*[[Cue]]
*[[Cuelist]]
*[[Effect]]
*[[Fixture]]
*[[FixtureType|Fixture Type]]
*[[Groups]]
*[[Interface]]
*[[Mappers]]
*[[Patch]]
*[[Programmer]]
*[[SubFixture]]


== Contribuer ==
Cette documentation est collaborative.
Vous pouvez proposer des corrections, ajouter des pages ou compléter les exemples existants.


Voir : [[Contribuer à la documentation]]


== Communauté ==
* Discord : https://discord.gg/tzxp9f3Dsc
* GitHub : https://github.com/NorbertRostaing/BlinderKitten
* Site officiel : https://blinderkitten.lighting


Bonne lecture et bienvenue dans la communauté BlinderKitten !

</translate>

Carousel

2025-12-10T23:13:14Z

Norb : Page créée avec « == Carousel == Un '''Carousel''' est un objet qui mélange le fonctionnement d'une Cuelist et d'un Effect. Comme une cuelist, il contient une suite d'étapes (steps) avec des valeurs précises ; comme un effet, les fixtures sont réparties (spread) le long de ces steps et la lecture boucle en continu. Les options globales d'un Carousel sont les mêmes que celles d'un Effect : priorité, solo pool, vitesses, tailles et temps de fade. === Paramètres... »

== Carousel ==

Un '''Carousel''' est un objet qui mélange le fonctionnement d'une [[Cuelist]] et d'un [[Effect]]. Comme une cuelist, il contient une suite d'étapes (steps) avec des valeurs précises ; comme un effet, les fixtures sont réparties (spread) le long de ces steps et la lecture boucle en continu.

Les options globales d'un Carousel sont les mêmes que celles d'un [[Effect]] : priorité, solo pool, vitesses, tailles et temps de fade.

=== Paramètres de Contrôle Globaux ===

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''ID''' || Int || L'identifiant unique du Carousel.
|-
| '''Name''' || String || Nom du Carousel.
|-
| '''Layer''' || Int || [[Layer]] de calcul du Carousel. 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 Carousel On''' || Bool || État actif/inactif du Carousel.
|-
| '''Auto Start And Stop''' || Bool || Démarre ou arrête automatiquement le Carousel si le paramètre '''Size Value''' change.
|-
| '''No Loop''' || Bool || Le Carousel ne boucle pas et s'arrête après un cycle complet.
|-
| '''Speed''' || Float || Vitesse de lecture (en Cycles par Minute, ou BPM).
|-
| '''Size Value''' || Float || Niveau maître pour l’amplitude/taille globale du Carousel.
|-
| '''Flash Value''' || Float || Niveau maître utilisé lors de l’activation 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) ===

{| class="wikitable" style="margin:auto"
|-
! Action !! Description
|-
| '''Start''' || Déclenche le Carousel avec le temps de fondu défini par '''Fade In Time'''.
|-
| '''Stop''' || Arrête le Carousel avec le temps de fondu défini par '''Fade Out Time'''.
|-
| '''Tap Tempo''' || Permet de régler la vitesse ('''Speed''') en tapant en rythme.
|}

=== CarouselRow ===

Une '''CarouselRow''' définit une ligne de Carousel : elle contient une [[Selection]] de projecteurs et les paramètres de répartition (spread) qui déterminent comment ces projecteurs se distribuent sur les steps du Carousel.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''Selection''' || [[Selection]]|| Définit la [[Selection]] de fixtures qui seront affectées par cette ligne de Carousel.
|-
| '''Speed''' || Float || Multiplicateur de vitesse, relatif à la '''Speed''' globale du Carousel.
|-
| '''Direction''' || Enum || Sens de lecture de la ligne (par exemple : Forward, Backward, Bounce).
|-
| '''First Element position''' || Float || Position du premier fixture dans la répartition le long des steps.
|-
| '''Elements Spread''' || Float || Longueur de la distribution des fixtures sur les steps.
|-
| '''Buddying''' || Int || Nombre de fixtures qui avancent "ensemble" dans le Carousel (groupées sur les mêmes steps).
|-
| '''Blocks''' || Int || Nombre de répétitions (blocs) du motif sur l’ensemble de la sélection.
|-
| '''Wings''' || Int || Nombre de répétitions symétriques (wings) appliquées à la sélection.
|-
| '''Invert wings selection''' || Bool || Inverse l’ordre des fixtures dans les '''Wings'''.
|-
| '''Invert wings value''' || Bool || Inverse les valeurs des '''Wings''' (effet miroir sur les niveaux).
|-
| '''Disable wings centered solo value''' || Bool || Désactive la valeur pour les fixtures situées sur l’axe de symétrie des '''Wings'''.
|}

=== CarouselStep ===

Un '''CarouselStep''' représente une étape de la ligne : il définit sa durée relative, son mode de transition (cut/fade) et les valeurs cibles (canaux ou presets) qui seront appliquées quand le step est actif.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''Step Duration''' || Float || Durée relative du step par rapport aux autres (par exemple 2 pour un step deux fois plus long que des steps à 1).
|-
| '''Fade Value''' || Float || Mode de transition vers ce step : 0 = changement instantané (cut), 1 = fade complet, valeurs intermédiaires pour des fades partiels.
|}

Fixture

2025-12-09T22:19:09Z

Norb : Page créée avec « = Fixture = Une '''Fixture''' représente un projecteur réel. Elle expose uniquement les paramètres visibles définis dans son constructeur. {| class="wikitable" style="margin:auto" |- ! Paramètre !! Type !! Description |- | '''ID''' || Int || Identifiant de la fixture. |- | '''Name''' || String || Nom utilisateur de la fixture. |- | '''Use another''' || Int || ID d’une autre fixture à utiliser en substitution. |- | '''Fixture type''' || Target(FixtureT... »

= Fixture =

Une '''Fixture''' représente un projecteur réel.
Elle expose uniquement les paramètres visibles définis dans son constructeur.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''ID''' || Int || Identifiant de la fixture.
|-
| '''Name''' || String || Nom utilisateur de la fixture.
|-
| '''Use another''' || Int || ID d’une autre fixture à utiliser en substitution.
|-
| '''Fixture type''' || Target(FixtureType) || Sélection du type de projecteur.
|-
| '''Infos''' || String (multiligne) || Notes utilisateur.
|-
| '''Custom stroke Color''' || Bool || Active une couleur de contour personnalisée dans le layout.
|-
| '''Stroke Color''' || Color || Couleur de contour personnalisée.
|-
| '''Custom fill Color''' || Bool || Active une couleur de remplissage personnalisée dans le layout.
|-
| '''Fill Color''' || Color || Couleur de remplissage personnalisée.
|-
| '''Position''' || Point3D || Position en mètres.
|-
| '''Rotation''' || Point3D || Rotation en degrés.
|}

= FixturePatch =

Une '''FixturePatch''' définit l'adresse DMX et l'interface DMX de sortie.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Interface''' || Target(DMXInterface) || Interface DMX utilisée pour la sortie.
|-
| '''Address''' || Int || Adresse DMX de la fixture (0 = non patchée).
|}

= FixturePatchCorrection =

Une correction de patch permet de modifier un canal de sortie d'un sous fixture de la fixture selectionnée.
Les corrections permettent d'inverser la sortie, d'ajouter un offset ou de changer la courbe de sortie.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''SubFixture''' || Int || ID du subfixture ciblé.
|-
| '''Channel type''' || Target(ChannelType) || Canal concerné par la correction.
|-
| '''Invert Channel''' || Bool || Inverse la valeur DMX produite.
|-
| '''Offset''' || Float || Décalage ajouté à la valeur finale.
|}

= FixtureMapping =

Un '''FixtureMapping''' permet d’envoyer la valeur d’un canal vers une interface OSC ou MIDI.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Description
|-
| '''Subfixture Id''' || Int || Subfixture surveillé.
|-
| '''Channel type''' || Target(ChannelType) || Canal surveillé.
|-
| '''Interface''' || Target(Interface OSC ou MIDI) || Interface de sortie.
|-
| '''Midi Type''' || Enum || Type de message MIDI (Note / Control Change / Pitchwheel).
|-
| '''Midi Channel''' || Int || Canal MIDI utilisé.
|-
| '''Midi Pitch Or Number''' || Int || Note ou numéro CC émis.
|-
| '''Midi Output Range''' || Point2D || Plage de sortie MIDI (7 bits).
|-
| '''Midi Output Range 14b''' || Point2D || Plage de sortie MIDI (14 bits).
|-
| '''Address''' || String || Adresse OSC envoyée.
|-
| '''OSC Output Range''' || Point2D || Plage de sortie OSC.
|}

Effect

2025-12-09T21:29:09Z

Norb : Page créée avec « == 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, l... »

== 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.

{| class="wikitable" style="margin:auto"
|-
! 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.

{| class="wikitable" style="margin:auto"
|-
! 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.

{| class="wikitable" style="margin:auto"
|-
! 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 [[Fixture|fixtures]] séléctionnées. Il gère le mode d'application et la dispersion spatiale de l'effet sur les projecteurs.

{| class="wikitable" style="margin:auto"
|-
! 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**.
|}

Cuelists

2025-12-09T21:04:34Z

Norb : Norb a déplacé la page Cuelists vers Cuelist : Titre mal orthographié

#REDIRECTION [[Cuelist]]

Cuelist

2025-12-09T21:04:34Z

Norb : Norb a déplacé la page Cuelists vers Cuelist : Titre mal orthographié

== Cuelist ==

Une '''Cuelist''' (ou « Liste de Cues ») est l'élément central du système de lecture et de séquencement dans BlinderKitten. Elle est responsable de la gestion d'une série de [[Cue]]s (états lumineux) et de leurs transitions. Chaque cuelist peut être transformée en '''Chaser'''.

=== Paramètres de Base de la cuelist ===

Ces paramètres définissent les propriétés d'identification, de priorité, et les niveaux maîtres de la liste de Cues.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''ID''' || Int || L'identifiant unique de la cuelist.
|-
| '''Name''' || String || Nom de la cuelist.
|-
| '''Layer ID''' || Int || [[Layer]] de calcul de la cuelist. Un ID plus élevé signifie une priorité plus grande.
|-
| '''Solo Pool''' || Int || Si supérieur à zéro, numéro du [[solo pool]] utilisé : un seul objet avec ce numéro de pool peut être actif à la fois.
|-
| '''Tracking''' || Enum || Définit la persistance des valeurs (traquées) des [[Cue]]s précédents dans la séquence.
|-
| '''Loop''' || Enum || Comportement de la cuelist à la fin des Cues (Off ou Loop).
|-
| '''Off If Overwritten''' || Bool || La Cuelist s'éteint automatiquement si tous ses paramètres sont écrasés par d'autres Cuelists.
|-
| '''Auto Start / Auto Stop''' || Bool || Démarre ou arrête automatiquement la Cuelist si un des niveaux passe de ou vers zéro.
|-
| '''MIB Delay''' || Float || Délai à attendre pour le '''Move In Black''' (MIB) après l'extinction des projecteurs.
|-
| '''HTP Level''' || Float || Maître de niveau pour les canaux '''HTP''' (Highest Takes Priority). Agit comme un fader principal.
|-
| '''LTP Level''' || Float || Maître de niveau pour les canaux '''LTP''' (Latest Takes Priority).
|-
| '''Flash Level''' || Float || Niveau maître utilisé lors de l'activation d'un '''Flash''' ou d'un '''Swop'''.
|-
| '''Flash with LTP level''' || Bool || Si coché, le niveau LTP est appliqué lors de l'action Flash.
|-
| '''Absolute LTP value''' || Bool || Si coché, le niveau LTP agit comme un multiplicateur. Sinon, il agit comme un crossfade.
|-
| '''Off Fade''' || Float || Temps de fondu par défaut lors de l'extinction de la cuelist.
|-
| '''Off Fade Curve''' || Automation || Courbe d'atténuation utilisée pour l'extinction.
|}

=== Options Chaser (`chaserOptions`) ===

Ce conteneur gère tous les paramètres nécessaires à l'exécution de la séquence en mode Poursuite (Chaser).

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''Is Chaser''' || Bool || Active ou désactive le mode chaser.
|-
| '''Direction''' || Enum || Direction du chaser (Normal, Reverse, Bounce, Random).
|-
| '''Speed''' || Float || Vitesse du chaser (en GO / minute).
|-
| '''In fade / Out fade''' || Float || Durées de fondu (en nombre de pas, non pas en secondes) pour les étapes entrantes et sortantes du Chaser.
|-
| '''Run X times''' || Float || Nombre de cycles du Chaser (0 pour infini).
|-
| '''In curve / Out curve''' || Automation || Courbes d'atténuation personnalisées pour les fondus (In/Out) du Chaser.
|}

=== Génération Automatique de Chaser (`chaserGenContainer`) ===

Ce conteneur fournit des outils pour créer rapidement un Chaser à partir d'un groupe.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''Group ID''' || Int || L'ID du [[Group]] à utiliser comme base pour la génération automatique du Chaser.
|-
| '''Buddying''' || Int || Nombre de projecteurs qui s'allument "ensemble" (parallélisation) lors de la génération.
|-
| '''Blocks''' || Int || Nombre de répétitions du Chaser.
|-
| '''Wings''' || Int || Répétitions symétriques (effet d'aile) lors de la génération.
|-
| '''Fixtures only''' || Bool || N'utilise que les projecteurs principaux (sans les sous-fixtures) pour la création du Chaser.
|}

=== Actions (Triggers) ===

Ces actions sont des commandes immédiates (boutons) qui modifient l'état de lecture de la cuelist ou sa structure interne.

{| class="wikitable" style="margin:auto"
|-
! Action !! Description
|-
| '''GO''' || Déclenche le [[Cue]] suivant (ou le premier si la cuelist est inactive).
|-
| '''GO back''' || Déclenche le [[Cue]] précédent dans la séquence.
|-
| '''OFF''' || Éteint la cuelist avec le temps de fondu défini par '''Off Fade'''.
|-
| '''KILL''' || Tue la cuelist immédiatement (Off avec un fondu de 0).
|-
| '''Toggle''' || Allume et éteint la cuelist alternativement.
|-
| '''Tap Tempo''' || Permet de régler la vitesse du Chaser en tapant manuellement l'action.
|-
| '''Set main conductor''' || Définit cette cuelist comme conduite principale du projet, c'est cette cuelist qui est affichée dans le [[Conductor infos]] et dans la [[Cuelist sheet]].
|-
| '''Load Content''' || Charge les commandes de la cue active dans le programmeur.
|-
| '''Clean all cues''' || Supprime toutes les commandes inutilisées dans tous les Cues de la liste.
|-
| '''Renumber cues''' || Réinitialise les ID de tous les Cues de la liste.
|-
| '''Insert cue before/after''' || Insère un nouveau [[Cue]] avant ou après le Cue sélectionné.
|-
| '''Regenerate Chaser''' || Déclenche la génération du Chaser en utilisant les paramètres du conteneur '''chaserGenContainer'''.
|}

Cue

2025-12-08T23:37:10Z

Norb : Page créée avec « == Cue == Un '''Cue''' (ou « État Lumineux ») est l'unité de base de stockage d'états dans BlinderKitten. Il stocke une liste de commandes à lancer lors de son exécution, ainsi que des informations de timing et des tâches. Il est contenu et séquencé par une Cuelist. === Paramètres de Base du Cue === {| class="wikitable" style="margin:auto" |- ! Paramètre !! Type !! Rôle |- | '''ID''' || Float || L'identifiant numérique du Cue (permet un re-nu... »

== Cue ==

Un '''Cue''' (ou « État Lumineux ») est l'unité de base de stockage d'états dans BlinderKitten. Il stocke une liste de commandes à lancer lors de son exécution, ainsi que des informations de timing et des tâches. Il est contenu et séquencé par une [[Cuelist]].

=== Paramètres de Base du Cue ===

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''ID''' || Float || L'identifiant numérique du Cue (permet un re-numérotage décimal dans la [[Cuelist]]).
|-
| '''Name''' || String || Nom affiché du Cue.
|-
| '''Cue text''' || String || Texte descriptif du Cue (ce qui se passe sur scène).
|-
| '''Go text''' || String || Texte affiché pour l'action GO (l'instruction pour l'opérateur).
|-
| '''Auto Follow''' || Enum || Définit si le Cue démarre automatiquement le Cue suivant après un délai.
|-
| '''Auto Follow Timing''' || Float || Le temps à attendre (en secondes) avant de déclencher le Cue suivant en mode Auto Follow.
|-
| '''Can be randomly called''' || Bool || Permet à ce Cue d'être appelé aléatoirement par la Cuelist parent.
|-
| '''Load Window Break Line''' || Bool || Insère une ligne de séparation dans la fenêtre de load.
|-
| '''Release Current Tracking''' || Bool || Force le relâchement des valeurs traquées lors du déclenchement.
|-
| '''Reuse Cue''' || Target || Permet à ce Cue d'hériter de toutes les commandes et tâches d'un autre Cue sans les stocker localement (réutilisation par référence).
|}

=== Timing (Conteneur `timingContainer`) ===

Ces paramètres définissent la gestion des délais et des fondus (fades) pour les valeurs HTP et LTP du Cue. Ils écrasent les réglages globaux de la [[Cuelist]] si définis localement.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''HTP In Delay''' || Float || Délai avant que les valeurs HTP du Cue commencent à s'appliquer (en GO).
|-
| '''HTP Out Delay''' || Float || Délai avant que les valeurs HTP du Cue commencent à s'éteindre (en OFF).
|-
| '''LTP Delay''' || Float || Délai avant que les valeurs LTP du Cue commencent à s'appliquer.
|-
| '''HTP In Fade''' || Float || Durée du fondu d'entrée pour les valeurs HTP.
|-
| '''HTP Out Fade''' || Float || Durée du fondu de sortie pour les valeurs HTP.
|-
| '''LTP Fade''' || Float || Durée du fondu pour les valeurs LTP.
|-
| '''Fade Curve''' || Automation || Courbe de fondu personnalisée (s'applique aux fades).
|-
| '''Delay Curve''' || Automation || Courbe de fondu personnalisée (s'applique aux délais).
|}

=== Conteneurs Internes (Managers) ===

Le Cue contient plusieurs gestionnaires qui stockent son contenu :

{| class="wikitable" style="margin:auto"
|-
! Conteneur !! Type !! Rôle
|-
| '''Commands''' || BaseManager<Command> || Liste des commandes [[Command]] DMX stockées par ce Cue (valeurs de projecteur).
|-
| '''Tasks''' || BaseManager<Task> || Liste des [[Task]]s à exécuter lorsque le Cue est déclenché (action GO).
|-
| '''Tasks off''' || BaseManager<Task> || Liste des [[Task]]s à exécuter lorsque le Cue est désactivé (action OFF).
|}

=== Actions (Triggers) ===

Ces actions sont des commandes immédiates (boutons) qui agissent sur l'état ou le contenu du Cue.

{| class="wikitable" style="margin:auto"
|-
! Action !! Description
|-
| '''GO''' || Déclenche l'exécution des commandes et des Tasks du Cue.
|-
| '''OFF''' || Désactive le Cue et exécute ses Tasks off.
|-
| '''Load Content''' || Charge le contenu (commandes) de la cue dans le [[Programmer]].
|-
| '''Replace Content''' || Remplace tout le contenu du Cue par celui du [[Programmer]].
|-
| '''Merge Content''' || Ajoute le contenu du [[Programmer]] au contenu du Cue.
|-
| '''Clean Unused''' || Supprime les commandes et tâches qui ne sont plus liées à des projecteurs existants.
|}

Accueil

2025-12-08T23:29:19Z

Norb :

<languages>
</languages>
<translate>
= BlinderKitten – Documentation officielle = 


Bienvenue sur la documentation du logiciel **BlinderKitten**, une régie lumière moderne, open-source et pensée pour les techniciens du spectacle vivant.


__TOC__


== Présentation ==
BlinderKitten est un logiciel de contrôle lumière gratuit, open source et sans restriction.

== Glossaire ==

*[[Assistant]]
*[[Carousel]]
*[[ChannelType|Channel/Parameter]]
*[[Cue]]
*[[Cuelist]]
*[[Effect]]
*[[Fixture]]
*[[Fixture Type]]
*[[Groups]]
*[[Interface]]
*[[Mappers]]
*[[Patch]]
*[[Programmer]]
*[[SubFixture]]


== Contribuer ==
Cette documentation est collaborative.
Vous pouvez proposer des corrections, ajouter des pages ou compléter les exemples existants.


Voir : [[Contribuer à la documentation]]


== Communauté ==
* Discord : https://discord.gg/tzxp9f3Dsc
* GitHub : https://github.com/NorbertRostaing/BlinderKitten
* Site officiel : https://blinderkitten.lighting


Bonne lecture et bienvenue dans la communauté BlinderKitten !

</translate>

ChannelType

2025-12-08T23:27:44Z

Norb :

== Channel Families ==

Les '''Channel Families''' agissent comme des conteneurs pour les Channel Types, tandis que les '''Channel Types''' définissent la logique de priorité et de comportement du canal.
Elles servent aussi a filtrer les encodeurs et l'enregistrement des presets.

=== Channel Types ===

Un '''Channel Type''' définit un type de canal qui pourra être utilisé dans les fixtures types et les commandes. C'est à ce niveau que le mode de priorité (HTP/LTP) est défini.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''Channel mode''' (Priority) || Enum || Définit la règle de priorité du canal.
|-
| '''React to grand master''' || Bool || Si coché, ce canal sera dimmé par le [[Input panel|grand master]].
|}

=== HTP / LTP ===

{| class="wikitable" style="margin:auto"
|-
| '''''Highest Takes Precedence (HTP)''''' || La valeur la plus élevée parmi toutes les sources est retenue (utilisé principalement pour l'intensité).
|-
| '''''Latest Takes Precedence (LTP)''''' || La dernière source active à avoir envoyé une valeur est prioritaire (utilisé pour les couleurs, positions, gobos, etc.).
|}

ChannelType

2025-12-08T23:26:05Z

Norb : Page créée avec « == Channel Families == Les '''Channel Families''' agissent comme des conteneurs pour les Channel Types, tandis que les '''Channel Types''' définissent la logique de priorité et de comportement du canal. Elles servent aussi a filtrer les encodeurs et l'enregistrement des presets. === Channel Types === Un '''Channel Type''' définit un type de canal qui pourra être utilisé dans les fixtures types et les commandes. C'est à ce niveau que le mode de priorité... »

== Channel Families ==

Les '''Channel Families''' agissent comme des conteneurs pour les Channel Types, tandis que les '''Channel Types''' définissent la logique de priorité et de comportement du canal.
Elles servent aussi a filtrer les encodeurs et l'enregistrement des presets.

=== Channel Types ===

Un '''Channel Type''' définit un type de canal qui pourra être utilisé dans les fixtures types et les commandes. C'est à ce niveau que le mode de priorité (HTP/LTP) est défini.

{| class="wikitable" style="margin:auto"
|-
! Paramètre !! Type !! Rôle
|-
| '''Channel mode''' (Priority) || Enum || Définit la règle de priorité du canal.
|-
| '''Snap or Fade''' || Enum || Définit si la transition vers une nouvelle valeur doit se faire instantanément (Snap) ou par fondu (Fade).
|-
| '''React to grand master''' || Bool || Si coché, ce canal sera dimmé par le [[Input panel|grand master]].
|}

=== HTP / LTP ===

{| class="wikitable" style="margin:auto"
|-
| '''''Highest Takes Precedence (HTP)''''' || La valeur la plus élevée parmi toutes les sources est retenue (utilisé principalement pour l'intensité).
|-
| '''''Latest Takes Precedence (LTP)''''' || La dernière source active à avoir envoyé une valeur est prioritaire (utilisé pour les couleurs, positions, gobos, etc.).
|}

Cuelist

Norb : Page créée avec « == Contribute == This documentation is collaborative. You can suggest corrections, add new pages, or expand the existing examples. »

== Contribute ==
This documentation is collaborative.
You can suggest corrections, add new pages, or expand the existing examples.

Translations:Accueil/4/en

2025-11-25T21:05:25Z

Norb : Page créée avec « == Presentation == Blinderkitten is a lighting software wich is free, open source, and without restrictions »

== Presentation ==
Blinderkitten is a lighting software wich is free, open source, and without restrictions