Indicateurs d'export optionnels

DeviceMessage()

Cet indicateur d’export est utilisé pour afficher un message dans SignalRGB sur la page de l’appareil associé. Vous pouvez l’utiliser pour afficher des particularités ou une description nécessaire à l’utilisateur.

La valeur de retour est un tableau 1D de 2 chaînes. Le texte à afficher dans la fenêtre contextuelle, suivi de l’infobulle au survol.

export function DeviceMessage() { return ["This device has a weird quirk!", "The quirk is this!"]; }

SupportsSubdevices()

Cet indicateur d’export est utilisé pour les contrôleurs d’éclairage qui ne prennent en charge que les sous-appareils et n’ont pas de LEDs intégrées à contrôler. En retournant true, cet export empêchera l’appareil parent d’apparaître sur le canevas dans les mises en page et désactivera la modification de ses paramètres de position.

export function SupportsSubdevices(){ return true; }

on*Changed()

Cette fonction d’export n’est pas utilisée par le backend, mais est utilisée comme rappel à l’intérieur du plugin pour notifier lorsqu’un paramètre est modifié. Ci-dessous, vous verrez un exemple de son utilisation pour définir le DPI d’une souris chaque fois qu’un utilisateur change le curseur, au lieu d’interroger les valeurs dans votre boucle de rendu et de gérer le changement là-bas.

Ces rappels sont appelés après que les données RGB ont été récupérées depuis le canevas, mais avant que la fonction de rendu soit appelée pour l’image de rendu actuelle.

Note

La fonction doit également être exportée pour que SignalRGB puisse l’appeler.

// Export de paramètre
export function ControllableParameters(){
    return [
{ property: "dpi1", label: "DPI", step: "50", type: "number", min: "200", max: "18000", default: "800" },
    ];
}

// Fonctions DPI
export function ondpi1Changed() {
  setDpi(dpi1);
}

function setDpi(dpi) {
  if (!SettingControl) {
    return;
  }
  device.log(`Setting Dpi to ${dpi}`);
  Corsair_Set(CORSAIR_DPI_X, dpi);
  Corsair_Set(CORSAIR_DPI_Y, dpi);

  device.log(`DPI x is now ${Corsair_Get(CORSAIR_DPI_X)}`);
  device.log(`DPI y is now ${Corsair_Get(CORSAIR_DPI_Y)}`);
}