Vlastní barvy#

Zavedení #

Třída color se používá k definování a úpravě barev pro kreslení tvarů a zobrazování textu na obrazovce V5 Brain. Barvy lze vytvářet pomocí hodnot RGB, hexadecimálních barevných kódů, hodnot HSV nebo předdefinovaných barevných konstant.

Konstruktory tříd #

1 — Vytvoří objekt s color barvou bez přiřazené barvy.
color();

2 — Vytvoří objekt s color barvou z hexadecimální nebo celočíselné hodnoty.
color( 
  int value );

3 — Vytvoří objekt s color barvou z hodnot RGB.
color( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Destruktor tříd #

Zničí objekt color a uvolní související zdroje.

~color();

Parametry #

Parametr	Typ	Popis
`value`	`int`	Hodnota barvy, která může být buď hexadecimální celé číslo RGB (například `0xFFF700`), nebo jedna z níže uvedených předdefinovaných barevných konstant.
`r`	`uint8_t`	Celé číslo od 0 do 255 představující červenou složku.
`g`	`uint8_t`	Celé číslo od 0 do 255 představující zelenou složku.
`b`	`uint8_t`	Celé číslo od 0 do 255 představující modrou složku.

Poznámky #

Jsou podporovány následující předdefinované barevné konstanty:
- black
- blue
- cyan
- green
- orange
- purple
- red
- transparent
- violet
- white
- yellow

Příklad #

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

Členské funkce #

Třída color obsahuje následující členské funkce:

rgb — Aktualizuje barvu pomocí hodnot RGB.
hsv — Aktualizuje barvu pomocí hodnot HSV.
web — Aktualizuje barvu pomocí hexadecimálního řetězce barvy typu web.

Před voláním jakékoli členské funkce color musí být vytvořena instance color , jak je znázorněno níže:

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

rgb #

Aktualizuje barvu existujícího objektu s color barvou pomocí hodnot RGB.

Available Functions

1 — Aktualizuje barevný objekt zabalenou hodnotou RGB.
uint32_t rgb( 
  uint32_t value );

2 — Aktualizuje barevný objekt samostatnými hodnotami RGB.
uint32_t rgb( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Parameters

Parametr	Typ	Popis
`value`	`uint32_t`	Zabalená hodnota RGB obsahující všechny tři barevné složky.
`r`	`uint8_t`	Celé číslo od 0 do 255 představující červenou složku barvy.
`g`	`uint8_t`	Celé číslo od 0 do 255 představující zelenou složku barvy.
`b`	`uint8_t`	Celé číslo od 0 do 255 představující modrou složku barvy.

Return Values

Vrací hodnotu uint32_t , která představuje zabalenou hodnotu RGB aktualizované barvy.

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 #

Aktualizuje barvu existujícího objektu s hodnotou color pomocí hodnot odstínu, sytosti a jasu.

Available Functions

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

Parameters

Parametr	Typ	Popis
`hue`	`uint32_t`	Celé číslo od 0 do 360, které představuje odstín barvy.
`sat`	`double`	Dvojitá hodnota od 0,0 do 1,0, která představuje sytost barvy.
`value`	`double`	Dvojitá hodnota od 0,0 do 1,0, která představuje jas barvy.

Return Values

Vrátí odkaz na aktualizovaný objekt 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 #

Aktualizuje barvu existujícího objektu s hodnotou color pomocí hexadecimální nebo webové hodnoty barvy.

Available Functions

color& web( 
  const char* color );

Parameters

Parametr	Typ	Popis
`color`	`const char*`	Hexadecimální nebo webová hodnota barvy, která definuje konkrétní barvu (např. `“#FF0000”` pro červenou).

Return Values

Vrátí odkaz na aktualizovaný objekt 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);