Description de la leçon
Ajout de contrôles
8m 23s
Ajoutez des contrôles personnalisés de différentes manières et utilisez votre script Lua ou votre Block Controller pour les contrôler.
Transcription Vidéo
Ajout de contrôles
8m 23s
0:08
Que vous programmiez avec un script Lua, le Block Controller ou de simples Composants de contrôle, le
0:13
résultat final revient souvent à mettre une sorte de bouton que l'utilisateur peut activer dans une UCI.
0:19
Votre bouton va peut-être lancer votre script personnalisé, ou être contrôlé par un script – de toutes les
0:25
façons, vous devrez lier ces contrôleurs à votre programmation. Cela signifie souvent que vous devrez
0:31
ajouter des contrôleurs vierges à votre projet, alors voyons comment le faire avec les trois méthodes.
0:37
Pour rappel, il n'existe que quelques types fondamentaux de contrôleurs : les boutons et les commandes
0:42
appelées « knobs » sont interactifs, tandis que Meters et LED sont des compteurs et voyants affichant
0:47
des informations. Les champs de texte peuvent être les deux – pour saisir des informations ou afficher la
0:56
chaîne d’un autre contrôleur.
0:59
Pour ajouter un bouton vide directement dans votre projet, vous pouvez prendre le composant Custom
1:04
Controls. Par défaut, il n'a rien dans son tableau de bord, jusqu'à ce que vous choisissiez le contrôleur
1:10
voulu ici dans ses Propriétés.
1:13
Vous pouvez ajouter plusieurs copies du même type de bouton dans des groupes, alors sélectionnons un
1:18
type pour notre premier groupe. Il semble y avoir environ 20 types de contrôleurs différents, mais ce
1:23
sont toutes des variantes des cinq que nous venons de citer.
1:28
Ceux-ci sont tous de types knob, et ceux-là de type bouton, vous voyez ? Ils ont juste des dénominations
1:35
et des plages prédéterminées différentes, que vous pouvez également personnaliser.
1:41
Une fois que vous avez sélectionné un type de contrôleur pour un groupe, vous pouvez en ajouter
1:45
d'autres identiques en augmentant le nombre dans Count, de 1 à 256. Vous avez aussi la possibilité
1:52
d'ajouter un second groupe pour un autre type de contrôleur.
1:56
Sachez que vous ne pouvez pas sélectionner le même type de contrôleur pour votre second groupe. S’il
2:01
vous faut plus de 256 contrôleurs du même type, vous devrez ajouter un autre composant Custom Controls.
2:09
En repensant à notre vidéo sur l'arbre de contrôle de Q-SYS, les différences entre ces contrôleurs ont
2:14
maintenant plus de sens. Un bouton Mute et un bouton Toggle, par exemple, ont exactement les
2:20
mêmes valeurs et positions, mais un bouton Toggle a des chaînes true/false signifiant vrai/faux et un
2:27
bouton Mute des chaînes muted/unmuted signifiant son coupé/son rétabli.
2:32
Si vous ajoutez un contrôleur Generic Float knob ayant la même plage qu'un contrôleur de niveau Level,
2:37
ils auront les mêmes valeurs numérique et de position, mais la chaîne du contrôleur Level se terminera par « dB ».
2:46
Consultez le fichier d'aide pour obtenir la liste complète des valeurs, positions et chaînes de ces
2:51
contrôleurs, ainsi que leurs plages de personnalisation et par défaut.
2:55
Si vous utilisez des Composants de contrôle, vous pouvez commencer à les câbler directement aux
3:00
broches de commande de votre choix. Si vous utilisez le composant Control Script, vous pouvez le câbler à votre script.
3:07
Vous pouvez ensuite faire référence à ce contrôleur dans le script en utilisant le mot-clé Controls, qui est
3:13
l'objet principal de l'arbre de contrôle.
3:15
Dans ce cas, Controls-point-Inputs ou Controls-point-Outputs selon le point de câblage. Vous devrez
3:22
aussi indiquer entre crochets la broche de connexion, ce que l’on appelle son index.
3:28
Vous pouvez ensuite étendre cet arbre de contrôle pour faire référence à une propriété spécifique du
3:33
contrôleur. Avec la commande vue dans la vidéo précédente, j'ai pu imprimer la valeur de ce contrôleur
3:38
dans la fenêtre de débogage en tapant « print (Controls-point-Inputs[index 1]-point-Value) ».
3:46
Cependant, si vous créez des contrôleurs personnalisés juste pour les connecter à un script de contrôle,
3:52
utilisez plutôt le composant Text Controller. Il permet également d'ajouter des contrôleurs vides à votre
3:58
projet, mais ceux-ci y sont déjà intégrés, il est donc plus facile d'y faire référence. Rappelons que les
4:05
anciennes versions de Q-SYS ont un composant « Scriptable Controls » à la place du Text Controller.
4:11
Leurs fonctionnalités sont pour la plupart les mêmes, mais leur interface est légèrement différente.
4:15
Nous nous concentrerons sur la version Text Controller.
4:18
L'interface d'ajout de contrôleurs dans ce composant est différente de celle du composant Custom
4:22
Controls, mais le concept est le même. Plutôt que de définir les contrôleurs dans les Propriétés, nous
4:28
pouvons les ajouter directement ici dans le tableau de bord.
4:32
Commencez par cliquer sur le bouton plus pour ajouter un contrôleur, et spécifiez ensuite son type par
4:37
catégorie. Tous les boutons sont regroupés et vous pouvez choisir entre un bouton momentané, Toggle
4:45
ou Trigger. Si nous sélectionnons Indicator, nous retrouverons nos LED, compteurs et afficheurs de texte.
4:52
Personnellement, je trouve cette organisation un peu plus intuitive que les Custom Controls que nous
4:56
venons de voir, car le classement est par fonction plutôt que par ordre alphabétique.
5:03
Pour les contrôleurs à plage personnalisable, vous pouvez spécifier les valeurs Mini et Maxi. Et si vous
5:10
voulez exposer ce contrôleur pour le câbler à autre chose dans Q-SYS, vous pouvez inclure une broche
5:15
d'entrée ou de sortie, ou les deux, qui s'ajouteront à votre composant dans le schéma après avoir cliqué sur OK.
5:23
Vous avez également la possibilité de nommer ce contrôleur, ce que je vous recommande fortement de
5:27
faire. « Control 1 » n'est pas un bon nom. Vous pourriez le nommer comme vous – Kevin.
5:33
Quoi ? Comment ai-je su que vous vous appeliez Kevin ? Je suis trop bon. Tous les Kevin sont en train de
5:41
flipper, et les autres se disent : « Je ne m'appelle pas Kevin ». Quoi qu'il en soit, l'avantage de nommer
5:46
votre contrôleur est que vous pouvez le citer par son nom dans votre script.
5:51
Plutôt que Controls-point-Inputs[index 1] que nous avons vu dans l'exemple précédent, je peux
5:56
maintenant faire référence à ce contrôleur avec Controls-point-Kevin dans le script. Si vous ajoutez
6:02
plusieurs exemplaires de ce même Contrôleur, vous devrez faire référence à leur index dans l'arbre de
6:06
contrôle Lua comme ceci : Controls-point-Kevin[index 1], comme les entrées de Control Script.
6:14
Faites attention à l'utilisation d'espaces dans le nom de vos contrôleurs. Si votre nom de contrôleur
6:18
comporte un espace, vous devrez le mentionner entre crochets et guillemets comme ceci :
6:24
Controls-point-crochet-guillemets-Kevin Jones-guillemets-crochet.
6:30
PS - Si un Kevin Jones regarde ça, il doit devenir fou.
6:35
Et rendez-vous service en utilisant une convention d'appellation cohérente, de sorte que si un autre
6:40
programmeur doit un jour travailler sur ce projet, il pourra facilement comprendre vos appellations.
6:46
Enfin, regardons le Block Controller. Double-cliquez sur ce panneau et vous verrez la même interface
6:51
que dans le Text Controller. Vous pouvez ajouter des boutons, définir leur type, etc.
6:57
Une fois encore, vous avez la possibilité d'ajouter des broches de commande au composant et de
7:02
donner un nom à votre contrôleur. Cette fois, pas d'inquiétude pour les espaces dans ce nom. Le Block
7:08
Controller sait comment corriger cette éventuelle erreur de syntaxe en intégrant les crochets et les
7:13
guillemets appropriés lorsqu'il compile, alors soyez fou, Kevin. Nommez-les comme vous voulez.
7:19
« Ce type est obsédé par les Kevin. »
7:22
« Hé Kevin, qu'est-ce que tu regardes ? »
7:23
« Sors de mon espace, Kevin ! »
7:26
L'un des grands avantages du Block Controller est que vous pouvez ajouter de la même façon des
7:31
connexions. Comme pour les boutons de commande, vous pouvez choisir une connexion TCP, UDP ou
7:38
série, et la nommer.
7:42
L'adresse IP et le numéro de port se règlent une fois en mode émulation ou en mode d'exécution, et si
7:47
vous voulez les contrôler dynamiquement, vous pouvez exposer leurs broches de commande.
7:53
Dans le Block Controller, vous verrez ces connexions listées sous vos Contrôleurs, avec de nouveaux
7:58
blocs associés à toutes les actions possibles sur une connexion de ce type. Nous examinerons ces
8:04
connexions dans une prochaine vidéo.
8:07
C'est tout pour l’ajout de contrôleurs. Il y a un exercice rapide à faire maintenant dans votre Cahier
8:11
d'exercices Q-SYS Contrôle. Quand vous l'aurez terminé, passez à la section suivante, nous examinerons
8:18
quelques autres branches de l'arbre de contrôle associées à ces contrôleurs.
Téléchargements et liens
Ajout de contrôles
8m 23s