LED tactile#

Introduction #

Le VEX IQ Touch LED fait à la fois office de voyant et de bouton. Il peut s’illuminer de différentes couleurs pour fournir des informations, par exemple pour signaler que le robot est prêt, indiquer le mode sélectionné ou correspondre à une couleur détectée par un autre capteur. Il détecte également le contact, ce qui permet de démarrer ou de modifier le comportement du robot d’une simple pression.

Constructeur de classe #

touchled( 
  int32_t index );

Destructeur de classe #

Détruit l’objet touchled et libère les ressources associées.

virtual ~touchled();

Paramètres #

Paramètre	Taper	Description
`index`	`int32_t`	Le port intelligent auquel la LED tactile est connectée, écrit sous la forme `PORTx`, où `x` est le numéro de port (par exemple, `PORT1`).

Exemple #

// Create a touchled instance in Port 1
touchled TouchLED1 = touchled(PORT1);

Fonctions des membres #

La classe touchled comprend les fonctions membres suivantes :

pressing – Renvoie si la LED tactile est enfoncée.
setColor – Définit la couleur de la LED tactile.
setFade – Définit la vitesse à laquelle les couleurs se fondent les unes dans les autres.
setBrightness – Définit la luminosité de la LED tactile.
pressed – Enregistre une fonction à appeler lorsque la LED tactile est pressée.
released – Enregistre une fonction à appeler lorsque la LED tactile est relâchée.
on – Allume la LED tactile.
off – Éteint la LED tactile.
setBlink – Faire clignoter et éteindre la LED tactile de manière alternée indéfiniment.
installed – Renvoie si la LED tactile est connectée au cerveau.

Avant d’appeler une quelconque fonction membre touchled , une instance touchled doit être créée, comme indiqué ci-dessous :

/* This constructor is required when using VS Code.
Touch LED configuration is generated automatically
in VEXcode using the Device Menu. Replace the values
as needed. */

// Create a Touch LED instance in Port 1
touchled TouchLED1 = touchled(PORT1);

pressing #

Renvoie la valeur si la LED tactile est actuellement enfoncée.

Available Functions

bool pressing();

Parameters

Cette fonction n’accepte aucun paramètre.

Return Values

Renvoie une valeur booléenne bool indiquant si la LED tactile est enfoncée.

true — The Touch LED is being pressed.
false — The Touch LED is not being pressed.

setColor #

Permet d’allumer la LED du capteur tactile sur une couleur spécifique.

Available Functions

1 — Définit la couleur de la LED tactile en utilisant vex::color.
void setColor( 
  vex::color  color );

2 — Définit les couleurs des LED en utilisant un type de couleur colorType.
void setColor( 
  colorType   color );

Parameters

Paramètre

Taper

Description

color

colorType

A valid color:

blue
blue_green
blue_violet
green
orange
purple
red
red_orange
red_violet
violet
white
yellow
yellow_green
yellow_orange
colorType::none
black
transparent

color

vex::color

A valid custom color.

Return Values

Cette fonction ne renvoie aucune valeur.

setFade #

Définit le mode de fondu du capteur LED tactile. Le capteur LED tactile changera de couleur selon le type de fondu sélectionné.

Available Functions

void setFade(
  fadeType  speed );

Parameters

Paramètre	Taper	Description
`speed`	`fadeType`	Vitesse de fondu : `fast` `off` — pas de fondu `slow`

Paramètre

Taper

Description

speed

fadeType

Vitesse de fondu :

fast
off — pas de fondu
slow

Return Values

Cette fonction ne renvoie aucune valeur.

setBrightness #

Régle la luminosité de la LED tactile.

Available Functions

void setBrightness(
  uint32_t  value );

Parameters

Paramètre	Taper	Description
`value`	`uint32_t`	Réglage de la luminosité de la LED tactile en pourcentage.

Return Values

Cette fonction ne renvoie aucune valeur.

pressed #

Enregistre une fonction qui sera appelée lorsque la LED tactile est enfoncée.

Available Functions

void pressed( void (* callback)(void) );

Parameters

Paramètre	Taper	Description
`callback`	`void (*)(void)`	Un pointeur vers une fonction qui sera appelée lorsque l’utilisateur appuie sur la LED tactile. Cette fonction ne doit prendre aucun paramètre et ne doit rien renvoyer.

Return Values

Cette fonction ne renvoie aucune valeur.

Examples

Définissez la fonction de rappel (en dehors de int main())

// Display a message when LED is pressed
void LEDPressed() {
  Brain.Screen.print("LED pressed");
}

Enregistrez le rappel à l’intérieur de int main()

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Run LEDPressed when the value of the Touch LED is pressed.
  TouchLED1.pressed(LEDPressed);
}

released #

Enregistre une fonction qui sera appelée lorsque la LED tactile sera relâchée.

Available Functions

void released( void (* callback)(void) );

Parameters

Paramètre	Taper	Description
`callback`	`void (*)(void)`	Un pointeur vers une fonction qui sera appelée lorsque la LED tactile sera relâchée. Cette fonction ne doit prendre aucun paramètre et ne doit rien renvoyer.

Return Values

Cette fonction ne renvoie aucune valeur.

Examples

Définissez la fonction de rappel (en dehors de int main())

// Display a message when LED is released
void LEDReleased() {
  Brain.Screen.print("LED released");
}

Enregistrez le rappel à l’intérieur de int main()

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Run LEDReleased when the value of the Touch LED is released.
  TouchLED1.released(LEDReleased);
}

on #

Allume la LED du capteur TouchLED en utilisant des couleurs et une luminosité définie.

Available Functions

1 — Définit la couleur de la LED à l’aide de vex::color.
void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — Définit la couleur de la LED à l’aide de la teinte.
void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 — Définit la couleur de la LED par les valeurs RVB.
void on( 
  uint8_t   red, 
  uint8_t   green, 
  uint8_t   blue, 
  uint32_t  brightness = 100);

Parameters

Paramètre	Taper	Description
`color`	`vex::color`	A valid color: `blue` `blue_green` `blue_violet` `green` `orange` `purple` `red` `red_orange` `red_violet` `violet` `white` `yellow` `yellow_green` `yellow_orange` `colorType::none` `black` `transparent`
`brightness`	`uint32_t`	Optionnel. Luminosité de la LED en pourcentage, par défaut 100.
`hue`	`uint32_t`	La teinte de la LED. Celle-ci peut également être représentée par une valeur hexadécimale (0x000000).
`red`	`uint8_t`	Un entier représentant la valeur rouge de la LED.
`green`	`uint8_t`	Un entier représentant la valeur verte de la LED.
`blue`	`uint8_t`	Un entier représentant la valeur bleue de la LED.

Return Values

Cette fonction ne renvoie aucune valeur.

off #

Désactive la LED tactile.

Available Functions

void off( void );

Parameters

Cette fonction ne prend aucun paramètre.

Return Values

Cette fonction ne renvoie aucune valeur.

setBlink #

La LED tactile clignote de manière répétée selon un motif marche/arrêt.

Available Functions

1 — Définit la couleur de clignotement en utilisant un vex::color.
void setBlink( 
  vex::color    color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

2 — Définit la couleur de clignotement à l’aide d’une valeur de couleur hexadécimale.
void setBlink( 
  uint32_t      hue, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

3 — Définit la couleur de clignotement en utilisant un type de couleur colorType.
void setBlink( 
  colorType     color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

Parameters

Paramètre	Taper	Description
`color`	`colorType`	A valid color: `blue` `blue_green` `blue_violet` `green` `orange` `purple` `red` `red_orange` `red_violet` `violet` `white` `yellow` `yellow_green` `yellow_orange` `colorType::none` `black` `transparent`
`onTime`	`double`	Optionnel. Durée d’allumage de la LED par cycle de clignotement (en secondes), par défaut 0,25 seconde.
`offTime`	`double`	Optionnel. Durée en secondes pendant laquelle la LED restera éteinte par cycle de clignotement (par défaut : 0,25 seconde).
`hue`	`uint32_t`	La teinte de la LED. Celle-ci peut également être représentée par une valeur hexadécimale.
`color`	`vex::color`	A valid custom color.

Return Values

Cette fonction ne renvoie aucune valeur.

Notes - Calling [off](#off) will not stop the blinking behavior. To stop the blinking behavior, set the LED brightness to 0 with [setBrightness](#setbrightness).

installed #

Indique si la LED tactile est connectée.

Available Functions

bool installed();

Parameters

Cette fonction ne prend aucun paramètre.

Return Values

Renvoie une valeur booléenne indiquant si la LED tactile est connectée :

true — The sensor is connected and responding.
false — The sensor is not connected or not detected.