LED Sentuh#

Perkenalan #

VEX IQ Touch LED berfungsi sebagai lampu dan tombol. LED ini dapat menyala dalam berbagai warna untuk memberikan umpan balik, seperti menandakan bahwa robot siap, menunjukkan mode yang dipilih, atau mencocokkan warna yang terdeteksi oleh sensor lain, dan dapat mendeteksi saat disentuh, memungkinkan Anda untuk memulai atau mengubah perilaku robot hanya dengan satu sentuhan.

Konstruktor Kelas #

touchled( 
  int32_t index );

Destruktor Kelas #

Menghancurkan objek touchled disentuh dan melepaskan sumber daya terkait.

virtual ~touchled();

Parameter #

Parameter	Jenis	Keterangan
`index`	`int32_t`	Port Pintar yang terhubung ke LED Sentuh, ditulis sebagai `PORTx`, di mana `x` adalah nomor port (misalnya, `PORT1`).

Contoh #

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

Fungsi Keanggotaan #

Kelas touchled mencakup fungsi anggota berikut:

pressing – Mengembalikan apakah LED Sentuh sedang ditekan.
setColor – Mengatur warna LED Sentuh.
setFade – Mengatur seberapa cepat warna akan memudar satu sama lain.
setBrightness – Mengatur kecerahan LED Sentuh.
pressed – Mendaftarkan fungsi yang akan dipanggil ketika LED Sentuh ditekan.
released – Mendaftarkan fungsi yang akan dipanggil ketika LED Sentuh dilepaskan.
on – Menyalakan LED Sentuh.
off – Mematikan LED Sentuh.
setBlink – Menghidupkan dan mematikan LED Sentuh secara bergantian tanpa batas.
installed – Mengembalikan apakah LED Sentuh terhubung ke Otak.

Sebelum memanggil fungsi anggota touchled apa pun, sebuah instance touchled harus dibuat, seperti yang ditunjukkan di bawah ini:

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

Mengembalikan nilai yang menunjukkan apakah TouchLED sedang ditekan.

Available Functions

bool pressing();

Parameters

Fungsi ini tidak menerima parameter apa pun.

Return Values

Mengembalikan nilai boolean bool yang menunjukkan apakah LED Sentuh sedang ditekan.

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

setColor #

Mengatur LED pada Sensor Sentuh LED ke warna tertentu.

Available Functions

1 — Mengatur LED Sentuh ke warna menggunakan vex::color.
void setColor( 
  vex::color  color );

2 — Mengatur warna LED menggunakan tipe warna colorType.
void setColor( 
  colorType   color );

Parameters

Parameter

Jenis

Keterangan

color

colorType

A valid color:

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

Fungsi ini tidak mengembalikan nilai.

setFade #

Mengatur pengaturan efek pudar pada Sensor LED Sentuh. Sensor LED Sentuh akan berubah ke warna baru menggunakan tipe efek pudar.

Available Functions

void setFade(
  fadeType  speed );

Parameters

Parameter	Jenis	Keterangan
`speed`	`fadeType`	Kecepatan efek pudar akan diatur ke: `fast` `off` — tanpa efek pudar `slow`

Parameter

Jenis

Keterangan

speed

fadeType

Kecepatan efek pudar akan diatur ke:

fast
off — tanpa efek pudar
slow

Return Values

Fungsi ini tidak mengembalikan nilai.

setBrightness #

Mengatur kecerahan LED Sentuh.

Available Functions

void setBrightness(
  uint32_t  value );

Parameters

Parameter	Jenis	Keterangan
`value`	`uint32_t`	Kecerahan LED Sentuh diatur dalam persentase.

Return Values

Fungsi ini tidak mengembalikan nilai.

pressed #

Mendaftarkan fungsi yang akan dipanggil saat LED Sentuh ditekan.

Available Functions

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

Parameters

Parameter	Jenis	Keterangan
`callback`	`void (*)(void)`	Pointer ke sebuah fungsi yang akan dipanggil ketika LED Sentuh ditekan. Fungsi tersebut tidak boleh menerima parameter dan harus mengembalikan nilai void.

Return Values

Fungsi ini tidak mengembalikan nilai.

Examples

Definisikan fungsi callback (di luar int main())

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

Daftarkan fungsi callback di dalam 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 #

Mendaftarkan fungsi yang akan dipanggil saat LED Sentuh dilepas.

Available Functions

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

Parameters

Parameter	Jenis	Keterangan
`callback`	`void (*)(void)`	Pointer ke sebuah fungsi yang akan dipanggil ketika LED Sentuh dilepas. Fungsi tersebut tidak boleh menerima parameter dan harus mengembalikan nilai void.

Return Values

Fungsi ini tidak mengembalikan nilai.

Examples

Definisikan fungsi callback (di luar int main())

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

Daftarkan fungsi callback di dalam 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 #

Menyalakan LED pada Sensor TouchLED menggunakan warna dan tingkat kecerahan yang telah ditentukan.

Available Functions

1 — Mengatur warna LED menggunakan vex::color.
void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — Mengatur warna LED menggunakan hue.
void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 Mengatur warna LED berdasarkan nilai RGB.

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

Parameters

Parameter	Jenis	Keterangan
`color`	`vex::color`	A valid color: `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`	Opsional. Tingkat kecerahan LED yang akan diatur dalam persen, defaultnya adalah 100.
`hue`	`uint32_t`	Warna LED. Ini juga dapat direpresentasikan sebagai nilai Hexcode (0x000000).
`red`	`uint8_t`	Bilangan bulat yang mewakili nilai merah LED.
`green`	`uint8_t`	Bilangan bulat yang mewakili nilai hijau LED.
`blue`	`uint8_t`	Bilangan bulat yang mewakili nilai biru LED.

Return Values

Fungsi ini tidak mengembalikan nilai.

off #

Mematikan LED sentuh.

Available Functions

void off( void );

Parameters

Fungsi ini tidak memerlukan parameter apa pun.

Return Values

Fungsi ini tidak mengembalikan nilai.

setBlink #

LED sentuh berkedip berulang kali dengan pola menyala dan mati.

Available Functions

1 — Mengatur warna kedipan menggunakan vex::color.
void setBlink( 
  vex::color    color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

2 — Mengatur warna kedipan menggunakan nilai warna heksadesimal.
void setBlink( 
  uint32_t      hue, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

3 — Mengatur warna kedipan menggunakan colorType .
void setBlink( 
  colorType     color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

Parameters

Parameter	Jenis	Keterangan
`color`	`colorType`	A valid color: `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`	Opsional. Durasi dalam detik LED akan menyala per siklus kedipan, secara default 0,25 detik.
`offTime`	`double`	Opsional. Durasi dalam detik LED akan mati per siklus kedipan, secara default 0,25 detik.
`hue`	`uint32_t`	Nilai warna heksadesimal (misalnya, `0xFF0000` untuk warna merah).
`color`	`vex::color`	A valid custom color.

Return Values

Fungsi ini tidak mengembalikan nilai.

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 #

Mengembalikan status apakah LED Sentuh terhubung.

Available Functions

bool installed();

Parameters

Fungsi ini tidak memerlukan parameter apa pun.

Return Values

Mengembalikan nilai Boolean yang menunjukkan apakah LED Sentuh terhubung atau tidak:

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