Aangepaste kleuren#

Invoering#

De klasse color wordt gebruikt om kleuren te definiëren en aan te passen voor het tekenen van vormen en het weergeven van tekst op het EXP Brain Screen. Kleuren kunnen worden gemaakt met behulp van RGB-waarden, hexadecimale kleurcodes, HSV-waarden of vooraf gedefinieerde kleurconstanten.

Klasseconstructors#

1 — Maakt een object met kleur color aan, zonder toegewezen kleur.

color();

2 — Maakt een object van kleur color aan op basis van een hexadecimale of integerwaarde.

color( 
  int value );

3 — Maakt een object met kleur color op basis van RGB-waarden.

color( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Klasse-destructor#

Vernietigt het object met kleur color en geeft de bijbehorende resources vrij.

~color();

Parameters#

Parameter

Type

Beschrijving

value

int

De kleurwaarde kan een hexadecimaal RGB-getal zijn (bijvoorbeeld 0xFFF700) of een van de onderstaande vooraf gedefinieerde kleurconstanten.

r

uint8_t

Een geheel getal van 0 tot 255 dat de rode component vertegenwoordigt.

g

uint8_t

Een geheel getal van 0 tot 255 dat het groene component vertegenwoordigt.

b

uint8_t

Een geheel getal van 0 tot 255 dat de blauwe component vertegenwoordigt.

Notities#

  • De volgende vooraf gedefinieerde kleurconstanten worden ondersteund:

    • black
    • blue
    • cyan
    • green
    • orange
    • purple
    • red
    • transparent
    • violet
    • white
    • yellow

Voorbeeld#

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

Lidfuncties#

De klasse color omvat de volgende lidfuncties:

  • rgb — Werkt de kleur bij met behulp van RGB-waarden.

  • hsv — Werkt de kleur bij met behulp van HSV-waarden.

  • web — Werkt de kleur bij met behulp van een hexadecimale webkleurstring.

Voordat er lidfuncties van type color kunnen worden aangeroepen, moet er een instantie color worden aangemaakt, zoals hieronder wordt weergegeven:

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

rgb#

Hiermee wordt de kleur van een bestaand object met kleurcode color bijgewerkt met behulp van RGB-waarden.

Available Functions

1 — Werkt een kleurobject bij met een gecomprimeerde RGB-waarde.

uint32_t rgb( 
  uint32_t value );

2 — Werkt een kleurobject bij met afzonderlijke RGB-waarden.

uint32_t rgb( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Parameters

Parameter

Type

Beschrijving

value

uint32_t

Een compacte RGB-waarde die alle drie de kleurcomponenten bevat.

r

uint8_t

Een geheel getal van 0 tot 255 dat de rode component van de kleur vertegenwoordigt.

g

uint8_t

Een geheel getal van 0 tot 255 dat de groene component van de kleur vertegenwoordigt.

b

uint8_t

Een geheel getal van 0 tot 255 dat het blauwe component van de kleur vertegenwoordigt.

Return Values

Retourneert een uint32_t die de gecomprimeerde RGB-waarde van de bijgewerkte kleur vertegenwoordigt.

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#

Hiermee wordt de kleur van een bestaand object met kleurwaarden color bijgewerkt met behulp van de waarden voor tint, verzadiging en helderheid.

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

Parameters

Parameter

Type

Beschrijving

hue

uint32_t

Een geheel getal van 0 tot 360 dat de tint van de kleur weergeeft.

sat

double

Een dubbele waarde van 0,0 tot 1,0 die de verzadiging van de kleur weergeeft.

value

double

Een decimaal getal van 0,0 tot 1,0 dat de helderheid van de kleur weergeeft.

Return Values

Retourneert een verwijzing naar het bijgewerkte object met kleur 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#

Hiermee wordt de kleur van een bestaand object met de waarde color bijgewerkt met behulp van een hexadecimale of webkleurwaarde.

Available Functions
color& web( 
  const char* color );

Parameters

Parameter

Type

Beschrijving

color

const char*

Een hexadecimale of webkleurwaarde die een specifieke kleur definieert (bijv. “#FF0000” voor rood).

Return Values

Retourneert een verwijzing naar het bijgewerkte object met kleur 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);