จอ LED ระบบสัมผัส#

การแนะนำ #

ไฟ LED แบบสัมผัส VEX IQ ทำหน้าที่ทั้งเป็นไฟและปุ่มกด มันสามารถเปล่งแสงสีต่างๆ เพื่อให้ข้อมูลป้อนกลับ เช่น ส่งสัญญาณว่าหุ่นยนต์พร้อมใช้งาน แสดงโหมดที่เลือก หรือจับคู่สีที่ตรวจจับได้จากเซ็นเซอร์อื่น และยังสามารถตรวจจับได้ว่ามีการสัมผัสเมื่อใด ทำให้คุณสามารถเริ่มหรือเปลี่ยนพฤติกรรมของหุ่นยนต์ได้ด้วยการแตะเพียงครั้งเดียว

คอนสตรัคเตอร์คลาส #

touchled( 
  int32_t index );

ตัวทำลายคลาส #

ทำลายวัตถุ touchled และปล่อยทรัพยากรที่เกี่ยวข้อง

virtual ~touchled();

พารามิเตอร์#

พารามิเตอร์	พิมพ์	คำอธิบาย
`index`	`int32_t`	พอร์ตอัจฉริยะที่เชื่อมต่อกับไฟ LED แบบสัมผัส จะเขียนในรูปแบบ `PORTx`โดยที่ `x` คือหมายเลขพอร์ต (ตัวอย่างเช่น `PORT1`)

ตัวอย่าง #

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

ฟังก์ชันสมาชิก #

คลาส touchled ประกอบด้วยฟังก์ชันสมาชิกต่อไปนี้:

pressing – ส่งคืนว่าไฟ LED สัมผัสถูกกดหรือไม่
setColor – ตั้งค่าสีของไฟ LED สัมผัส
setFade – กำหนดความเร็วในการเปลี่ยนสีของกันและกัน
setBrightness – ตั้งค่าความสว่างของไฟ LED สัมผัส
pressed – ลงทะเบียนฟังก์ชันที่จะถูกเรียกเมื่อกดไฟ LED สัมผัส
released – ลงทะเบียนฟังก์ชันที่จะถูกเรียกเมื่อปล่อยไฟ LED สัมผัส
on – เปิดไฟ LED สัมผัส
off – ปิดไฟ LED สัมผัส
setBlink – สลับไฟ LED สัมผัสเปิดและปิดไปเรื่อยๆ อย่างไม่มีที่สิ้นสุด
installed – ส่งคืนว่า Touch LED เชื่อมต่อกับ Brain หรือไม่

ก่อนเรียกใช้ฟังก์ชันสมาชิก touchled ใดๆ จะต้องสร้างอินสแตนซ์ touchled ก่อน ดังแสดงด้านล่าง:

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

คืนค่ากลับมาหากกำลังกดปุ่ม TouchLED อยู่

Available Functions

bool pressing();

Parameters

ฟังก์ชันนี้ไม่รับพารามิเตอร์ใดๆ

Return Values

ส่งคืนค่าบูลีน bool เพื่อระบุว่าไฟ LED สัมผัสถูกกดอยู่หรือไม่

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

setColor #

ตั้งค่าไฟ LED ของเซ็นเซอร์ LED แบบสัมผัสให้เป็นสีที่กำหนด

Available Functions

1 — ตั้งค่าไฟ LED สัมผัสเป็นสีโดยใช้ vex::color.
void setColor( 
  vex::color  color );

2 — ตั้งค่าสี LED โดยใช้ colorType ที่มีค่า
void setColor( 
  colorType   color );

Parameters

พารามิเตอร์

พิมพ์

คำอธิบาย

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

ฟังก์ชันนี้ไม่ส่งค่ากลับ

setFade #

ตั้งค่าการเฟดสีของเซ็นเซอร์ LED แบบสัมผัส เซ็นเซอร์ LED แบบสัมผัสจะเปลี่ยนสีใหม่โดยใช้ประเภทการเฟดสีที่เลือกไว้

Available Functions

void setFade(
  fadeType  speed );

Parameters

พารามิเตอร์	พิมพ์	คำอธิบาย
`speed`	`fadeType`	ความเร็วในการเฟดจะถูกตั้งค่าดังนี้: `fast` `off` — ไม่เฟด `slow`

พารามิเตอร์

พิมพ์

คำอธิบาย

speed

fadeType

ความเร็วในการเฟดจะถูกตั้งค่าดังนี้:

fast
off — ไม่เฟด
slow

Return Values

ฟังก์ชันนี้ไม่ส่งค่ากลับ

setBrightness #

ตั้งค่าความสว่างของไฟ LED ระบบสัมผัส

Available Functions

void setBrightness(
  uint32_t  value );

Parameters

พารามิเตอร์	พิมพ์	คำอธิบาย
`value`	`uint32_t`	สามารถตั้งค่าความสว่างของไฟ LED ระบบสัมผัสเป็นเปอร์เซ็นต์ได้

Return Values

ฟังก์ชันนี้ไม่ส่งค่ากลับ

pressed #

ลงทะเบียนฟังก์ชันที่จะถูกเรียกใช้เมื่อกดปุ่มไฟ LED ระบบสัมผัส

Available Functions

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

Parameters

พารามิเตอร์	พิมพ์	คำอธิบาย
`callback`	`void (*)(void)`	ตัวชี้ไปยังฟังก์ชันที่จะถูกเรียกเมื่อกดปุ่มไฟ LED แบบสัมผัส ฟังก์ชันนี้ต้องไม่มีพารามิเตอร์และส่งคืนค่าว่าง (void)

Return Values

ฟังก์ชันนี้ไม่ส่งค่ากลับ

Examples

กำหนดฟังก์ชันเรียกกลับ (นอก int main())
// Display a message when LED is pressed
void LEDPressed() {
  Brain.Screen.print("LED pressed");
}
ลงทะเบียนฟังก์ชันเรียกกลับภายใน 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 #

ลงทะเบียนฟังก์ชันที่จะถูกเรียกเมื่อปล่อยปุ่ม Touch LED

Available Functions

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

Parameters

พารามิเตอร์	พิมพ์	คำอธิบาย
`callback`	`void (*)(void)`	ตัวชี้ไปยังฟังก์ชันที่จะถูกเรียกเมื่อปล่อยปุ่ม Touch LED ฟังก์ชันนี้ต้องไม่มีพารามิเตอร์และส่งคืนค่าว่าง (void)

Return Values

ฟังก์ชันนี้ไม่ส่งค่ากลับ

Examples

กำหนดฟังก์ชันเรียกกลับ (นอก int main())
// Display a message when LED is released
void LEDReleased() {
  Brain.Screen.print("LED released");
}
ลงทะเบียนฟังก์ชันเรียกกลับภายใน 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 #

เปิดไฟ LED ของเซ็นเซอร์ TouchLED โดยใช้สีและความสว่างที่ตั้งไว้

Available Functions

1 — ตั้งค่าสีของ LED โดยใช้ vex::color
void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — ตั้งค่าสี LED โดยใช้ค่าสี (hue)
void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3__ — ตั้งค่าสีของ LED โดยใช้ค่า RGB
void on( 
  uint8_t   red, 
  uint8_t   green, 
  uint8_t   blue, 
  uint32_t  brightness = 100);

Parameters

พารามิเตอร์	พิมพ์	คำอธิบาย
`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`	(เลือกได้) ตั้งค่าความสว่างของ LED เป็นเปอร์เซ็นต์ โดยค่าเริ่มต้นคือ 100
`hue`	`uint32_t`	สีของ LED สามารถแสดงได้ด้วยค่าเลขฐานสิบหก (0x000000)
`red`	`uint8_t`	ตัวเลขจำนวนเต็มที่แสดงค่าสีแดงของ LED
`green`	`uint8_t`	ตัวเลขจำนวนเต็มที่แสดงค่าสีเขียวของ LED
`blue`	`uint8_t`	ตัวเลขจำนวนเต็มที่แสดงค่าสีน้ำเงินของ LED

Return Values

ฟังก์ชันนี้ไม่ส่งค่ากลับ

off #

ปิดไฟ LED ระบบสัมผัส

Available Functions

void off( void );

Parameters

ฟังก์ชันนี้ไม่รับพารามิเตอร์ใดๆ

Return Values

ฟังก์ชันนี้ไม่ส่งค่ากลับ

setBlink #

ไฟ LED สัมผัสจะกะพริบซ้ำๆ ในรูปแบบเปิดและปิด

Available Functions

1 — ตั้งค่าสีการกระพริบโดยใช้ vex::color ที่
void setBlink( 
  vex::color    color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

2 — กำหนดสีการกระพริบโดยใช้ค่าสีฐานสิบหก
void setBlink( 
  uint32_t      hue, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

3 — ตั้งค่าสีการกระพริบโดยใช้ colorType ที่มี
void setBlink( 
  colorType     color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

Parameters

พารามิเตอร์	พิมพ์	คำอธิบาย
`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`	(เลือกได้) ระยะเวลาที่ไฟ LED จะสว่างในแต่ละรอบการกระพริบ (หน่วยเป็นวินาที) โดยค่าเริ่มต้นคือ 0.25 วินาที
`offTime`	`double`	(เลือกได้) ระยะเวลาที่ไฟ LED จะดับในแต่ละรอบการกระพริบ (หน่วยเป็นวินาที) โดยค่าเริ่มต้นคือ 0.25 วินาที
`hue`	`uint32_t`	สีของ LED สามารถแสดงได้ด้วยค่าเลขฐานสิบหก (Hexcode)
`color`	`vex::color`	A valid custom color.

Return Values

ฟังก์ชันนี้ไม่ส่งค่ากลับ

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 #

ตรวจสอบว่าไฟ LED สัมผัสเชื่อมต่ออยู่หรือไม่

Available Functions

bool installed();

Parameters

ฟังก์ชันนี้ไม่รับพารามิเตอร์ใดๆ

Return Values

ส่งคืนค่าบูลีนที่ระบุว่าไฟ LED สัมผัสเชื่อมต่ออยู่หรือไม่:

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