Skārienjutīga LED#

Ievads #

VEX IQ Touch LED ir gan gaisma, gan poga. Tā var mirdzēt dažādās krāsās, lai sniegtu atgriezenisko saiti, piemēram, signalizējot, ka robots ir gatavs, parādot, kurš režīms ir izvēlēts, vai atbilstot cita sensora noteiktai krāsai, un tā var noteikt, kad tai pieskaras, ļaujot jums iedarbināt vai mainīt robota darbību ar vienu pieskārienu.

Klases konstruktors #

touchled( 
  int32_t index );

Klases iznīcinātājs #

Iznīcina touchled objektam un atbrīvo saistītos resursus.

virtual ~touchled();

Parametri #

Parametrs	Tips	Apraksts
`index`	`int32_t`	Viedā pieslēgvieta, kurai ir pievienota skārienjutīgā gaismas diode, tiek pierakstīta kā `PORTx`, kur `x` ir pieslēgvietas numurs (piemēram, `PORT1`).

Piemērs #

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

Dalībnieku funkcijas #

touchled klasē ir iekļautas šādas dalībfunkcijas:

pressing – Atgriež, vai tiek nospiesta skārienjutīgā gaismas diode.
setColor – Iestata skārienjutīgā LED krāsu.
setFade – Iestata, cik ātri krāsas izbalēs viena pēc otras.
setBrightness – Iestata skārienjutīgā LED spilgtumu.
pressed – Reģistrē funkciju, kas tiks izsaukta, nospiežot skārienjutīgo gaismas diodi.
released – Reģistrē funkciju, kas tiks izsaukta, atlaižot skārienjutīgo gaismas diodi.
on – Ieslēdz skārienjutīgo LED indikatoru.
off – Izslēdz skārienjutīgo gaismas diodi.
setBlink – Skārienjutīgā LED lampiņa ieslēdzas un izslēdzas uz nenoteiktu laiku pārmaiņus.
installed – Atgriež, vai skārienjutīgā gaismas diode ir savienota ar smadzenēm.

Pirms jebkuru touchled dalībfunkciju izsaukšanas ir jāizveido touchled instance, kā parādīts zemāk:

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

Atgriež, ja pašlaik tiek nospiesta TouchLED poga.

Available Functions

bool pressing();

Parameters

Šī funkcija nepieņem nekādus parametrus.

Return Values

Atgriež bool kas norāda, vai tiek nospiesta skārienjutīgā gaismas diode.

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

setColor #

Iestata skārienjutīgā LED sensora gaismas diodi noteiktā krāsā.

Available Functions

1 — Iestata skārienjutīgo gaismas diodi uz krāsu, izmantojot vex::color.
void setColor( 
  vex::color  color );

2 — Iestata LED krāsas, izmantojot colorType.
void setColor( 
  colorType   color );

Parameters

Parametrs

Tips

Apraksts

color

colorType

Derīga krāsa:

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

Derīga pielāgota krāsa.

Return Values

Šī funkcija neatgriež vērtību.

setFade #

Iestata skārienjutīgā LED sensora izbalēšanas iestatījumu. Skārienjutīgais LED sensors mainīs krāsas uz jaunām, izmantojot izbalēšanas veidu.

Available Functions

void setFade(
  fadeType  speed );

Parameters

Parametrs	Tips	Apraksts
`speed`	`fadeType`	Izbalēšanas ātrums tiks iestatīts uz: `fast` `off` — bez izbalēšanas `slow`

Parametrs

Tips

Apraksts

speed

fadeType

Izbalēšanas ātrums tiks iestatīts uz:

fast
off — bez izbalēšanas
slow

Return Values

Šī funkcija neatgriež vērtību.

setBrightness #

Iestata skārienjutīgā LED spilgtumu.

Available Functions

void setBrightness(
  uint32_t  value );

Parameters

Parametrs	Tips	Apraksts
`value`	`uint32_t`	Skārienekrāna gaismas diodes spilgtums, kas jāiestata procentos.

Return Values

Šī funkcija neatgriež vērtību.

pressed #

Reģistrē funkciju, kas tiks izsaukta, nospiežot skārienjutīgo gaismas diodi.

Available Functions

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

Parameters

Parametrs	Tips	Apraksts
`callback`	`void (*)(void)`	Rādītājs uz funkciju, kas tiks izsaukta, nospiežot skārienjutīgo gaismas diodi. Funkcijai nedrīkst būt parametri, un tai jāatgriež tukša vērtība.

Return Values

Šī funkcija neatgriež vērtību.

Examples

Definējiet atzvanīšanas funkciju (ārpus int main())

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

Reģistrējiet atzvanīšanas funkciju int main() iekšpusē

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 #

Reģistrē funkciju, kas tiks izsaukta, atlaižot skārienjutīgo gaismas diodi.

Available Functions

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

Parameters

Parametrs	Tips	Apraksts
`callback`	`void (*)(void)`	Rādītājs uz funkciju, kas tiks izsaukta, atlaižot skārienjutīgo gaismas diodi. Funkcijai nedrīkst būt parametri, un tai jāatgriež tukša vērtība.

Return Values

Šī funkcija neatgriež vērtību.

Examples

Definējiet atzvanīšanas funkciju (ārpus int main())

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

Reģistrējiet atzvanīšanas funkciju int main() iekšpusē

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 #

Ieslēdz TouchLED sensora gaismas diodi, izmantojot krāsas un iestatītu spilgtumu.

Available Functions

1 — Iestata LED krāsu, izmantojot vex::color.
void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — Iestata LED krāsu, izmantojot nokrāsu.
void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 — Iestata LED krāsu pēc RGB vērtībām.

void on( 
  uint8_t   red, 
  uint8_t   green, 
  uint8_t   blue, 
  uint32_t  brightness = 100);

Parameters

Parametrs	Tips	Apraksts
`color`	`vex::color`	Derīga krāsa: `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`	Neobligāti. Spilgtums procentos, kādā iestatīt gaismas diodi; noklusējuma vērtība ir 100.
`hue`	`uint32_t`	Gaismas diodes nokrāsa. To var attēlot arī kā heksadecimālo vērtību (0x000000).
`red`	`uint8_t`	Vesels skaitlis, kas apzīmē gaismas diodes sarkano vērtību.
`green`	`uint8_t`	Vesels skaitlis, kas apzīmē gaismas diodes zaļo vērtību.
`blue`	`uint8_t`	Vesels skaitlis, kas apzīmē gaismas diodes zilo vērtību.

Return Values

Šī funkcija neatgriež vērtību.

off #

Izslēdz skārienjutīgo LED indikatoru.

Available Functions

void off( void );

Parameters

Šī funkcija nepieņem nekādus parametrus.

Return Values

Šī funkcija neatgriež vērtību.

setBlink #

Atkārtoti mirgo skārienjutīgā gaismas diode ieslēdzas un izslēdzas.

Available Functions

1 — Iestata mirgošanas krāsu, izmantojot vex::color.
void setBlink( 
  vex::color    color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

2 — Iestata mirgošanas krāsu, izmantojot heksadecimālo krāsas vērtību.
void setBlink( 
  uint32_t      hue, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

3 — Iestata mirgošanas krāsu, izmantojot colorType.
void setBlink( 
  colorType     color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

Parameters

Parametrs	Tips	Apraksts
`color`	`colorType`	Derīga krāsa: `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`	Neobligāti. Ilgums sekundēs, cik ilgi gaismas diode būs ieslēgta vienā mirgošanas ciklā, noklusējuma iestatījums ir 0,25 sekundes.
`offTime`	`double`	Neobligāti. Ilgums sekundēs, cik ilgi gaismas diode būs izslēgta katrā mirgošanas ciklā, noklusējuma iestatījums ir 0,25 sekundes.
`hue`	`uint32_t`	Sešpadsmitdaļīga krāsas vērtība (piemēram, `0xFF0000` sarkanai krāsai).
`color`	`vex::color`	Derīga pielāgota krāsa.

Return Values

Šī funkcija neatgriež vērtību.

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 #

Atgriež, vai ir pievienota skārienjutīgā gaismas diode.

Available Functions

bool installed();

Parameters

Šī funkcija nepieņem nekādus parametrus.

Return Values

Atgriež Būla vērtību, kas norāda, vai ir pievienota skārienjutīgā gaismas diode:

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