Màn hình LED cảm ứng#

Giới thiệu #

Đèn LED cảm ứng VEX IQ vừa là đèn báo vừa là nút bấm. Nó có thể phát sáng với nhiều màu sắc khác nhau để cung cấp phản hồi, chẳng hạn như báo hiệu robot đã sẵn sàng, hiển thị chế độ được chọn hoặc khớp với màu sắc được phát hiện bởi một cảm biến khác, và nó có thể phát hiện khi được chạm vào, cho phép bạn khởi động hoặc thay đổi hành vi của robot chỉ bằng một lần chạm.

Hàm tạo lớp #

touchled( 
  int32_t index );

Lớp Destructor #

Destroys the touchled object and releases associated resources.

virtual ~touchled();

Thông số #

Tham số	Kiểu	Sự miêu tả
`index`	`int32_t`	Cổng thông minh mà đèn LED cảm ứng được kết nối, được viết dưới dạng `PORTx`, trong đó `x` là số cổng (ví dụ: `PORT1`).

Ví dụ #

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

Chức năng thành viên #

Lớp touchled bao gồm các hàm thành viên sau:

pressing – Trả về trạng thái có đang được nhấn hay không.
setColor – Đặt màu cho đèn LED cảm ứng.
setFade – Đặt tốc độ chuyển đổi màu sắc giữa các màu.
setBrightness – Đặt độ sáng của đèn LED cảm ứng.
pressed – Đăng ký một hàm sẽ được gọi khi đèn LED cảm ứng được nhấn.
released – Đăng ký một hàm sẽ được gọi khi đèn LED cảm ứng được nhả ra.
on – Bật đèn LED cảm ứng.
off – Tắt đèn LED cảm ứng.
setBlink – Bật và tắt đèn LED cảm ứng liên tục.
installed – Trả về trạng thái cho biết đèn LED cảm ứng có được kết nối với Brain hay không.

Trước khi gọi bất kỳ hàm thành viên nào được chạm vào touchled , phải tạo một thể hiện touchled , như được hiển thị bên dưới:

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

Trả về giá trị này nếu TouchLED hiện đang được nhấn.

Available Functions

bool pressing();

Parameters

Hàm này không chấp nhận bất kỳ tham số nào.

Return Values

Trả về giá trị boolean bool cho biết đèn LED cảm ứng có đang được nhấn hay không.

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

setColor #

Thiết lập đèn LED của cảm biến LED cảm ứng bật màu cụ thể.

Available Functions

1 — Đặt màu cho đèn LED cảm ứng bằng cách sử dụng vex::color.
void setColor( 
  vex::color  color );

2 — Đặt màu LED bằng cách sử dụng colorType.
void setColor( 
  colorType   color );

Parameters

Tham số

Kiểu

Sự miêu tả

color

colorType

Màu hợp lệ:

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

Hàm này không trả về giá trị nào.

setFade #

Thiết lập chế độ chuyển màu của cảm biến LED cảm ứng. Cảm biến LED cảm ứng sẽ thay đổi màu sắc theo kiểu chuyển màu đã thiết lập.

Available Functions

void setFade(
  fadeType  speed );

Parameters

Tham số	Kiểu	Sự miêu tả
`speed`	`fadeType`	Tốc độ làm mờ sẽ được thiết lập như sau: `fast` `off` — không làm mờ `slow`

Tham số

Kiểu

Sự miêu tả

speed

fadeType

Tốc độ làm mờ sẽ được thiết lập như sau:

fast
off — không làm mờ
slow

Return Values

Hàm này không trả về giá trị nào.

setBrightness #

Thiết lập độ sáng của đèn LED cảm ứng.

Available Functions

void setBrightness(
  uint32_t  value );

Parameters

Tham số	Kiểu	Sự miêu tả
`value`	`uint32_t`	Điều chỉnh độ sáng của đèn LED cảm ứng theo phần trăm.

Return Values

Hàm này không trả về giá trị nào.

pressed #

Đăng ký một hàm sẽ được gọi khi đèn LED cảm ứng được nhấn.

Available Functions

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

Parameters

Tham số	Kiểu	Sự miêu tả
`callback`	`void (*)(void)`	Con trỏ đến một hàm sẽ được gọi khi nhấn vào đèn LED cảm ứng. Hàm này không được nhận tham số và trả về kiểu void.

Return Values

Hàm này không trả về giá trị nào.

Examples

Xác định hàm gọi lại (bên ngoài int main())

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

Đăng ký hàm gọi lại bên trong 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 #

Đăng ký một hàm sẽ được gọi khi người dùng nhả nút cảm ứng LED.

Available Functions

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

Parameters

Tham số	Kiểu	Sự miêu tả
`callback`	`void (*)(void)`	Con trỏ đến một hàm sẽ được gọi khi nút Touch LED được nhả ra. Hàm này không được nhận tham số và trả về kiểu void.

Return Values

Hàm này không trả về giá trị nào.

Examples

Xác định hàm gọi lại (bên ngoài int main())

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

Đăng ký hàm gọi lại bên trong 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 #

Bật đèn LED của cảm biến TouchLED bằng các màu sắc và độ sáng đã được thiết lập.

Available Functions

1 — Đặt màu cho đèn LED bằng cách sử dụng vex::color.
void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — Đặt màu đèn LED bằng sắc độ.
void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 — Đặt màu LED bằng giá trị RGB.

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

Parameters

Tham số	Kiểu	Sự miêu tả
`color`	`vex::color`	Màu hợp lệ: `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`	Tùy chọn. Độ sáng mong muốn của đèn LED được thiết lập theo phần trăm, mặc định là 100%.
`hue`	`uint32_t`	Màu sắc của đèn LED. Màu sắc này cũng có thể được biểu diễn dưới dạng giá trị Hexcode (0x000000).
`red`	`uint8_t`	Một số nguyên biểu thị giá trị màu đỏ của đèn LED.
`green`	`uint8_t`	Một số nguyên biểu thị giá trị màu xanh lá cây của đèn LED.
`blue`	`uint8_t`	Một số nguyên biểu thị giá trị màu xanh lam của đèn LED.

Return Values

Hàm này không trả về giá trị nào.

off #

Tắt đèn LED cảm ứng.

Available Functions

void off( void );

Parameters

Hàm này không nhận tham số nào.

Return Values

Hàm này không trả về giá trị nào.

setBlink #

Đèn LED cảm ứng nhấp nháy liên tục theo kiểu bật tắt.

Available Functions

1 — Đặt màu nhấp nháy bằng cách sử dụng vex::color.
void setBlink( 
  vex::color    color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

2 — Đặt màu nhấp nháy bằng giá trị màu thập lục phân.
void setBlink( 
  uint32_t      hue, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

3 — Đặt màu nhấp nháy bằng cách sử dụng colorType.
void setBlink( 
  colorType     color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

Parameters

Tham số	Kiểu	Sự miêu tả
`color`	`colorType`	Màu hợp lệ: `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`	Tùy chọn. Thời gian (tính bằng giây) đèn LED sẽ sáng mỗi chu kỳ nhấp nháy, mặc định là 0,25 giây.
`offTime`	`double`	Tùy chọn. Thời gian (tính bằng giây) đèn LED sẽ tắt trong mỗi chu kỳ nhấp nháy, mặc định là 0,25 giây.
`hue`	`uint32_t`	Giá trị màu thập lục phân (ví dụ: `0xFF0000` cho màu đỏ).
`color`	`vex::color`	A valid custom color.

Return Values

Hàm này không trả về giá trị nào.

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 #

Trả về trạng thái kết nối của đèn LED cảm ứng.

Available Functions

bool installed();

Parameters

Hàm này không nhận tham số nào.

Return Values

Trả về giá trị Boolean cho biết đèn LED cảm ứng có được kết nối hay không:

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