Anpassade färger#

Introduktion #

Färgklassen color används för att definiera och modifiera färger för att rita former och visa text på IQ (2:a generationen) Brain Screen. Färger kan skapas med hjälp av RGB-värden, hexadecimala färgkoder eller fördefinierade färgkonstanter.

Klasskonstruktörer #

1 — Skapar ett objekt med color utan tilldelad färg.
color();

2 — Skapar ett objekt med färgen color från ett hexadecimalt värde eller heltal.
color( 
  int value );

3 — Skapar ett objekt med color från RGB-värden.
color( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Klassförstörare #

Förstör objektet med färg color och frigör tillhörande resurser.

~color();

Parametrar #

Parameter	Typ	Beskrivning
`value`	`int`	Färgvärdet, som kan vara antingen ett hexadecimalt RGB-heltal (till exempel `0xFFF700`) eller en av de fördefinierade färgkonstanterna som listas nedan.
`r`	`uint8_t`	Ett heltal från 0 till 255 som representerar den röda komponenten.
`g`	`uint8_t`	Ett heltal från 0 till 255 som representerar den gröna komponenten.
`b`	`uint8_t`	Ett heltal från 0 till 255 som representerar den blå komponenten.

Anteckningar #

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

Exempel #

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

Medlemsfunktioner #

Klassen color innehåller följande medlemsfunktioner:

rgb — Uppdaterar färgen med RGB-värden.
hsv — Uppdaterar färgen med hjälp av HSV-värden.
web — Uppdaterar färgen med en hexagonal färgsträng för webben.

Innan några funktioner med color medlem anropas måste en instans color element skapas, som visas nedan:

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

rgb #

Uppdaterar färgen på ett befintligt objekt med color objekt med hjälp av RGB-värden.

Available Functions

1 — Uppdaterar ett färgobjekt med ett packat RGB-värde.
uint32_t rgb( 
  uint32_t value );

2 — Uppdaterar ett färgobjekt med separata RGB-värden.
uint32_t rgb( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Parameters

Parameter	Typ	Beskrivning
`value`	`uint32_t`	Ett packat RGB-värde som innehåller alla tre färgkomponenter.
`r`	`uint8_t`	Ett heltal från 0 till 255 som representerar den röda komponenten av färgen.
`g`	`uint8_t`	Ett heltal från 0 till 255 som representerar den gröna komponenten av färgen.
`b`	`uint8_t`	Ett heltal från 0 till 255 som representerar den blå komponenten av färgen.

Return Values

Returnerar uint32_t som representerar det packade RGB-värdet för den uppdaterade färgen.

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 #

Uppdaterar färgen på ett befintligt objekt med color med hjälp av värden för nyans, mättnad och ljusstyrka.

Available Functions

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

Parameters

Parameter	Typ	Beskrivning
`hue`	`uint32_t`	Ett heltal från 0 till 360 som representerar färgens nyans.
`sat`	`double`	En dubbel från 0,0 till 1,0 som representerar färgens mättnad.
`value`	`double`	En dubbel från 0,0 till 1,0 som representerar färgens ljusstyrka.

Return Values

Returnerar en referens till det uppdaterade objektet med color värde.

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 #

Uppdaterar färgen på ett befintligt objekt med color värde med hjälp av ett hexadecimalt värde eller ett webbfärgsvärde.

Available Functions

color& web( 
  const char* color );

Parameters

Parameter	Typ	Beskrivning
`color`	`const char*`	Ett hexadecimalt värde eller ett webbfärgsvärde som definierar en specifik färg (t.ex. `“#FF0000”` för rött).

Return Values

Returnerar en referens till det uppdaterade objektet med color värde.

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