터치 LED#

소개#

VEX IQ 터치 LED는 조명과 버튼의 기능을 모두 갖추고 있습니다. 로봇이 준비되었음을 알리거나, 선택된 모드를 표시하거나, 다른 센서에서 감지된 색상과 일치하는 등 다양한 색상으로 빛을 발하여 피드백을 제공할 수 있습니다. 또한 터치 감지 기능을 통해 탭 한 번으로 로봇의 동작을 시작하거나 변경할 수 있습니다.

클래스 생성자#

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 – 터치 LED가 브레인에 연결되어 있는지 여부를 반환합니다.

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

터치 LED가 눌렸는지 여부를 나타내는 bool 의 부울 값을 반환합니다.

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

setColor#

터치 LED 센서의 LED를 특정 색상으로 켜도록 설정합니다.

Available Functions

1 — vex::color 을 사용하여 터치 LED의 색상을 설정합니다.

void setColor( 
  vex::color  color );

2 — colorType 을 사용하여 LED 색상을 설정합니다.

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

유효한 사용자 지정 색상.
Return Values

이 함수는 값을 반환하지 않습니다.

setFade#

터치 LED 센서의 페이드 설정을 지정합니다. 터치 LED 센서는 설정된 페이드 유형에 따라 새로운 색상으로 변경됩니다.

Available Functions 
void setFade(
  fadeType  speed );
Parameters

매개변수

유형

설명

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#

터치 LED에서 손을 떼었을 때 호출될 함수를 등록합니다.

Available Functions 
void released( void (* callback)(void) );
Parameters

매개변수

유형

설명

callback

void (*)(void)

터치 LED에서 손을 떼면 호출될 함수에 대한 포인터입니다. 이 함수는 매개변수를 받지 않고 반환값이 없어야 합니다.
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#

Turns the LED of the TouchLED Sensor on using colors and a set brightness.

Available Functions

1 — vex::color를 사용하여 LED의 색상을 설정합니다.

void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — 색조를 사용하여 LED 색상을 설정합니다.

void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 — RGB 값으로 LED 색상을 설정합니다.

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의 색조입니다. 이는 16진수 값(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

이 함수는 값을 반환하지 않습니다.

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.
On this page