Érintőképernyős LED#

Bevezetés #

A VEX IQ Touch LED egyben lámpa és gomb is. Különböző színekben világíthat, hogy visszajelzést adjon, például jelezve, hogy a robot készen áll, mutatva a kiválasztott módot, vagy egy másik érzékelő által érzékelt színnel megegyező színt adva, és képes érzékelni, ha megérintik, így egyetlen koppintással elindíthatja vagy módosíthatja a robot viselkedését.

Osztálykonstruktor #

touchled( 
  int32_t index );

Osztálydestruktor #

Megsemmisíti a touchled objektumot és felszabadítja a hozzá tartozó erőforrásokat.

virtual ~touchled();

Paraméterek #

Paraméter	Típus	Leírás
`index`	`int32_t`	Az érintőképernyős LED-hez csatlakoztatott intelligens port, amelyet `PORTx`alakban írunk le, ahol `x` a port száma (például `PORT1`).

Példa #

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

Tagfüggvények #

A touchled osztály a következő tagfüggvényeket tartalmazza:

pressing – Visszaadja, hogy az érintő LED meg van-e nyomva.
setColor – Beállítja az érintőképernyős LED színét.
setFade – Beállítja, hogy a színek milyen gyorsan halványuljanak el egymáshoz képest.
setBrightness – Beállítja az érintőképernyős LED fényerejét.
pressed – Regisztrál egy függvényt, amely az érintő LED megnyomásakor hívódik meg.
released – Regisztrál egy függvényt, amely akkor hívódik meg, amikor az érintőképernyős LED elengedésre kerül.
onen – Bekapcsolja az érintőképernyős LED-et.
off – Kikapcsolja az érintőképernyős LED-et.
setBlink – Az érintőképernyős LED felváltva, határozatlan ideig be- és kikapcsol.
installed – Visszaadja, hogy az érintő LED csatlakoztatva van-e az agyhoz.

Bármely touchled tagfüggvény meghívása előtt létre kell hozni egy touchled példányt, az alábbiak szerint:

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

Visszaadja, ha a TouchLED jelenleg le van nyomva.

Available Functions

bool pressing();

Parameters

Ez a függvény nem fogad el paramétereket.

Return Values

bool értéket ad vissza, amely jelzi, hogy a Touch LED meg van-e nyomva.

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

setColor #

Beállítja az érintőképernyős LED-érzékelő LED-jét egy adott színre.

Available Functions

1 — Beállítja az érintőképernyős LED színét a vex::color értékkel.
void setColor( 
  vex::color  color );

2 — Beállítja a LED színeit egy colorType használatával.
void setColor( 
  colorType   color );

Parameters

Paraméter

Típus

Leírás

color

colorType

Érvényes szín:

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

Érvényes egyéni szín.

Return Values

Ez a függvény nem ad vissza értéket.

setFade #

Beállítja az érintő LED-érzékelő elhalványulási beállítását. Az érintő LED-érzékelő az elhalványulási típusnak megfelelően új színekre vált.

Available Functions

void setFade(
  fadeType  speed );

Parameters

Paraméter	Típus	Leírás
`speed`	`fadeType`	Az átmenet sebessége a következőre lesz beállítva: `fast` `off` — nincs átmenet `slow`

Paraméter

Típus

Leírás

speed

fadeType

Az átmenet sebessége a következőre lesz beállítva:

fast
off — nincs átmenet
slow

Return Values

Ez a függvény nem ad vissza értéket.

setBrightness #

Beállítja az érintőképernyős LED fényerejét.

Available Functions

void setBrightness(
  uint32_t  value );

Parameters

Paraméter	Típus	Leírás
`value`	`uint32_t`	Az érintőképernyős LED fényerejének százalékos beállítása.

Return Values

Ez a függvény nem ad vissza értéket.

pressed #

Regisztrál egy függvényt, amely a Touch LED megnyomásakor hívódik meg.

Available Functions

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

Parameters

Paraméter	Típus	Leírás
`callback`	`void (*)(void)`	Egy mutató egy függvényre, amely a Touch LED megnyomásakor hívódik meg. A függvény nem vehet fel paramétereket és void értéket ad vissza.

Return Values

Ez a függvény nem ad vissza értéket.

Examples

Definiáljuk a visszahívó függvényt ( int main())

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

Regisztrálja a visszahívást a int main() függvényen belül.

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 #

Regisztrál egy függvényt, amely akkor hívódik meg, amikor az érintőgombos LED elengedésre kerül.

Available Functions

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

Parameters

Paraméter	Típus	Leírás
`callback`	`void (*)(void)`	Egy olyan függvényre mutató mutató, amely a Touch LED elengedésekor hívódik meg. A függvény nem vehet fel paramétereket, és void értéket ad vissza.

Return Values

Ez a függvény nem ad vissza értéket.

Examples

Definiáljuk a visszahívó függvényt ( int main())

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

Regisztrálja a visszahívást a int main() függvényen belül.

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 #

Bekapcsolja a TouchLED érzékelő LED-jét a beállított színek és fényerő használatával.

Available Functions

1 — A vex::color használatával beállítja a LED színét.
void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — A LED színét állítja be árnyalat használatával.
void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 — RGB-értékek alapján állítja be a LED színét.
void on( 
  uint8_t   red, 
  uint8_t   green, 
  uint8_t   blue, 
  uint32_t  brightness = 100);

Parameters

Paraméter	Típus	Leírás
`color`	`vex::color`	Érvényes szín: `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`	Opcionális. A LED fényerejének beállítása százalékban, alapértelmezés szerint 100.
`hue`	`uint32_t`	A LED színárnyalata. Ez hexadecimális értékként is megadható (0x000000).
`red`	`uint8_t`	Egy egész szám, amely a LED piros színének értékét jelöli.
`green`	`uint8_t`	Egy egész szám, amely a LED zöld színét jelöli.
`blue`	`uint8_t`	Egy egész szám, amely a LED kék színét jelöli.

Return Values

Ez a függvény nem ad vissza értéket.

off #

Kikapcsolja az érintőképernyős LED-et.

Available Functions

void off( void );

Parameters

Ez a függvény nem fogad el paramétereket.

Return Values

Ez a függvény nem ad vissza értéket.

setBlink #

Az érintőképernyős LED ismételten villog, be- és kikapcsolási mintázatban.

Available Functions

1 — Beállítja a villogás színét egy vex::color használatával.
void setBlink( 
  vex::color    color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

2 — Beállítja a villogás színét egy hexadecimális színértékkel.
void setBlink( 
  uint32_t      hue, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

3 — Beállítja a villogás színét egy colorType értékkel.
void setBlink( 
  colorType     color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

Parameters

Paraméter	Típus	Leírás
`color`	`colorType`	Érvényes szín: `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`	Opcionális. A LED villogási ciklusonkénti bekapcsolt állapotának időtartama másodpercben, alapértelmezés szerint 0,25 másodperc.
`offTime`	`double`	Opcionális. A LED kikapcsolt állapotának időtartama villogási ciklusonként másodpercben, alapértelmezés szerint 0,25 másodperc.
`hue`	`uint32_t`	Hexadecimális színérték (pl. `0xFF0000` a piros esetén).
`color`	`vex::color`	Érvényes egyéni szín.

Return Values

Ez a függvény nem ad vissza értéket.

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 #

Visszaadja, hogy az érintőképernyős LED csatlakoztatva van-e.

Available Functions

bool installed();

Parameters

Ez a függvény nem fogad el paramétereket.

Return Values

Egy logikai értéket ad vissza, amely jelzi, hogy az érintőképernyős LED csatlakoztatva van-e:

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