Egyedi színek#

Bevezetés #

A color osztály a V5 Brain Screen-en megjelenő alakzatok színeinek definiálására és módosítására szolgál. A színek RGB-értékek, hexadecimális színkódok, HSV-értékek vagy előre definiált színállandók segítségével hozhatók létre.

Osztálykonstruktorok #

1 — Létrehoz egy color objektumot hozzárendelt szín nélkül.
color();

2 — Hexadecimális vagy egész értékből color objektumot hoz létre.
color( 
  int value );

3 — Létrehoz egy color objektumot RGB értékekből.
color( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Osztálydestruktor #

Megsemmisíti a color objektumot és felszabadítja a hozzá tartozó erőforrásokat.

~color();

Paraméterek #

Paraméter	Típus	Leírás
`value`	`int`	A színérték, amely lehet hexadecimális RGB egész szám (például `0xFFF700`), vagy az alább felsorolt előre definiált színállandók egyike.
`r`	`uint8_t`	Egy 0 és 255 közötti egész szám, amely a piros komponenst jelöli.
`g`	`uint8_t`	Egy 0 és 255 közötti egész szám, amely a zöld komponenst jelöli.
`b`	`uint8_t`	Egy 0 és 255 közötti egész szám, amely a kék komponenst jelöli.

Megjegyzések #

The following predefined color constants are supported:
- black
- blue
- cyan
- green
- orange
- purple
- red
- transparent
- violet
- white
- yellow

Példa #

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

Tagfüggvények #

A color osztály a következő tagfüggvényeket tartalmazza:

rgb — RGB-értékek használatával frissíti a színt.
hsv — HSV-értékek használatával frissíti a színt.
web — Frissíti a színt egy webes hexadecimális színkarakterlánc használatával.

Bármely color tagfüggvény meghívása előtt létre kell hozni egy color példányt, az alábbiak szerint:

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

rgb #

RGB-értékek használatával frissíti egy meglévő color objektum színét.

Available Functions

1 — Csomagolt RGB értékkel frissít egy színobjektumot.
uint32_t rgb( 
  uint32_t value );

2 — Színobjektumot frissít külön RGB-értékekkel.
uint32_t rgb( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Parameters

Paraméter	Típus	Leírás
`value`	`uint32_t`	Egy csomagolt RGB-érték, amely mindhárom színkomponenst tartalmazza.
`r`	`uint8_t`	Egy 0 és 255 közötti egész szám, amely a szín vörös komponensét jelöli.
`g`	`uint8_t`	Egy 0 és 255 közötti egész szám, amely a szín zöld komponensét jelöli.
`b`	`uint8_t`	Egy 0 és 255 közötti egész szám, amely a szín kék komponensét jelöli.

Return Values

Egy uint32_t értéket ad vissza, amely a frissített szín csomagolt RGB-értékét jelöli.

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 #

Frissíti egy meglévő color objektum színét a színárnyalat, a telítettség és a fényerő értékeinek felhasználásával.

Available Functions

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

Parameters

Paraméter	Típus	Leírás
`hue`	`uint32_t`	Egy 0 és 360 közötti egész szám, amely a színárnyalatot jelöli.
`sat`	`double`	Egy 0,0 és 1,0 közötti dupla érték, amely a szín telítettségét jelöli.
`value`	`double`	Egy 0,0 és 1,0 közötti dupla érték, amely a szín fényességét jelöli.

Return Values

Visszaad egy referenciát a frissített color objektumra.

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 #

Frissíti egy meglévő color objektum színét hexadecimális vagy webes színérték használatával.

Available Functions

color& web( 
  const char* color );

Parameters

Paraméter	Típus	Leírás
`color`	`const char*`	Egy hexadecimális vagy webes színérték, amely egy adott színt definiál (pl. `“#FF0000”` a piros esetében).

Return Values

Visszaad egy referenciát a frissített color objektumra.

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