Cores personalizadas#

Introdução #

A classe de cor color é utilizada para definir e modificar cores para desenhar formas e apresentar texto no ecrã EXP Brain. As cores podem ser criadas utilizando valores RGB, códigos de cores hexadecimais, valores HSV ou constantes de cores predefinidas.

Construtores de Classes #

1 — Cria um objeto de cor color valor, sem qualquer cor atribuída.
color();

2 — Cria um objeto de cor color a partir de um valor hexadecimal ou inteiro.
color( 
  int value );

3 — Creates a color object from RGB values.
color( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Destrutor de classes #

Destrói o objeto de cor color e liberta os recursos associados.

~color();

Parâmetros #

Parâmetro	Tipo	Descrição
`value`	`int`	O valor da cor, que pode ser um número inteiro RGB hexadecimal (por exemplo, `0xFFF700`) ou uma das constantes de cor predefinidas listadas abaixo.
`r`	`uint8_t`	Um número inteiro de 0 a 255 que representa a componente vermelha.
`g`	`uint8_t`	Um número inteiro de 0 a 255 que representa o componente verde.
`b`	`uint8_t`	Um número inteiro de 0 a 255 que representa o componente azul.

Notas #

As seguintes constantes de cor predefinidas são suportadas:
- black
- blue
- cyan
- green
- orange
- purple
- red
- transparent
- violet
- white
- yellow

Exemplo #

// Create the color yellow using a hexadecimal value
color myYellow = color(0xFFF700);

// Create a color using RGB values
color myBlue = color(0, 100, 255);

// Create a color using a predefined constant
color myRed = color(red);

Funções de membro #

A classe color inclui as seguintes funções membro:

rgb — Atualiza a cor utilizando os valores RGB.
hsv — Atualiza a cor utilizando os valores HSV.
web — Atualiza a cor utilizando uma cadeia de cores hexadecimal da web.

Antes de chamar qualquer função membro de cor color , deve ser criada uma instância de cor color , como se mostra abaixo:

// Create a color using RGB values
color brainColor = color(255, 128, 0);

rgb #

Atualiza a cor de um objeto existente com cor color utilizando valores RGB.

Available Functions

1 — Atualiza um objeto de cor com um valor RGB comprimido.
uint32_t rgb( 
  uint32_t value );

2 — Atualiza um objeto de cor com valores RGB separados.
uint32_t rgb( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Parameters

Parâmetro	Tipo	Descrição
`value`	`uint32_t`	Um valor RGB comprimido contendo todos os três componentes de cor.
`r`	`uint8_t`	Um número inteiro de 0 a 255 que representa a componente vermelha da cor.
`g`	`uint8_t`	Um número inteiro de 0 a 255 que representa a componente verde da cor.
`b`	`uint8_t`	Um número inteiro de 0 a 255 que representa a componente azul da cor.

Return Values

Retorna um uint32_t uint32_t atualizada.

Examples

// Draw a rectangle with a custom teal color
color brainColor = color(50, 200, 180);
Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 0, 480, 120);

// Change the color to magenta for a second rectangle
brainColor.rgb(170, 40, 150);

Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 120, 480, 120);

// Draw a rectangle with a custom teal color
color brainColor = color(50, 200, 180);
Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 0, 480, 120);

// Change the color to magenta for a second rectangle
brainColor.rgb(0xAA2896);

Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 120, 480, 120);

hsv #

Atualiza a cor de um objeto existente com o valor color , utilizando os valores de matiz, saturação e brilho.

Available Functions

color& hsv( 
  uint32_t hue, 
  double   sat, 
  double   value );

Parameters

Parâmetro	Tipo	Descrição
`hue`	`uint32_t`	Um número inteiro de 0 a 360 que representa a tonalidade da cor.
`sat`	`double`	Um valor decimal entre 0,0 e 1,0 que representa a saturação da cor.
`value`	`double`	Um valor decimal entre 0,0 e 1,0 que representa o brilho da cor.

Return Values

Retorna uma referência ao objeto atualizado com cor color.

Examples

// Draw a rectangle with a custom teal color
color brainColor = color(50, 200, 180);
Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 0, 480, 120);

// Change the color to magenta for a second rectangle
brainColor.hsv(300, 0.75, 0.78);

Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 120, 480, 120);

web #

Atualiza a cor de um objeto existente com cor color utilizando um valor hexadecimal ou de cor web.

Available Functions

color& web( 
  const char* color );

Parameters

Parâmetro	Tipo	Descrição
`color`	`const char*`	Um valor hexadecimal ou de cor web que define uma cor específica (por exemplo, `“#FF0000”` para vermelho).

Return Values

Retorna uma referência ao objeto atualizado com cor color.

Examples

// Draw a rectangle with a custom teal color
color brainColor = color(50, 200, 180);
Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 0, 480, 120);

// Change the color to magenta for a second rectangle
brainColor.web("#AA2896");

Brain.Screen.setFillColor(brainColor);
Brain.Screen.drawRectangle(0, 120, 480, 120);