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

2025-12-16T23:54:15Z

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

Nouvelle page

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

OSCInterface - Historique des versions