Cores personalizadas#

Introdução #

O VEX IQ (2ª geração) suporta a utilização de cores personalizadas para desenho e texto. As cores personalizadas podem ser criadas utilizando valores RGB, códigos hexadecimais, valores HSV ou constantes predefinidas. A funcionalidade Cores Personalizadas inclui métodos para criar e atualizar objetos de cor.

Segue-se uma lista de todos os métodos:

Construtores — Crie um novo objeto com Color valor.

Color(value) — Aceita uma constante predefinida, uma string hexadecimal ou um número inteiro hexadecimal.
Color(r, g, b) — Cria uma cor utilizando os valores de vermelho, verde e azul.

Mutadores — Atualizam um objeto existente Color cor.

rgb — Actualiza uma cor utilizando novos valores RGB.
hsv — Actualiza uma cor utilizando a tonalidade, a saturação e o brilho.
web — Atualiza uma cor utilizando uma cadeia de cor hexadecimal da web.

Criando uma cor personalizada #

Para utilizar uma cor personalizada, deve primeiro criar um objeto Color utilizando um dos seguintes construtores:

Hexadecimal Integer #

Cria uma cor utilizando um número inteiro hexadecimal de seis dígitos.

Usage:
Color(value)

Parâmetro	Descrição
`value`	Um número inteiro de seis dígitos em formato hexadecimal (ex.: `0xFFF700` para amarelo).

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

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

RGB #

Cria uma cor utilizando valores separados de vermelho, verde e azul.

Usage:
Color(r, g, b)

Parâmetro	Descrição
`r`	Um número inteiro de 0 a 255 que representa a componente vermelha.
`g`	Um número inteiro de 0 a 255 que representa o componente verde.
`b`	Um número inteiro de 0 a 255 que representa o componente azul.

# 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 #

Cria uma cor utilizando uma sequência de cores web (código hexadecimal).

Usage:
Color(value)

Parâmetro	Descrição
`value`	Uma cor web como uma string (código hexadecimal) (ex: `“#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 #

Cria uma cor utilizando uma constante predefinida Color.

Usage:
Color(value)

Parâmetro	Descrição
`value`	Uma constante de cor incorporada: `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")

Mutantes #

Estes métodos atualizam a cor de um objeto existente do tipo Color Para os utilizar, atribua um valor do tipo Color a uma variável ao criá-la e, em seguida, chame o método nessa variável para alterar a sua cor.

rgb #

rgb atualiza a cor de um objeto existente Color utilizando valores RGB.

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

Parâmetros	Descrição
`r`	Um número inteiro de 0 a 255 que representa a componente vermelha da cor.
`g`	Um número inteiro de 0 a 255 que representa a componente verde da cor.
`b`	Um número inteiro de 0 a 255 que representa a componente azul da cor.

# 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 atualiza a cor de um objeto existente Color utilizando valores HSV.

Nota: hsv só pode ser utilizado para alterar um objeto Color que já tenha sido criado. Não pode ser utilizado para criar um novo objeto Color.

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

Parâmetros	Descrição
`h`	Um número inteiro de 0 a 359 que representa a tonalidade da cor.
`s`	Um valor decimal entre 0,0 e 1,0 que representa a saturação da cor.
`v`	Um valor de ponto flutuante entre 0,0 e 1,0 que representa o brilho da cor.

# 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 atualiza a cor de um objeto existente Color utilizando uma cor web (código hexadecimal).

Usage:
variable_name.web(value)

Parâmetros	Descrição
`value`	Uma cor web como uma string (código hexadecimal) (ex: `“#FFF700”`).

# 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)