自定义颜色#

介绍#

VEX IQ(第二代)支持使用自定义颜色进行绘图和文本绘制。自定义颜色可以使用 RGB 值、十六进制代码、HSV 值或预定义常量创建。自定义颜色包含创建和更新颜色对象的方法。以下是可用方法的列表:

Constructors – Create a new Color object.

  • Color(value) – Accepts a predefined constant, hex string (e.g. “#FFF700”), or hex integer (e.g. 0xFFF700).

  • Color(r, g, b) – 使用红色、绿色和蓝色值 (0–255) 创建颜色。

Mutators – Update an existing Color object.

  • rgb – 使用新的 RGB 值更新颜色。

  • hsv – 使用色调 (0–360)、饱和度和亮度 (0.0–1.0) 更新颜色。

  • web – Updates a color using a web hex color string (e.g. “#32C8B6”).

创建自定义颜色#

To use a custom color, you must first create a Color object using one of the following constructors:

Hexadecimal Integer#

使用六位十六进制整数创建颜色。

Usage:
Color(value)

范围

描述

value

A six-digit integer in hexadecimal format (e.g., 0xFFF700 for yellow).

# Construct a yellow Color "yellow" using a
# hexadecimal value
yellow = Color(0xFFF700)

brain.screen.set_pen_color(yellow)
brain.screen.print("My Yellow")

RGB#

使用单独的红色、绿色和蓝色值创建颜色。

Usage:
Color(r, g, b)

范围

描述

r

表示红色成分的 0 至 255 之间的整数。

g

表示绿色成分的 0 至 255 之间的整数。

b

表示蓝色成分的 0 至 255 之间的整数。

# Construct a yellow Color "yellow" using
# RGB values
yellow = Color(255, 247, 0)

brain.screen.set_pen_color(yellow)
brain.screen.print("My Yellow")

Web Color#

使用 Web 颜色字符串(十六进制代码)创建颜色。

Usage:
Color(value)

范围

描述

value

A web color as a string (hex code) (e.g., “#FFF700”).

# Construct a yellow Color "yellow" using a
# web string
yellow = Color("#FFF700")

brain.screen.set_pen_color(yellow)
brain.screen.print("My Yellow")

Predefined Color#

Creates a color using a predefined Color constant.

Usage:
Color(value)

范围

描述

value

A built-in color constant:
BLACK, BLUE, CYAN, GREEN, ORANGE, PURPLE, RED, TRANSPARENT, WHITE, YELLOW.

# Construct a yellow Color "yellow" using a
# predefined Color constant
yellow = Color.YELLOW

brain.screen.set_pen_color(yellow)
brain.screen.print("My Yellow")

修改器#

These methods allow you to modify a Color object after it has been created during a project.

rgb#

rgb updates the color of an existing Color object using RGB values.

Usage:
rgb(r, g, b)

参数

描述

r

0 至 255 之间的整数,表示颜色的红色成分。

g

0 至 255 之间的整数,表示颜色的绿色成分。

b

0 至 255 之间的整数,表示颜色的蓝色成分。

# Create a custom teal color and set it as the pen color
brain_color = Color(50, 200, 180)
brain.screen.set_pen_color(brain_color)

# Draw a rectangle with the teal outline
brain.screen.draw_rectangle(5, 10, 80, 40)

# Draw another rectangle with a magenta outline
brain_color.rgb(170, 40, 150)
brain.screen.set_pen_color(brain_color)
brain.screen.draw_rectangle(5, 60, 80, 40)

hsv#

hsv updates the color of an existing Color object using HSV values.

Note: hsv can only be used to change a Color object that has already been created. It cannot be used to create a new Color Object.

Usage:
hsv(h, s, v)

参数

描述

h

表示颜色色调的 0 至 360 之间的整数。

s

0.0 到 1.0 之间的浮点数,表示颜色的饱和度。

v

0.0 到 1.0 之间的浮点数,表示颜色的亮度。

# Create a custom teal color using RGB (HSV can't be used)
brain_color = Color(50, 200, 180)
brain.screen.set_pen_color(brain_color)

# Draw a rectangle with the teal outline
brain.screen.draw_rectangle(5, 10, 80, 40)

# Draw another rectangle with a magenta outline
brain_color.hsv(300, 0.75, 0.78)
brain.screen.set_pen_color(brain_color)
brain.screen.draw_rectangle(5, 60, 80, 40)

web#

web updates the color of an existing Color object using a web color (hex code).

Usage:
web(value)

参数

描述

value

用于更新现有颜色实例的字符串形式的 Web 颜色(十六进制代码)。

# Create a custom teal color and set it as the pen color
brain_color = Color("#32C8B6")
brain.screen.set_pen_color(brain_color)

# Draw a rectangle with the teal outline
brain.screen.draw_rectangle(5, 10, 80, 40)

# Draw another rectangle with the new magenta outline
brain_color.web("#AA2896")
brain.screen.set_pen_color(brain_color)
brain.screen.draw_rectangle(5, 60, 80, 40)