Jutiklinis šviesos diodas#

Įvadas#

„VEX IQ Touch“ LED indikatorius yra ir lemputė, ir mygtukas. Jis gali šviesti skirtingomis spalvomis, kad pateiktų grįžtamąjį ryšį, pavyzdžiui, signalizuodamas, kad robotas yra pasiruošęs, rodydamas, kuris režimas pasirinktas, arba kad spalva atitiktų kito jutiklio aptiktą spalvą, ir gali aptikti, kada yra liečiamas, leisdamas jums paleisti arba pakeisti roboto elgesį vienu bakstelėjimu.

Klasės konstruktorius#

touchled( 
  int32_t index );

Klasės destruktorius#

Sunaikina touchled objektą ir išlaisvina susijusius išteklius.

virtual ~touchled();

Parametrai#

Parametras

Tipas

Aprašymas

index

int32_t

Išmanusis prievadas, prie kurio prijungtas jutiklinis šviesos diodas, rašomas kaip PORTx, kur x yra prievado numeris (pavyzdžiui, PORT1).

Pavyzdys#

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

Narių funkcijos#

touchled klasė apima šias narines funkcijas:

  • pressing – Grąžina, ar paspaudžiamas jutiklinis šviesos diodas.

  • setColor – Nustato jutiklinio LED spalvą.

  • setFade – Nustato, kaip greitai spalvos blunks viena po kitos.

  • setBrightness – Nustato jutiklinio LED ryškumą.

  • pressed – Registruoja funkciją, kuri bus iškviečiama paspaudus jutiklinį šviesos diodą.

  • released – Registruoja funkciją, kuri bus iškviesta atleidus jutiklinį šviesos diodą.

  • on – Įjungia jutiklinį šviesos diodą.

  • off – Išjungia jutiklinį šviesos diodą.

  • setBlink – Jutiklinis šviesos diodas pakaitomis įsijungia ir išsijungia neribotą laiką.

  • installed – Grąžina, ar jutiklinis šviesos diodas prijungtas prie smegenų.

Prieš iškviečiant bet kokias touchled narių funkcijas, reikia sukurti touchled egzempliorių, kaip parodyta žemiau:

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

Grąžina, jei šiuo metu paspaustas „TouchLED“.

Available Functions 
bool pressing();
Parameters

Ši funkcija nepriima jokių parametrų.

Return Values

Grąžina bool nurodantį, ar paspaudžiamas jutiklinis šviesos diodas.

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

setColor#

Nustato jutiklinio LED jutiklio LED šviesą įjungti konkrečia spalva.

Available Functions

1 — Jutiklinio LED spalva nustatoma naudojant vex::color.

void setColor( 
  vex::color  color );

2 — Nustato LED spalvas naudodamas colorType.

void setColor( 
  colorType   color );
Parameters

Parametras

Tipas

Aprašymas

color

colorType

Galiojanti spalva:

  • 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

Galiojanti pasirinktinė spalva.
Return Values

Ši funkcija negrąžina reikšmės.

setFade#

Nustato jutiklinio LED jutiklio išblukimo nustatymą. Jutiklinis LED jutiklis pakeis spalvas pagal išblukimo tipą.

Available Functions 
void setFade(
  fadeType  speed );
Parameters

Parametras

Tipas

Aprašymas

speed

fadeType

Bus nustatytas išblukimo greitis:

  • fast
  • off — be išblukimo
  • slow
Return Values

Ši funkcija negrąžina reikšmės.

setBrightness#

Nustato jutiklinio LED ryškumą.

Available Functions 
void setBrightness(
  uint32_t  value );
Parameters

Parametras

Tipas

Aprašymas

value

uint32_t

Jutiklinio LED ryškumas, kurį reikia nustatyti procentais.
Return Values

Ši funkcija negrąžina reikšmės.

pressed#

Registruoja funkciją, kuri bus iškviečiama paspaudus jutiklinį šviesos diodą.

Available Functions 
void pressed( void (* callback)(void) );
Parameters

Parametras

Tipas

Aprašymas

callback

void (*)(void)

Rodyklė į funkciją, kuri bus iškviečiama paspaudus jutiklinį šviesos diodą. Funkcija negali priimti parametrų ir grąžinti negaliojančią reikšmę.
Return Values

Ši funkcija negrąžina reikšmės.

Examples

Apibrėžkite grįžtamojo ryšio funkciją (už int main())

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

Registruokite atgalinį iškvietimą int main() viduje

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#

Registruoja funkciją, kuri bus iškviesta atleidus jutiklinį šviesos diodą.

Available Functions 
void released( void (* callback)(void) );
Parameters

Parametras

Tipas

Aprašymas

callback

void (*)(void)

Rodyklė į funkciją, kuri bus iškviečiama atleidus jutiklinį šviesos diodą. Funkcija negali priimti parametrų ir grąžinti negaliojančią reikšmę.
Return Values

Ši funkcija negrąžina reikšmės.

Examples

Apibrėžkite grįžtamojo ryšio funkciją (už int main())

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

Registruokite atgalinį iškvietimą int main() viduje

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#

Įjungia „TouchLED Sensor“ šviesos diodą, naudodamas spalvas ir nustatytą ryškumą.

Available Functions

1 — Nustato šviesos diodo spalvą naudodamas vex::color.

void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — Nustato LED spalvą naudojant atspalvį.

void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 — Nustato LED spalvą pagal RGB reikšmes.

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

Parametras

Tipas

Aprašymas

color

vex::color

Galiojanti spalva:

  • 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

Pasirinktinai. Šviesos diodo ryškumas procentais, pagal numatytuosius nustatymus – 100.

hue

uint32_t

Šviesos diodo atspalvis. Tai taip pat galima pateikti kaip šešioliktainę reikšmę (0x000000).

red

uint8_t

Sveikasis skaičius, rodantis šviesos diodo raudoną reikšmę.

green

uint8_t

Sveikasis skaičius, rodantis šviesos diodo žaliąją reikšmę.

blue

uint8_t

Sveikasis skaičius, rodantis šviesos diodo mėlynąją vertę.
Return Values

Ši funkcija negrąžina reikšmės.

off#

Išjungia jutiklinį LED indikatorių.

Available Functions 
void off( void );
Parameters

Ši funkcija nepriima jokių parametrų.

Return Values

Ši funkcija negrąžina reikšmės.

installed#

Grąžina, ar prijungtas jutiklinis šviesos diodas.

Available Functions 
bool installed();
Parameters

Ši funkcija nepriima jokių parametrų.

Return Values

Grąžina loginę reikšmę, nurodančią, ar prijungtas jutiklinis šviesos diodas:

  • true — The sensor is connected and responding.
  • false — The sensor is not connected or not detected.
On this page