Colores personalizados#

Introducción #

La clase de color se utiliza para definir y modificar colores para dibujar formas y mostrar texto en la pantalla V5 Brain. Los colores se pueden crear utilizando valores RGB, códigos de color hexadecimales, valores HSV o constantes de color predefinidas.

Constructores de clase #

1 — Crea un objeto de color sin color asignado.
color();

2 — Crea un objeto de color a partir de un valor hexadecimal o entero.
color( 
  int value );

3 — Crea un objeto de color a partir de valores RGB.
color( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Destructor de clase #

Destruye el objeto de color y libera los recursos asociados.

~color();

Parámetros #

Parámetro	Tipo	Descripción
`value`	`int`	El valor de color, que puede ser un entero RGB hexadecimal (por ejemplo, `0xFFF700`) o una de las constantes de color predefinidas que se enumeran a continuación.
`r`	`uint8_t`	Un número entero de 0 a 255 que representa el componente rojo.
`g`	`uint8_t`	Un número entero de 0 a 255 que representa el componente verde.
`b`	`uint8_t`	Un número entero de 0 a 255 que representa el componente azul.

Observaciones #

Se admiten las siguientes constantes de color predefinidas:
- black
- blue
- cyan
- green
- orange
- purple
- red
- transparent
- violet
- white
- yellow

Ejemplo #

// 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);

Funciones de los miembros #

La clase de color incluye las siguientes funciones de miembro:

rgb — Actualiza el color usando valores RGB.
hsv — Actualiza el color usando valores HSV.
web — Actualiza el color usando una cadena de color web hexadecimal.

Antes de llamar a color miembro de color instancia de color, como se muestra a continuación:

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

rgb #

Actualiza el color de un objeto de color existente utilizando valores RGB.

Available Functions

1 — Actualiza un objeto de color con un valor RGB empaquetado.
uint32_t rgb( 
  uint32_t value );

2 — Actualiza un objeto de color con valores RGB separados.
uint32_t rgb( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Parameters

Parámetro	Tipo	Descripción
`value`	`uint32_t`	Un valor RGB empaquetado que contiene los tres componentes de color.
`r`	`uint8_t`	Un número entero de 0 a 255 que representa el componente rojo del color.
`g`	`uint8_t`	Un número entero de 0 a 255 que representa el componente verde del color.
`b`	`uint8_t`	Un número entero de 0 a 255 que representa el componente azul del color.

Return Values

Devuelve un uint32_t que representa el valor RGB empaquetado del color actualizado.

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 #

Actualiza el color de un objeto de color existente utilizando valores de tono, saturación y brillo.

Available Functions

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

Parameters

Parámetro	Tipo	Descripción
`hue`	`uint32_t`	Un entero de 0 a 360 que representa el tono del color.
`sat`	`double`	Un doble de 0.0 a 1.0 que representa la saturación del color.
`value`	`double`	Un doble de 0.0 a 1.0 que representa el brillo del color.

Return Values

Devuelve una referencia al objeto de color actualizado.

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 #

Actualiza el color de un objeto de color existente utilizando un valor de color hexadecimal o web.

Available Functions

color& web( 
  const char* color );

Parameters

Parámetro	Tipo	Descripción
`color`	`const char*`	Un valor de color hexadecimal o web que define un color específico (por ejemplo, `“#FF0000”` para el rojo).

Return Values

Devuelve una referencia al objeto de color actualizado.

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