Pek-LED#

Introduktion #

VEX IQ Touch LED är både en lampa och en knapp. Den kan lysa i olika färger för att ge feedback, till exempel signalera att roboten är redo, visa vilket läge som är valt eller matcha en färg som detekteras av en annan sensor, och den kan känna av när den berörs, vilket låter dig starta eller ändra en robots beteende med ett tryck.

Klasskonstruktor #

touchled( 
  int32_t index );

Klassförstörare #

Förstör det touchled objektet och frigör tillhörande resurser.

virtual ~touchled();

Parametrar #

Parameter	Typ	Beskrivning
`index`	`int32_t`	Den smarta porten som Touch-LED:n är ansluten till, skriven som `PORTx`, där `x` är portnumret (till exempel `PORT1`).

Exempel #

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

Medlemsfunktioner #

Klassen touchled innehåller följande medlemsfunktioner:

pressing – Returnerar om pekskärms-LED:n trycks ned.
setColor – Ställer in färgen på pekskärmens LED-lampa.
setFade – Anger hur snabbt färger ska tona över till varandra.
setBrightness – Ställer in ljusstyrkan för pekskärmens LED.
pressed – Registrerar en funktion som ska anropas när pekskärms-LED:n trycks ned.
released – Registrerar en funktion som ska anropas när pekskärmslampan släpps.
on – Tänder pekskärms-LED:n.
off – Stänger av pekskärmens LED-lampa.
setBlink – Växla mellan att tända och släcka pekskärmens lysdiod i oändlighet.
installed – Returnerar om Touch-LED:n är ansluten till hjärnan.

Innan några touchled medlemsfunktioner anropas måste en touchled instans skapas, som visas nedan:

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

Returnerar om TouchLED-lampan trycks ned för närvarande.

Available Functions

bool pressing();

Parameters

Den här funktionen accepterar inga parametrar.

Return Values

Returnerar värdet bool som anger om pek-LED-lampan trycks ned.

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

setColor #

Ställer in LED-lampan på touch-LED-sensorn på en specifik färg.

Available Functions

1 — Ställer in pek-LED:n till en färg med hjälp av vex::color.
void setColor( 
  vex::color  color );

2 — Ställer in LED-färger med en colorType.
void setColor( 
  colorType   color );

Parameters

Parameter

Typ

Beskrivning

color

colorType

En giltig färg:

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

En giltig anpassad färg.

Return Values

Den här funktionen returnerar inget värde.

setFade #

Ställer in toningsinställningen för Touch-LED-sensorn. Touch-LED-sensorn ändrar färg till nya färger med hjälp av toningstypen.

Available Functions

void setFade(
  fadeType  speed );

Parameters

Parameter	Typ	Beskrivning
`speed`	`fadeType`	Hastigheten som toningen ställs in på: `fast` `off` — ingen toning `slow`

Parameter

Typ

Beskrivning

speed

fadeType

Hastigheten som toningen ställs in på:

fast
off — ingen toning
slow

Return Values

Den här funktionen returnerar inget värde.

setBrightness #

Ställer in ljusstyrkan för touch-LED:n.

Available Functions

void setBrightness(
  uint32_t  value );

Parameters

Parameter	Typ	Beskrivning
`value`	`uint32_t`	Ljusstyrkan för touch-LED:n ska ställas in som en procentandel.

Return Values

Den här funktionen returnerar inget värde.

pressed #

Registrerar en funktion som ska anropas när pekskärms-LED:n trycks ned.

Available Functions

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

Parameters

Parameter	Typ	Beskrivning
`callback`	`void (*)(void)`	En pekare till en funktion som anropas när Touch-LED trycks ned. Funktionen får inte ta emot några parametrar och returnerar void.

Return Values

Den här funktionen returnerar inget värde.

Examples

Definiera callback-funktionen (utanför int main())

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

Registrera återuppringningen inuti 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 #

Registrerar en funktion som ska anropas när pek-LED:n släpps.

Available Functions

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

Parameters

Parameter	Typ	Beskrivning
`callback`	`void (*)(void)`	En pekare till en funktion som anropas när pekskärmens lysdiod släpps. Funktionen får inte ta emot några parametrar och returnera void.

Return Values

Den här funktionen returnerar inget värde.

Examples

Definiera callback-funktionen (utanför int main())

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

Registrera återuppringningen inuti 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 #

Slår på LED-lampan på TouchLED-sensorn med hjälp av färger och en inställd ljusstyrka.

Available Functions

1 — Ställer in lysdioden till en färg med vex::color.
void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — Ställer in LED-färg med hjälp av nyans.
void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 — Ställer in LED-färg efter RGB-värden.

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

Parameters

Parameter	Typ	Beskrivning
`color`	`vex::color`	En giltig färg: `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`	Valfritt. Ljusstyrkan som LED-lampan ska ställas in på i procent, standardinställningen är 100.
`hue`	`uint32_t`	Lysdiodens nyans. Detta kan också representeras som ett hexagonalt värde (0x000000).
`red`	`uint8_t`	Ett heltal som representerar lysdiodens röda värde.
`green`	`uint8_t`	Ett heltal som representerar lysdiodens gröna värde.
`blue`	`uint8_t`	Ett heltal som representerar lysdiodens blå värde.

Return Values

Den här funktionen returnerar inget värde.

off #

Stänger av pekskärms-LED:n.

Available Functions

void off( void );

Parameters

Den här funktionen tar inga parametrar.

Return Values

Den här funktionen returnerar inget värde.

setBlink #

Blinkar upprepade gånger på- och av-lampan.

Available Functions

1 — Ställer in blinkfärgen med hjälp av en vex::color.
void setBlink( 
  vex::color    color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

2 — Ställer in blinkfärgen med ett hexagonalt färgvärde.
void setBlink( 
  uint32_t      hue, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

3 — Ställer in blinkfärgen med hjälp av colorType.
void setBlink( 
  colorType     color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

Parameters

Parameter	Typ	Beskrivning
`color`	`colorType`	En giltig färg: `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`	Valfritt. Varaktigheten i sekunder som lysdioden ska vara tänd per blinkcykel, standardinställningen är 0,25 sekunder.
`offTime`	`double`	Valfritt. Varaktigheten i sekunder som lysdioden är släckt per blinkcykel, standardinställningen är 0,25 sekunder.
`hue`	`uint32_t`	Lysdiodens nyans. Detta kan också representeras av ett hexkodvärde.
`color`	`vex::color`	En giltig anpassad färg.

Return Values

Den här funktionen returnerar inget värde.

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 #

Returnerar om Touch-LED:n är ansluten.

Available Functions

bool installed();

Parameters

Den här funktionen tar inga parametrar.

Return Values

Returnerar ett booleskt värde som anger om Touch-LED:n är ansluten:

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