Kosketus-LED#

Johdanto#

VEX IQ Touch -LED on sekä valo että painike. Se voi hehkua eri väreillä antaakseen palautetta, esimerkiksi robotin valmiuden osoittamiseksi, valitun tilan näyttämiseksi tai toisen anturin havaitseman värin mukaiseksi. Se voi myös havaita kosketuksen, jolloin voit käynnistää robotin toiminnan tai muuttaa sitä napauttamalla.

Luokan rakentaja#

touchled( 
  int32_t index );

Luokan tuhoaja#

Tuhoaa touchled -objektin ja vapauttaa siihen liittyvät resurssit.

virtual ~touchled();

Parametrit#

Parametri

Tyyppi

Kuvaus

index

int32_t

Kosketus-LEDin kytkennällä varustettu älyportti, joka kirjoitetaan muodossa PORTx, jossa x on portin numero (esimerkiksi PORT1).

Esimerkki#

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

Jäsenten toiminnot#

touchled -luokka sisältää seuraavat jäsenfunktiot:

  • pressing – Palauttaa tiedon siitä, painetaanko kosketus-LEDiä.

  • setColor – Asettaa kosketus-LEDin värin.

  • setFade – Määrittää, kuinka nopeasti värit haalistuvat toisiinsa nähden.

  • setBrightness – Asettaa kosketusnäytön LED-valon kirkkautta.

  • pressed – Rekisteröi toiminnon, joka kutsutaan, kun kosketus-LEDiä painetaan.

  • released – Rekisteröi funktion, joka kutsutaan, kun kosketus-LED vapautetaan.

  • on – Sytyttää kosketus-LEDin.

  • off – Sammuttaa kosketus-LEDin.

  • setBlink – Kosketus-LED-valo syttyy ja sammuu vuorotellen loputtomiin.

  • installed – Palauttaa, onko kosketus-LED kytketty aivoihin.

Ennen minkään touchled -jäsenfunktion kutsumista on luotava touchled -instanssi alla olevan mukaisesti:

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

Palauttaa, jos TouchLED-painiketta painetaan parhaillaan.

Available Functions 
bool pressing();
Parameters

Tämä funktio ei hyväksy parametreja.

Return Values

Palauttaa arvon bool , joka ilmaisee, painetaanko kosketus-LEDiä.

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

setColor#

Asettaa kosketus-LED-anturin LED-valon tiettyyn väriin.

Available Functions

1 — Asettaa kosketus-LEDin väriin, joka käyttää arvoa vex::color.

void setColor( 
  vex::color  color );

2 — Asettaa LED-värit käyttämällä värityyppiä colorType.

void setColor( 
  colorType   color );
Parameters

Parametri

Tyyppi

Kuvaus

color

colorType

Kelvollinen väri:

  • 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

Kelvollinen mukautettu väri.
Return Values

Tämä funktio ei palauta arvoa.

setFade#

Asettaa kosketus-LED-anturin häivytysasetuksen. Kosketus-LED-anturi vaihtaa värejä häivytystyypin mukaisesti.

Available Functions 
void setFade(
  fadeType  speed );
Parameters

Parametri

Tyyppi

Kuvaus

speed

fadeType

Häivytyksen nopeus asetetaan seuraavaksi:

  • fast
  • off — ei häivytystä
  • slow
Return Values

Tämä funktio ei palauta arvoa.

setBrightness#

Asettaa kosketus-LEDin kirkkautta.

Available Functions 
void setBrightness(
  uint32_t  value );
Parameters

Parametri

Tyyppi

Kuvaus

value

uint32_t

Kosketus-LEDin kirkkaus prosentteina.
Return Values

Tämä funktio ei palauta arvoa.

pressed#

Rekisteröi toiminnon, joka kutsutaan, kun kosketus-LEDiä painetaan.

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

Parametri

Tyyppi

Kuvaus

callback

void (*)(void)

Osoitin funktioon, jota kutsutaan, kun kosketus-LEDiä painetaan. Funktiolla ei saa olla parametreja, ja sen on palautettava tyhjä arvo.
Return Values

Tämä funktio ei palauta arvoa.

Examples

Määrittele takaisinkutsufunktio ( int main())

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

Rekisteröi takaisinkutsu 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#

Rekisteröi funktion, joka kutsutaan, kun kosketus-LED vapautetaan.

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

Parametri

Tyyppi

Kuvaus

callback

void (*)(void)

Osoitin funktioon, jota kutsutaan, kun Touch-LED vapautetaan. Funktiolla ei saa olla parametreja, ja sen on palautettava tyhjä arvo.
Return Values

Tämä funktio ei palauta arvoa.

Examples

Määrittele takaisinkutsufunktio ( int main())

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

Rekisteröi takaisinkutsu 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#

Sytyttää TouchLED-anturin LED-valon käyttämällä värejä ja asetettua kirkkautta.

Available Functions

1 — Asettaa LEDin värin käyttämällä vex::color-muuttujaa.

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

2 — Asettaa LED-värin sävyn avulla.

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

3 — Asettaa LED-värin RGB-arvojen mukaan.

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

Parametri

Tyyppi

Kuvaus

color

vex::color

Kelvollinen väri:

  • 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

Valinnainen. LEDin kirkkaus prosentteina, oletusarvo on 100.

hue

uint32_t

LEDin sävy. Tämä voidaan esittää myös heksakoodiarvona (0x000000).

red

uint8_t

Kokonaisluku, joka edustaa LEDin punaista arvoa.

green

uint8_t

Kokonaisluku, joka edustaa LEDin vihreää arvoa.

blue

uint8_t

Kokonaisluku, joka edustaa LEDin sinistä arvoa.
Return Values

Tämä funktio ei palauta arvoa.

off#

Sammuttaa kosketus-LEDin.

Available Functions 
void off( void );
Parameters

Tämä funktio ei ota vastaan ​​parametreja.

Return Values

Tämä funktio ei palauta arvoa.

installed#

Palauttaa, onko kosketus-LED kytketty.

Available Functions 
bool installed();
Parameters

Tämä funktio ei ota vastaan ​​parametreja.

Return Values

Palauttaa totuusarvon, joka ilmaisee, onko kosketus-LED kytkettynä:

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