Sonderfarben#

Einführung #

Die Klasse color dient zur Definition und Modifizierung von Farben mit dem IQ-Brain (1. Generation). Farben können mithilfe von RGB-Werten, hexadezimalen Farbcodes, HSV-Werten oder vordefinierten Farbkonstanten erstellt werden.

Klassenkonstruktoren #

1 — Erzeugt ein color Objekt ohne zugewiesene Farbe.
color();

2 — Erzeugt ein color Objekt aus einem Hexadezimal- oder Ganzzahlwert.
color( 
  int value );

3 — Erzeugt ein color Objekt aus RGB-Werten.
color( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Klassendestruktor #

Zerstört das Objekt mit der Farbe color und gibt die zugehörigen Ressourcen frei.

~color();

Parameter #

Parameter	Typ	Beschreibung
`value`	`int`	Der Farbwert kann entweder eine hexadezimale RGB-Ganzzahl (z. B. `0xFFF700`) oder eine der unten aufgeführten vordefinierten Farbkonstanten sein.
`r`	`uint8_t`	Eine ganze Zahl von 0 bis 255, die die Rotkomponente darstellt.
`g`	`uint8_t`	Eine ganze Zahl von 0 bis 255, die die grüne Komponente darstellt.
`b`	`uint8_t`	Eine ganze Zahl von 0 bis 255, die die blaue Komponente darstellt.

Anmerkungen #

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

Beispiel #

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

Mitgliedsfunktionen #

Die Klasse color umfasst die folgenden Memberfunktionen:

rgb — Aktualisiert die Farbe anhand der RGB-Werte.
hsv — Aktualisiert die Farbe anhand der HSV-Werte.
web — Aktualisiert die Farbe mithilfe einer Web-Hex-Farbzeichenfolge.

Bevor Sie eine der Memberfunktionen color aufrufen, muss eine Instanz color erstellt werden, wie unten gezeigt:

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

rgb #

Aktualisiert die Farbe eines vorhandenen color Objekts mithilfe von RGB-Werten.

Available Functions

1 — Aktualisiert ein Farbobjekt mit einem gepackten RGB-Wert.
uint32_t rgb( 
  uint32_t value );

2 — Aktualisiert ein Farbobjekt mit separaten RGB-Werten.
uint32_t rgb( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Parameters

Parameter	Typ	Beschreibung
`value`	`uint32_t`	Ein gepackter RGB-Wert, der alle drei Farbkomponenten enthält.
`r`	`uint8_t`	Eine ganze Zahl von 0 bis 255, die den Rotanteil der Farbe darstellt.
`g`	`uint8_t`	Eine ganze Zahl von 0 bis 255, die den Grünanteil der Farbe darstellt.
`b`	`uint8_t`	Eine ganze Zahl von 0 bis 255, die den Blauanteil der Farbe darstellt.

Return Values

Gibt einen uint32_t zurück, der den gepackten RGB-Wert der aktualisierten Farbe darstellt.

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 #

Aktualisiert die Farbe eines vorhandenen color Objekts unter Verwendung von Farbton-, Sättigungs- und Helligkeitswerten.

Available Functions

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

Parameters

Parameter	Typ	Beschreibung
`hue`	`uint32_t`	Eine ganze Zahl von 0 bis 360, die den Farbton angibt.
`sat`	`double`	Ein Doppelwert von 0,0 bis 1,0, der die Farbsättigung angibt.
`value`	`double`	Ein Wert zwischen 0,0 und 1,0, der die Helligkeit der Farbe angibt.

Return Values

Gibt eine Referenz auf das aktualisierte color Objekt zurück.

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 #

Aktualisiert die Farbe eines vorhandenen color Objekts mithilfe eines hexadezimalen oder Web-Farbwerts.

Available Functions

color& web( 
  const char* color );

Parameters

Parameter	Typ	Beschreibung
`color`	`const char*`	Ein hexadezimaler oder Web-Farbwert, der eine bestimmte Farbe definiert (z. B. `“#FF0000”` für Rot).

Return Values

Gibt eine Referenz auf das aktualisierte color Objekt zurück.

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