Interface De La Fonction Colorled - Yoctopuce Yocto-Color Mode D'emploi

5. Programmation, concepts généraux

5.4. Interface de la fonction ColorLed

La librairie de programmation Yoctopuce permet de piloter une LED couleur aussi bien en
coordonnées RGB qu'en coordonnées HSL, les conversions RGB vers HSL étant faites
automatiquement par le module. Ceci permet aisément d'allumer la LED avec une certaine teinte et
d'en faire progressivement varier la saturation ou la luminosité. Si nécessaire, vous trouverez plus
d'information sur la différence entre RGB et HSL dans la section suivante.
logicalName
Chaîne de caractères contenant le nom logique de la LED RGB, initialement vide. Cet attribut peut
être changé au bon vouloir de l'utilisateur. Un fois initialisé à une valeur non vide, il peut servir de
point de départ pour accéder à directement à la LED RGB. Si deux LEDs RGB portent le même nom
logique dans un projet, il n'y a pas moyen de déterminer lequel va répondre si l'on tente un accès par
ce nom logique. Le nom logique du module est limité à 19 caractères parmi .. , .. , .. , et .
A Z a z 0 9 _ -
advertisedValue
Courte chaîne de caractères résumant l'état actuel de la LED RGB, et qui sera publiée
automatiquement jusqu'au hub parent. Pour une LED RGB, la valeur publiée est la couleur RGB de
la LED (6 digits hexadécimaux).
rgbColor
Couleur courante de la LED, sous la forme d'un entier encodé en RGB. Pour en extraire les
composantes rouges verte et bleus il faut pour le rouge: faire un shift a droite de 16 bit, pour le vert
faire un shift à droite de 8 bit et ne garder que les 8 bits de droite, pour le bleu ne garder que les 8
bits de droite.
hslColor
Couleur courante de la LED (comme rgbColor), mais exprimée dans le système de couleur HSL.
rgbMove
Permet de faire passer la LED de la couleur courante à une autre de manière continue et
indépendante. La valeur est un agrégat comprenant la couleur cible encodée en RGB dans un
entier, et une durée en millisecondes.
hslMove
Fonctionne de manière identique à rgbMove, mais en utilisant le système de couleurs HSL. En HSL,
la teinte étant une valeur circulaire (0..360°) il y a toujours deux manières d'opérer la transition: en
augmentant ou en diminuant le teinte. Le module optera pour la transition passant par le chemin le
plus court. dans le cas d'une différence d'exactement 180°, il optera pour la transition qui augmente
la valeur de la teinte.
En HSL, le module choisit la transition de teinte la plus courte. Dans le cas d'une différence de 180° la transition se
fera dans le sens horaire.
www.yoctopuce.com 19