Colores personalizados#

Introducción #

El dron VEX AIR admite el uso de colores personalizados para dibujar e imprimir texto. Los colores personalizados se pueden crear utilizando valores RGB o códigos hexadecimales. Los colores personalizados también incluyen métodos para actualizar objetos de color durante un proyecto.

A continuación se muestra una lista de constructores disponibles:

Constructors – Create a new Color object.

Color(value) – Crea un color usando una cadena hexadecimal (por ejemplo, "#FFF700") o un entero hexadecimal (por ejemplo, 0xFFF700).
Color(r, g, b): crea un color utilizando valores rojos, verdes y azules.

Mutadores: actualiza un objeto Color existente.

rgb – Establece un objeto de color creado a un nuevo color usando valores RGB.
hsv – Establece un objeto de color creado a un nuevo color usando valores de tono, saturación y brillo.
web – Establece un objeto de color creado a un nuevo color usando una cadena de color web hexadecimal (por ejemplo, "#32C8B6").

Getters – Devuelve el valor de tono o saturación de un objeto de color.

saturation – Devuelve el valor de saturación de un color personalizado.
hue – Devuelve el valor de tono de un color personalizado.

Crear un color personalizado #

Para usar un color personalizado, primero debe crear un objeto Color usando uno de los siguientes constructores:

Hexadecimal String #

Crea un color utilizando una cadena de color web (código hexadecimal).

Usage:
Color(value)

Parámetro	Descripción
`value`	Un código hexidecimal de seis dígitos como una cadena (por ejemplo, `“#FF700”` para amarillo).

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

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

Hexadecimal Integer #

Crea un color usando un entero hexadecimal de seis dígitos.

Usage:
Color(value)

Parámetro	Descripción
`value`	Un entero de seis dígitos en formato hexadecimal (por ejemplo `0xFFF700` 0xFFF700 para amarillo).

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

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

RGB #

Crea un color utilizando valores rojos, verdes y azules separados.

Usage:
Color(r, g, b)

Parámetro	Descripción
`r`	Un número entero de 0 a 255 que representa el componente rojo.
`g`	Un número entero de 0 a 255 que representa el componente verde.
`b`	Un número entero de 0 a 255 que representa el componente azul.

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

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

Mutadores #

These methods update the color of an existing Color object. To use them, assign a Color to a variable when creating it, then call the method on that variable to change its color.

rgb #

rgb actualiza el color de un objeto Color existente utilizando valores RGB.

Usage:
variable_name.rgb(r, g, b)

Parámetros	Descripción
`r`	Un número entero de 0 a 255 que representa el componente rojo del color.
`g`	Un número entero de 0 a 255 que representa el componente verde del color.
`b`	Un número entero de 0 a 255 que representa el componente azul del color.

# Create a custom teal color
my_fill_color = Color(50, 200, 180)

# Draw a teal rectangle
controller.screen.draw_rectangle(x=30, y=70, width=80, height=50, color=my_fill_color)

# Draw a magenta rectangle
my_fill_color.rgb(170, 40, 150)
controller.screen.draw_rectangle(x=130, y=70, width=80, height=50, color=my_fill_color)

hsv #

hsv actualiza el color de un objeto Color existente utilizando valores HSV.

Nota: hsv solo se puede usar para cambiar un objeto Color que ya se haya creado. No se puede usar para crear un nuevo objeto Color.

Usage:
variable_name.hsv(h, s, v)

Parámetros	Descripción
`h`	Un número entero de 0 a 359 que representa el tono del color.
`s`	Un flotador de 0.0 a 1.0 que representa la saturación del color.
`v`	Un flotador de 0.0 a 1.0 que representa el brillo del color.

# Create a custom teal color
my_fill_color = Color(50, 200, 180)

# Draw a teal rectangle
controller.screen.draw_rectangle(x=30, y=70, width=80, height=50, color=my_fill_color)

# Draw a magenta rectangle
my_fill_color.hsv(300, 0.75, 0.78)
controller.screen.draw_rectangle(x=130, y=70, width=80, height=50, color=my_fill_color)

web #

web actualiza el color de un objeto Color existente utilizando un color web (código hexadecimal).

Usage:
variable_name.web(value)

Parámetros	Descripción
`value`	Un color web como una cadena (código hexadecimal) (por ejemplo, `“#FFF700”`).

# Create a custom teal color
my_fill_color = Color("#32C8B6")

# Draw a teal rectangle
controller.screen.draw_rectangle(x=30, y=70, width=80, height=50, color=my_fill_color)

# Draw a magenta rectangle
my_fill_color.web("#AA2896")
controller.screen.draw_rectangle(x=130, y=70, width=80, height=50, color=my_fill_color)

Getters #

saturation #

saturation devuelve el valor de saturación para un color personalizado como un flotante de 0 a 1.

Usage:
my_color.saturation()

Reemplace my_color con el nombre del objeto de color personalizado.

Parámetros	Descripción
	Este método no tiene parámetros.

# Create a custom teal color
color_teal = Color(50, 200, 180)

# Display the saturation value of teal
controller.screen.print(color_teal.saturation())

hue #

hue devuelve el valor de tono para un color personalizado como un flotante de 0 a 359.

Usage:
my_color.hue()

Reemplace my_color con el nombre del objeto de color personalizado.

Parámetros	Descripción
	Este método no tiene parámetros.

# Create a custom teal color
color_teal = Color(50, 200, 180)

# Display the hue value of teal
controller.screen.print(color_teal.hue())