LED tadhaill#

Réamhrá #

Is solas agus cnaipe araon é an VEX IQ Touch LED. Is féidir leis lonrú i ndathanna difriúla chun aiseolas a thabhairt, amhail comhartha a thabhairt go bhfuil an róbat réidh, a thaispeáint cén modh atá roghnaithe, nó dath a mheaitseáil a bhraitear ag braiteoir eile, agus is féidir leis a bhrath cathain atá teagmháil á dhéanamh leis, rud a ligeann duit iompar róbait a thosú nó a athrú le sconna.

Tógálaí Ranga #

touchled( 
  int32_t index );

Scriostóir Ranga #

Destroys the touchled object and releases associated resources.

virtual ~touchled();

Paraiméadair #

Paraiméadar	Cineál	Cur síos
`index`	`int32_t`	An Port Cliste a bhfuil an Soilse Tadhaill LED ceangailte leis, scríofa mar `PORTx`, áit a seasann `x` don uimhir phoirt (mar shampla, `PORT1`).

Sampla #

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

Feidhmeanna na mBall #

Áirítear leis an rang touchled na feidhmeanna ball seo a leanas:

pressing – Tugann sé seo le fios an bhfuil an soilse tadhaill á bhrú.
setColor – Socraíonn sé dath an LED Tadhaill.
setFade – Socraíonn sé cé chomh tapa agus a imeoidh dathanna óna chéile.
setBrightness – Socraíonn sé gile an LED Tadhaill.
pressed – Cláraíonn sé feidhm le glaoch uirthi nuair a bhrúitear an LED Tadhaill.
released – Cláraíonn sé feidhm le glaoch uirthi nuair a scaoiltear an LED Tadhaill.
on – Casann sé an soilse tadhaill LED air.
off – Múchann sé an soilse tadhaill LED.
setBlink – Malartaigh an LED Tadhaill ar siúl agus as go ceann tréimhse éiginnte.
installed – Tugann sé seo le fios an bhfuil an Touch LED ceangailte leis an Inchinn.

Sula nglaotar ar aon fheidhmeanna touchled ball, ní mór sampla touchled a chruthú, mar a thaispeántar thíos:

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

Tuairisceán má tá an TouchLED á bhrú faoi láthair.

Available Functions

bool pressing();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Tugann sé bool ar ais a léiríonn an bhfuil an LED Tadhaill á bhrú.

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

setColor #

Socraíonn sé dath sonrach ar LED an Braiteora Tadhaill LED.

Available Functions

1 — Socraíonn sé dath an LED Tadhaill ag baint úsáide as vex::color.
void setColor( 
  vex::color  color );

2 — Socraíonn sé dathanna na soilse LED ag baint úsáide as CineálDath colorType.
void setColor( 
  colorType   color );

Parameters

Paraiméadar

Cineál

Cur síos

color

colorType

Dath bailí:

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

A valid custom color.

Return Values

Ní thugann an fheidhm seo luach ar ais.

setFade #

Socraíonn sé an socrú céimnithe don Braiteoir LED Tadhaill. Athróidh an Braiteoir LED Tadhaill go dathanna nua ag baint úsáide as an gcineál céimnithe.

Available Functions

void setFade(
  fadeType  speed );

Parameters

Paraiméadar	Cineál	Cur síos
`speed`	`fadeType`	Socrófar an luas céimnithe chuig: `fast` `off` — gan céimniú `slow`

Paraiméadar

Cineál

Cur síos

speed

fadeType

Socrófar an luas céimnithe chuig:

fast
off — gan céimniú
slow

Return Values

Ní thugann an fheidhm seo luach ar ais.

setBrightness #

Socraíonn sé gile an Tadhaill LED.

Available Functions

void setBrightness(
  uint32_t  value );

Parameters

Paraiméadar	Cineál	Cur síos
`value`	`uint32_t`	Gile an LED Tadhaill le socrú mar chéatadán.

Return Values

Ní thugann an fheidhm seo luach ar ais.

pressed #

Cláraíonn sé feidhm le glaoch uirthi nuair a bhrúitear an LED Tadhaill.

Available Functions

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

Parameters

Paraiméadar	Cineál	Cur síos
`callback`	`void (*)(void)`	Pointeoir chuig feidhm a ghlaofar nuair a bhrúitear an LED Tadhaill. Ní mór don fheidhm aon pharaiméadair a ghlacadh agus folamh a thabhairt ar ais.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Examples

Sainmhínigh an fheidhm athghlaoite (lasmuigh de int main())

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

Cláraigh an glao ar ais taobh istigh de 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 #

Cláraíonn sé feidhm le glaoch uirthi nuair a scaoiltear an LED Tadhaill.

Available Functions

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

Parameters

Paraiméadar	Cineál	Cur síos
`callback`	`void (*)(void)`	Pointeoir chuig feidhm a ghlaofar nuair a scaoiltear an LED Tadhaill. Ní mór don fheidhm aon pharaiméadair a ghlacadh agus folamh a thabhairt ar ais.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Examples

Sainmhínigh an fheidhm athghlaoite (lasmuigh de int main())

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

Cláraigh an glao ar ais taobh istigh de 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 #

Casann sé LED an Braiteora TouchLED air ag baint úsáide as dathanna agus gile socraithe.

Available Functions

1 — Socraíonn sé dath an LED ag baint úsáide as vex::color.
void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — Socraíonn sé dath an LED ag úsáid an datha.
void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 — Socraíonn sé dath an LED de réir luachanna rgb.
void on( 
  uint8_t   red, 
  uint8_t   green, 
  uint8_t   blue, 
  uint32_t  brightness = 100);

Parameters

Paraiméadar	Cineál	Cur síos
`color`	`vex::color`	Dath bailí: `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`	Roghnach. An gile ag a socrófar an LED i gcéatadán, ag socrú go 100 mar réamhshocrú.
`hue`	`uint32_t`	Dath an LED. Is féidir é seo a léiriú mar luach Heicseadáin (0x000000) freisin.
`red`	`uint8_t`	Slánuimhir a léiríonn luach dearg an LED.
`green`	`uint8_t`	Slánuimhir a léiríonn luach glas an LED.
`blue`	`uint8_t`	Slánuimhir a léiríonn luach gorm an LED.

Return Values

Ní thugann an fheidhm seo luach ar ais.

off #

Múchann sé an LED Tadhaill.

Available Functions

void off( void );

Parameters

Ní ghlacann an fheidhm seo aon pharaiméadair.

Return Values

Ní thugann an fheidhm seo luach ar ais.

setBlink #

Lascann an LED tadhaill arís agus arís eile i bpatrún air agus as.

Available Functions

1 — Socraíonn sé dath an bhleithne ag baint úsáide as vex::color.
void setBlink( 
  vex::color    color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

2 — Socraíonn sé dath an bhleisce ag baint úsáide as luach datha heicsidheachúlach.
void setBlink( 
  uint32_t      hue, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

3 — Sets the blink color using a colorType.

void setBlink( 
  colorType     color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

Parameters

Paraiméadar	Cineál	Cur síos
`color`	`colorType`	Dath bailí: `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`	Roghnach. An fad ama i soicindí a bheidh an LED ar siúl in aghaidh gach timthriall splancadh, agus an réamhshocrú á chur ar 0.25 soicind.
`offTime`	`double`	Roghnach. An fad ama i soicindí a bheidh an LED múchta in aghaidh gach timthriall splancadh, agus an réamhshocrú 0.25 soicind.
`hue`	`uint32_t`	Luach datha heicsidheachúlach (m.sh., `0xFF0000` le haghaidh dearg).
`color`	`vex::color`	A valid custom color.

Return Values

Ní thugann an fheidhm seo luach ar ais.

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 #

Tugann sé seo ar ais an bhfuil an LED Tadhaill ceangailte.

Available Functions

bool installed();

Parameters

Ní ghlacann an fheidhm seo aon pharaiméadair.

Return Values

Tugann sé seo luach Boolean ar ais a léiríonn an bhfuil an LED Tadhaill ceangailte:

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