Niestandardowe kolory#

Wstęp #

Klasa kolorów color służy do definiowania i modyfikowania kolorów w systemie IQ Brain (1. generacji). Kolory można tworzyć za pomocą wartości RGB, szesnastkowych kodów kolorów, wartości HSV lub predefiniowanych stałych kolorów.

Konstruktory klas #

1 — Tworzy obiekt o kolorze color bez przypisanego koloru.
color();

2 — Tworzy obiekt koloru color z wartości szesnastkowej lub całkowitej.
color( 
  int value );

3 — Tworzy obiekt koloru color z wartości RGB.
color( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Destruktor klasy #

Destroys the color object and releases associated resources.

~color();

Parametry #

Parametr	Typ	Opis
`value`	`int`	Wartość koloru, która może być albo szesnastkową liczbą całkowitą RGB (na przykład `0xFFF700`), albo jedną ze zdefiniowanych stałych kolorów wymienionych poniżej.
`r`	`uint8_t`	Liczba całkowita od 0 do 255 reprezentująca składnik czerwony.
`g`	`uint8_t`	Liczba całkowita od 0 do 255 reprezentująca składnik zielony.
`b`	`uint8_t`	Liczba całkowita od 0 do 255 reprezentująca składnik niebieski.

Notatki #

Obsługiwane są następujące predefiniowane stałe kolorów:
- black
- blue
- blue_green
- blue_violet
- cyan
- green
- orange
- purple
- red
- red_orange
- red_violet
- transparent
- violet
- white
- yellow
- yellow_green
- yellow_orange

Przykład #

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

Funkcje członkowskie #

Klasa color zawiera następujące funkcje członkowskie:

rgb — Aktualizuje kolor przy użyciu wartości RGB.
hsv — Aktualizuje kolor przy użyciu wartości HSV.
web — Aktualizuje kolor, używając ciągu szesnastkowego koloru.

Przed wywołaniem jakiejkolwiek funkcji członkowskiej koloru color należy utworzyć instancję koloru color , jak pokazano poniżej:

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

rgb #

Aktualizuje kolor istniejącego obiektu o kolorze color , używając wartości RGB.

Available Functions

1 — Aktualizuje obiekt koloru za pomocą spakowanej wartości RGB.
uint32_t rgb( 
  uint32_t value );

2 — Aktualizuje obiekt koloru przy użyciu oddzielnych wartości RGB.
uint32_t rgb( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Parameters

Parametr	Typ	Opis
`value`	`uint32_t`	Spakowana wartość RGB zawierająca wszystkie trzy składniki koloru.
`r`	`uint8_t`	Liczba całkowita od 0 do 255 reprezentująca czerwoną składową koloru.
`g`	`uint8_t`	Liczba całkowita od 0 do 255 reprezentująca zieloną składową koloru.
`b`	`uint8_t`	Liczba całkowita od 0 do 255 reprezentująca niebieską składową koloru.

Return Values

Zwraca wartość uint32_t reprezentującą spakowaną wartość RGB zaktualizowanego koloru.

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 #

Aktualizuje kolor istniejącego obiektu o kolorze color używając wartości odcienia, nasycenia i jasności.

Available Functions

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

Parameters

Parametr	Typ	Opis
`hue`	`uint32_t`	Liczba całkowita od 0 do 360 oznaczająca odcień koloru.
`sat`	`double`	Podwójna wartość od 0,0 do 1,0 oznaczająca nasycenie koloru.
`value`	`double`	Podwójna wartość od 0,0 do 1,0 oznaczająca jasność koloru.

Return Values

Zwraca odwołanie do zaktualizowanego obiektu koloru color.

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 #

Aktualizuje kolor istniejącego obiektu o wartości color , używając wartości szesnastkowej lub internetowej koloru.

Available Functions

color& web( 
  const char* color );

Parameters

Parametr	Typ	Opis
`color`	`const char*`	Wartość koloru szesnastkowego lub internetowego definiująca konkretny kolor (np. `“#FF0000”` dla koloru czerwonego).

Return Values

Zwraca odwołanie do zaktualizowanego obiektu koloru color.

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