OSCInterface

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

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

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

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

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

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.