Introduction à Open Sound Control

Configuration

Chacun des paramètres HOLOPHONIX peut être contrôlé ou surveillé via des commandes OSC (Open Sound Control).

Pour configurer la Réception et l'Envoi OSC, ouvrez l'onglet OSC dans les Paramètres.

Pour voir une liste de tous les paramètres OSC du preset actuel, ouvrez la fenêtre de Statut OSC.

Réception OSC

Envoyez les messages OSC à l'adresse IP du processeur sur le port par défaut 4003. Cependant, vous pouvez changer ce numéro de port. Voir l'onglet OSC dans les Paramètres.

Envoi OSC

Pour envoyer des commandes OSC depuis HOLOPHONIX vers un appareil externe, vous devez d'abord activer et configurer l'adresse IP de destination et le port. Voir l'onglet OSC dans les Paramètres.

Vous pouvez maintenant définir plusieurs destinations OSC, et choisir quel format de coordonnées sera envoyé pour le positionnement des sources.

danger

Les ports 4002, 4001, les ports en dessous de 1024, et les ports au-dessus de 65535 ne sont pas autorisés.

Lorsque la valeur d'un paramètre est modifiée (comme la position d'une source ou tout paramètre de source ou de bus par exemple), sa nouvelle valeur est envoyée à la destination.

Structure des Messages

Les messages OSC sont structurés en deux parties : d'abord l'adresse (dont les éléments sont séparés par des barres obliques : /), suivie de l'argument (la valeur) à transmettre. Regardez ici pour voir les Spécifications OSC complètes.

/{element}/{id}/{path/to/the/parameter} {argument#1} {argument#2} ...

Exemple

Pour régler le niveau du deuxième bus de spatialisation à -2.5 dB, on enverrait la commande suivante :

/bus/2/gain -2.5

Adresse

L'adresse elle-même contient d'abord le type d'objet (source mono /track, source stéréo /stereo, bus de spatialisation /bus, etc.), puis l'index de l'objet, et enfin le paramètre à contrôler. Lorsque vous sélectionnez un objet, son en-tête dans l'inspecteur affiche l'adresse OSC à utiliser pour le contrôler, avec son index inclus.

Selon le type d'objet à contrôler, l'adresse peut commencer par l'un des suivants :

• /track (objet mono)
• /stereo (objet stéréo)
• /multi (objet multicanal)
• /tree (objet arbre de micros)
• /aformat (source de flux ambisonique A-Format)
• /bformat (source de flux ambisonique B-Format)
• /zylia (source microphone Zylia)
• /em32 (source microphone Eigenmike 32)
• /em64 (source microphone Eigenmike 64)
• /hoastream (source Higher Order Ambisonics)
• /bus (bus de spatialisation sonore)
• /reverb (réverbération associée à chaque bus)
• /d2m (source direct to master)
• /lfe (bus LFE)
• /monitoring (bus de monitoring)
• /master (bus master)

Arguments

Types d'Arguments

L'"argument" est la valeur qui est envoyée à un paramètre spécifique. Il y a quatre types d'arguments :

• nombres entiers (1, 2, 3, etc.)
• nombres décimaux (1.1, 1.2, 1.3, etc.)
• chaînes de caractères (abc, xyz),
• booléens (true ou false, 0 ou 1)

Arrondi

Lorsqu'une valeur décimale est envoyée au lieu d'un entier, la valeur sera arrondie à l'entier le plus proche (par exemple, 1.5 deviendra 1, et 1.6 deviendra 2).

Échelles Angulaires

Concernant les valeurs exprimées en degrés, elles peuvent être envoyées à HOLOPHONIX sur l'échelle native -180° à +180°, mais aussi de 0° à 360°. Par exemple, si vous définissez un angle à +190°, il sera converti en -170°, sa direction équivalente sur l'échelle native.

Non Sensible à la Casse

Lorsque l'argument est une chaîne de caractères, les messages ne seront pas sensibles à la casse.

Exemple : Ces deux messages seront strictement équivalents :

/bformat/1/norm FuMa

/bformat/1/norm fuma

Expressions régulières (Groupes et substitutions)

Des structures spécifiques de messages permettent de contrôler plusieurs éléments ensemble :

• Utilisez le caractère ? comme élément de substitution pour un seul caractère dans les adresses,
• Utilisez le caractère * comme élément de substitution pour plusieurs caractères,
• Utilisez des crochets droits [ ] avec un tiret - pour contrôler une plage : [1-4] pour 1, 2, 3 et 4 par exemple,
• Utilisez des accolades { } avec une virgule , pour contrôler une liste : {1,4,5} pour 1, 4 et 5 seulement ; cela fonctionne aussi avec des chaînes de caractères : {stereo, multi} par exemple

Exemple 1 : Si vous voulez définir la position azimutale de toutes les sources mono à +10°, vous pourriez envoyer :

/track/*/azim 10

Exemple 2: Si vous voulez définir le niveau à -6 dB pour les sources stéréo 1 à 5, vous pourriez envoyer l'un de ces deux messages :

/stereo/[1-5]/gain -6

/stereo/{1,2,3,4,5}/gain -6

Exemple 3 : Si vous voulez muter toutes les sources mono et stéréo, envoyez :

/{track,stereo}/*/mute 1

Récupérer le statut d'un paramètre

Utilisez le message /get pour récupérer le statut d'un paramètre OSC spécifique, ou le statut de plusieurs paramètres.

Exemple : Si vous voulez connaître le niveau de gain appliqué à la source stéréo 5, envoyez :

/get /stereo/5/gain

Cela retournera /stereo/5/gain -6.

astuce

/get utilise la structure de message mentionnée ci-dessus et la correspondance de motifs.

Exemple : Si vous voulez connaître le niveau de gain appliqué aux sources stéréo 1 à 5, envoyez :

/get /stereo/[1-5]/gain

Cela retournera par exemple /stereo/1/gain -6 [...] /stereo/5/gain -6

/get peut aussi être utilisé pour récupérer des informations sur des éléments non indexés comme Master, Monitoring, LFE.

Exemple : Si vous voulez connaître le niveau de gain du master, envoyez :

/get /master/gain

Cela retournera par exemple /master/gain 0