Mukautetut värit#

Johdanto #

color -luokkaa käytetään V5 Brain Screen -näytöllä muotojen piirtämiseen ja tekstin näyttämiseen käytettävien värien määrittelyyn ja muokkaamiseen. Värejä voidaan luoda käyttämällä RGB-arvoja, heksadesimaalivärikoodeja, HSV-arvoja tai ennalta määritettyjä värivakioita.

Luokanrakentajat #

1 — Luo color objektin, jolle ei ole määritetty väriä.
color();

2 — Luo heksadesimaali- tai kokonaislukuarvosta color objektin.
color( 
  int value );

3 — Luo RGB-arvoista color objektin.
color( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Luokan tuhoaja #

Tuhoaa color objektin ja vapauttaa siihen liittyvät resurssit.

~color();

Parametrit #

Parametri	Tyyppi	Kuvaus
`value`	`int`	Väriarvo, joka voi olla joko heksadesimaalinen RGB-kokonaisluku (esimerkiksi `0xFFF700`) tai jokin alla luetelluista valmiiksi määritetyistä värivakioista.
`r`	`uint8_t`	Kokonaisluku 0–255, joka edustaa punaista komponenttia.
`g`	`uint8_t`	Kokonaisluku väliltä 0–255, joka edustaa vihreää komponenttia.
`b`	`uint8_t`	Kokonaisluku väliltä 0–255, joka edustaa sinistä komponenttia.

Muistiinpanoja #

Seuraavia ennalta määritettyjä värivakioita tuetaan:
- black
- blue
- cyan
- green
- orange
- purple
- red
- transparent
- violet
- white
- yellow

Esimerkki #

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

Jäsenten toiminnot #

color -luokka sisältää seuraavat jäsenfunktiot:

rgb — Päivittää värin RGB-arvojen avulla.
hsv — Päivittää värin HSV-arvojen avulla.
web — Päivittää värin käyttämällä web-heksadesimaalivärimerkkijonoa.

Ennen minkään color -jäsenfunktion kutsumista on luotava color -instanssi alla olevan mukaisesti:

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

rgb #

Päivittää olemassa olevan color -objektin värin RGB-arvojen avulla.

Available Functions

1 — Päivittää väriobjektin pakatulla RGB-arvolla.
uint32_t rgb( 
  uint32_t value );

2 — Päivittää väriobjektin erillisillä RGB-arvoilla.
uint32_t rgb( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Parameters

Parametri	Tyyppi	Kuvaus
`value`	`uint32_t`	Pakattu RGB-arvo, joka sisältää kaikki kolme värikomponenttia.
`r`	`uint8_t`	Kokonaisluku 0–255, joka edustaa värin punaista komponenttia.
`g`	`uint8_t`	Kokonaisluku väliltä 0–255, joka edustaa värin vihreää komponenttia.
`b`	`uint8_t`	Kokonaisluku 0–255, joka edustaa värin sinistä komponenttia.

Return Values

Palauttaa arvon uint32_t joka edustaa päivitetyn värin pakattua RGB-arvoa.

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 #

Päivittää olemassa olevan color -objektin värin käyttämällä sävy-, kylläisyys- ja kirkkausarvoja.

Available Functions

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

Parameters

Parametri	Tyyppi	Kuvaus
`hue`	`uint32_t`	Kokonaisluku väliltä 0–360, joka edustaa värin sävyä.
`sat`	`double`	Kaksinkertainen arvo 0,0:sta 1,0:aan, joka edustaa värin kylläisyyttä.
`value`	`double`	Kaksinkertainen arvo 0,0:sta 1,0:aan, joka edustaa värin kirkkautta.

Return Values

Palauttaa viittauksen päivitettyyn color -objektiin.

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 #

Päivittää olemassa olevan color -objektin värin käyttämällä heksadesimaali- tai web-väriarvoa.

Available Functions

color& web( 
  const char* color );

Parameters

Parametri	Tyyppi	Kuvaus
`color`	`const char*`	Heksadesimaali- tai verkkoväriarvo, joka määrittää tietyn värin (esim. `“#FF0000”` punaiselle).

Return Values

Palauttaa viittauksen päivitettyyn color -objektiin.

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