Aanraak-LED#

Invoering #

De VEX IQ Touch LED is zowel een lampje als een knop. Hij kan in verschillende kleuren oplichten om feedback te geven, bijvoorbeeld om aan te geven dat de robot klaar is, welke modus is geselecteerd of om een kleur te tonen die door een andere sensor is gedetecteerd. Hij kan ook detecteren wanneer hij wordt aangeraakt, waardoor je het gedrag van een robot met een tik kunt starten of wijzigen.

Klasseconstructor #

touchled( 
  int32_t index );

Klasse-destructor #

Vernietigt het touchled object en geeft de bijbehorende resources vrij.

virtual ~touchled();

Parameters #

Parameter	Type	Beschrijving
`index`	`int32_t`	De Smart Port waarop de Touch LED is aangesloten, wordt weergegeven als `PORTx`, waarbij `x` het poortnummer is (bijvoorbeeld `PORT1`).

Voorbeeld #

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

Lidfuncties #

De klasse touchled bevat de volgende lidfuncties:

pressingindrukt – Geeft aan of de aanraak-LED wordt ingedrukt.
setColor – Stelt de kleur van de Touch LED in.
setFade – Stelt in hoe snel kleuren in elkaar overvloeien.
setBrightness – Stelt de helderheid van de Touch LED in.
pressed – Registreert een functie die moet worden aangeroepen wanneer de aanraak-LED wordt ingedrukt.
released – Registreert een functie die moet worden aangeroepen wanneer de Touch LED wordt losgelaten.
on – Schakelt de aanraak-LED in.
off – Schakelt de aanraak-LED uit.
setBlink – Schakel de aanraak-LED oneindig aan en uit.
installed – Geeft aan of de Touch LED is verbonden met de Brain.

Voordat er lidfuncties van touchled kunnen worden aangeroepen, moet er een instantie van touchled worden gemaakt, zoals hieronder weergegeven:

/* 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 #

Geeft een waarde terug als de TouchLED momenteel wordt ingedrukt.

Available Functions

bool pressing();

Parameters

Deze functie accepteert geen parameters.

Return Values

Retourneert bool (booleaanse waarde) om aan te geven of de aanraak-LED wordt ingedrukt.

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

setColor #

Hiermee wordt de LED van de aanraaksensor op een specifieke kleur ingesteld.

Available Functions

1 — Stelt de Touch LED in op een kleur met behulp van vex::color.
void setColor( 
  vex::color  color );

2 — Stelt LED-kleuren in met behulp van een colorType.
void setColor( 
  colorType   color );

Parameters

Parameter

Type

Beschrijving

color

colorType

Een geldige kleur:

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

Een geldige aangepaste kleur.

Return Values

Deze functie retourneert geen waarde.

setFade #

Hiermee stelt u de fade-instelling van de Touch LED-sensor in. De Touch LED-sensor verandert van kleur met behulp van de ingestelde fade-instelling.

Available Functions

void setFade(
  fadeType  speed );

Parameters

Parameter	Type	Beschrijving
`speed`	`fadeType`	De snelheid waarop de fade wordt ingesteld: `fast` `off` — geen fade `slow`

Parameter

Type

Beschrijving

speed

fadeType

De snelheid waarop de fade wordt ingesteld:

fast
off — geen fade
slow

Return Values

Deze functie retourneert geen waarde.

setBrightness #

Hiermee stelt u de helderheid van de Touch LED in.

Available Functions

void setBrightness(
  uint32_t  value );

Parameters

Parameter	Type	Beschrijving
`value`	`uint32_t`	De helderheid van de Touch LED kan als percentage worden ingesteld.

Return Values

Deze functie retourneert geen waarde.

pressed #

Registreert een functie die moet worden aangeroepen wanneer de aanraak-LED wordt ingedrukt.

Available Functions

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

Parameters

Parameter	Type	Beschrijving
`callback`	`void (*)(void)`	Een pointer naar een functie die wordt aangeroepen wanneer de Touch LED wordt ingedrukt. De functie mag geen parameters accepteren en moet void retourneren.

Return Values

Deze functie retourneert geen waarde.

Examples

Definieer de callbackfunctie (buiten int main())

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

Registreer de callback binnen 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 #

Registreert een functie die moet worden aangeroepen wanneer de aanraak-LED wordt losgelaten.

Available Functions

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

Parameters

Parameter	Type	Beschrijving
`callback`	`void (*)(void)`	Een pointer naar een functie die wordt aangeroepen wanneer de Touch LED wordt losgelaten. De functie mag geen parameters accepteren en moet void retourneren.

Return Values

Deze functie retourneert geen waarde.

Examples

Definieer de callbackfunctie (buiten int main())

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

Registreer de callback binnen 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 #

Hiermee wordt de LED van de TouchLED-sensor ingeschakeld met behulp van kleuren en een ingestelde helderheid.

Available Functions

1 — Stelt de LED in op een kleur met behulp van vex::color.
void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — Stelt de LED-kleur in met behulp van de tint.
void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 — Stelt de LED-kleur in op basis van RGB-waarden.
void on( 
  uint8_t   red, 
  uint8_t   green, 
  uint8_t   blue, 
  uint32_t  brightness = 100);

Parameters

Parameter	Type	Beschrijving
`color`	`vex::color`	Een geldige kleur: `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`	Optioneel. De helderheid van de LED in procenten, standaard ingesteld op 100.
`hue`	`uint32_t`	De kleurtoon van de LED. Deze kan ook worden weergegeven als een hexadecimale waarde (0x000000).
`red`	`uint8_t`	Een geheel getal dat de rode waarde van de LED aangeeft.
`green`	`uint8_t`	Een geheel getal dat de groene waarde van de LED weergeeft.
`blue`	`uint8_t`	Een geheel getal dat de blauwe waarde van de LED weergeeft.

Return Values

Deze functie retourneert geen waarde.

off #

Schakelt de aanraak-LED uit.

Available Functions

void off( void );

Parameters

Deze functie accepteert geen parameters.

Return Values

Deze functie retourneert geen waarde.

setBlink #

De aanraak-LED knippert herhaaldelijk in een aan- en uitpatroon.

Available Functions

1 — Stelt de knipperkleur in met behulp van een vex::color.
void setBlink( 
  vex::color    color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

2 — Stelt de knipperkleur in met behulp van een hexadecimale kleurwaarde.
void setBlink( 
  uint32_t      hue, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

3 — Stelt de knipperkleur in met behulp van een colorType.
void setBlink( 
  colorType     color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

Parameters

Parameter	Type	Beschrijving
`color`	`colorType`	Een geldige kleur: `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`	Optioneel. De duur in seconden dat de LED per knippercyclus brandt, standaard ingesteld op 0,25 seconden.
`offTime`	`double`	Optioneel. De duur in seconden dat de LED uit is per knippercyclus, standaard ingesteld op 0,25 seconden.
`hue`	`uint32_t`	Een hexadecimale kleurwaarde (bijv. `0xFF0000` voor rood).
`color`	`vex::color`	Een geldige aangepaste kleur.

Return Values

Deze functie retourneert geen waarde.

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 #

Geeft aan of de Touch LED is aangesloten.

Available Functions

bool installed();

Parameters

Deze functie accepteert geen parameters.

Return Values

Geeft een Booleaanse waarde terug die aangeeft of de Touch-LED is aangesloten:

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