信号塔#

介绍#

The signaltower class is used to change lights and detect interactions with the CTE Signal Tower.

类构造函数#

signaltower( 
  int32_t  index );

类析构函数#

Destroys the signaltower object and releases associated resources.

virtual ~signaltower();

参数#

范围

类型

描述

index

int32_t

The Smart Port that the Signal Tower is connected to, written as PORTx, where x is the port number (for example, PORT1).

示例#

// Create a signal tower instance in Port 1
signaltower SignalTower = signaltower(PORT1);

成员功能#

The signaltower class provides the following member functions:

  • setColor - 使用各种输入方法控制信号塔上的 LED 颜色和状态。

  • setColors - 分别设置信号塔上所有 LED 的状态。

  • setBlink - 根据 LED 的 ID 设置信号塔上 LED 的闪烁状态。

  • setBlinkTime - 设置信号塔上 LED 灯的闪烁间隔时间。

  • enableBlink - 启用信号塔上多个 LED 的闪烁功能，并指定它们的 ID。

  • disableBlink - 根据 ID 禁用信号塔上多个 LED 的闪烁。

  • pressing - 返回信号塔保险杠当前是否被按下。

  • pressed - 注册一个在信号塔保险杠被按下时要调用的函数。

  • released - 注册一个在信号塔保险杠释放时要调用的函数。

setColor#

通过多种输入方式控制信号塔上的 LED 灯颜色和状态。这些灯可用于跟踪机器人在项目中的位置，或显示何时满足特定条件。

Available Functions

1 — 使用 vex::color 将信号塔设置为某种颜色。

void setColor( 
  vex::color         color, 
  signaltower::state state = signaltower::state::on );

2 — 使用 32 位 RGB 和 YW 值设置 LED 颜色。

void setColor( 
  uint32_t rgb, 
  uint32_t yw );

3 — 根据 LED ID 设置单个 LED 的亮度。

void setColor( 
  ledId id, 
  uint32_t value );

4 — 分别设置所有 LED 的亮度级别。

void setColor( 
  uint8_t r, 
  uint8_t y, 
  uint8_t g, 
  uint8_t b, 
  uint8_t w );
Parameters

范围

类型

描述

color

vex::color

The color to use:

  • red
  • yellow
  • green
  • blue
  • white
  • all

state

signaltower::state

The state for the LED:

  • on (Default) – Turns the LED on.
  • off – Turns the LED off.
  • blink – Makes the LED blink.

rgb

uint32_t

The brightness of red, green and blue LED using a 32-bit value (e.g., red on = 0xFF0000, green on = 0x00FF00, and blue on = 0x0000FF).

yw

uint32_t

The brightness of yellow and white LED using a 32-bit value (e.g., yellow on = 0xFF00 and white on = 0x00FF).

id

ledId

The index of the LED to control:

  • 0 – red
  • 1 – green
  • 2 – blue
  • 3 – white
  • 4 – yellow

value

uint32_t

LED 的亮度范围为 0 到 255，其中 0 为关闭，255 为最大亮度。

r

uint8_t

红色 LED 的亮度范围为 0 到 255，其中 0 为关闭，255 为最大亮度。

y

uint8_t

黄色 LED 的亮度范围为 0 到 255，其中 0 为关闭，255 为最大亮度。

g

uint8_t

绿色 LED 的亮度范围为 0 到 255，其中 0 为关闭，255 为最大亮度。

b

uint8_t

蓝色 LED 的亮度范围为 0 到 255，其中 0 为关闭，255 为最大亮度。

w

uint8_t

白色 LED 的亮度范围为 0 到 255，其中 0 为关闭，255 为最大亮度。
Return Values

此函数不返回值。

Examples 
// Set the Signal Tower to start blinking blue
SignalTower.setColor(vex::color::blue, signaltower::blink);

// Set the red, blue and white LEDs using hex values
SignalTower.setColor(0xFF00FF, 0x00FF);

// Set the green LED to full brightness by ID
SignalTower.setColor(1, 255);

// Set all LEDs to full brightness
SignalTower.setColor(255, 255, 255, 255, 255);

setColors#

分别设置信号塔上所有 LED 的状态。这些灯可用于跟踪机器人在项目中的位置，或显示何时满足特定条件。

Available Functions 
void setColors( 
  signaltower::state rs, 
  signaltower::state ys, 
  signaltower::state gs, 
  signaltower::state bs, 
  signaltower::state ws );
Parameters

范围

类型

描述

rs

signaltower::state

The state of the red LED:

  • on – Turns the LED on.
  • off – Turns the LED off.
  • blink – Makes the LED blink.

ys

signaltower::state

The state of the yellow LED:

  • on – Turns the LED on.
  • off – Turns the LED off.
  • blink – Makes the LED blink.

gs

signaltower::state

The state of the green LED:

  • on – Turns the LED on.
  • off – Turns the LED off.
  • blink – Makes the LED blink.

bs

signaltower::state

The state of the blue LED:

  • on – Turns the LED on.
  • off – Turns the LED off.
  • blink – Makes the LED blink.

ws

signaltower::state

The state of the white LED:

  • on – Turns the LED on.
  • off – Turns the LED off.
  • blink – Makes the LED blink.
Return Values

此函数不返回值。

Examples 
// Turn on all LEDs
SignalTower.setColors(signaltower::on, signaltower::on, signaltower::on, signaltower::on, signaltower::on);

setBlinkTime#

设置信号塔上 LED 灯的闪烁间隔时间。

Available Functions 
void setBlinkTime( 
  uint32_t onTime, 
  uint32_t offTime = 0 );
Parameters

范围

类型

描述

onTime

uint32_t

LED闪烁时持续亮起的时间（以毫秒为单位）。最大值为2500毫秒。值为0时，默认值为500毫秒。

offTime

uint32_t

LED 闪烁时熄灭的时间（以毫秒为单位）。最大值为 2500 毫秒。值为 0 时使用 onTime 值。默认值为 0。
Return Values

此函数不返回值。

pressing#

返回信号塔的保险杠当前是否被按下。这可以用作紧急停止装置。

Available Functions 
bool pressing();
Parameters

此函数没有参数。

Return Values

返回一个布尔值，指示信号塔的保险杠当前是否被按下。

  • true — The Signal Tower’s bumper is currently being pressed.

  • false — The Signal Tower’s bumper is not being pressed.

pressed#

注册一个在信号塔保险杠被按下时要调用的函数。

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

范围

类型

描述

callback

void (*)(void)

指向一个函数的指针，该函数将在按下保险杠时调用。
Return Values

此函数不返回值。

Examples

Define the callback function (outside of int main())

// Display a message when bumper is pressed
void towerBumperPressed() {
  Brain.Screen.print("tower bumper pressed");
}

Register the callback inside int main()

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Run towerBumperPressed when the tower bumper 
  // is pressed
  SignalTower.pressed(towerBumperPressed);
}

released#

注册一个在信号塔保险杠释放时要调用的函数。

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

范围

类型

描述

callback

void (*)(void)

指向一个函数的指针，该函数将在保险杠释放时调用。
Return Values

此函数不返回值。

Examples

Define the callback function (outside of int main())

// Display a message when bumper is pressed
void towerBumperReleased() {
  Brain.Screen.print("tower bumper pressed");
}

Register the callback inside int main()

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Run towerBumperReleased when the tower bumper 
  // is released
  SignalTower.pressed(towerBumperReleased);
}
On this page