Mukautetut värit#

Johdanto #

color -luokkaa käytetään värien määrittelyyn ja muokkaamiseen IQ (1. sukupolvi) aivoilla. 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 #

The following predefined color constants are supported:
- black
- blue
- blue_green
- blue_violet
- cyan
- green
- orange
- purple
- red
- red_orange
- red_violet
- transparent
- violet
- white
- yellow
- yellow_green
- yellow_orange

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

// Drive until a teal object is found
color brainColor = color(50, 200, 180);
Drivetrain.drive(forward);
while (true) {
    if (Color1.detects(brainColor)) {
        Drivetrain.stop();
        break;
    }
    wait(0.5, seconds);
}

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

// Create a custom teal color
color brainColor = color(50, 200, 180);
// Change the color to magenta
brainColor.hsv(300, 0.75, 0.78);

// Drive forward until a magenta object is found
Drivetrain.drive(forward);
while (true) {
    if (Color1.detects(brainColor)) {
        Drivetrain.stop();
        break;
    }
    wait(0.5, seconds);
}

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

// Create a custom teal color
color brainColor = color(50, 200, 180);
// Change the color to magenta
brainColor.web("#AA2896");

// Drive forward until a magenta object is found
Drivetrain.drive(forward);
while (true) {
    if (Color1.detects(brainColor)) {
        Drivetrain.stop();
        break;
    }
    wait(0.5, seconds);
}