自定义颜色#

介绍 #

VEX IQ (2nd gen) supports the use of custom colors for drawing and text. Custom colors can be created using RGB values, hex codes, HSV values, or predefined constants. Custom Colors includes methods for both creating and updating color objects.

Below is a list of all methods:

Constructors — Create a new Color object.

Color(value) — Accepts a predefined constant, hex string, or hex integer.
Color(r, g, b) — Creates a color using red, green, and blue values.

Mutators — Update an existing Color object.

rgb — Updates a color using new RGB values.
hsv — Updates a color using hue, saturation, and brightness.
web — Updates a color using a web hex color string.

创建自定义颜色 #

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)