Dathanna Saincheaptha#

Réamhrá #

Úsáidtear an rang color chun dathanna a shainiú agus a mhodhnú le haghaidh cruthanna a tharraingt agus téacs a thaispeáint ar an EXP Brain Screen. Is féidir dathanna a chruthú ag baint úsáide as luachanna RGB, cóid dathanna heicsidheachúla, luachanna HSV, nó tairiseacha dathanna réamhshainithe.

Tógálaithe Ranga #

1 — Cruthaíonn sé réad color gan aon dath sannta.
color();

2 — Cruthaíonn sé réad color ó luach heicsidheachúlach nó slánuimhir.
color( 
  int value );

3 — Cruthaíonn sé réad color ó luachanna RGB.
color( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Scriostóir Ranga #

Scriosann sé an réad color agus scaoileann sé acmhainní gaolmhara.

~color();

Paraiméadair #

Paraiméadar	Cineál	Cur síos
`value`	`int`	An luach datha, ar féidir leis a bheith ina shlánuimhir heicsidheachúlach RGB (mar shampla, `0xFFF700`) nó ina cheann de na tairiseacha datha réamhshainithe atá liostaithe thíos.
`r`	`uint8_t`	Slánuimhir ó 0 go 255 a léiríonn an chomhpháirt dhearg.
`g`	`uint8_t`	Slánuimhir ó 0 go 255 a léiríonn an chomhpháirt ghlas.
`b`	`uint8_t`	Slánuimhir ó 0 go 255 a léiríonn an chomhpháirt ghorm.

Nótaí #

Tacaítear leis na tairiseacha datha réamhshainithe seo a leanas:
- black
- blue
- cyan
- green
- orange
- purple
- red
- transparent
- violet
- white
- yellow

Sampla #

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

Feidhmeanna na mBall #

Áirítear leis an rang color na feidhmeanna ball seo a leanas:

rgb — Nuashonraíonn sé an dath ag baint úsáide as luachanna RGB.
hsv — Nuashonraíonn sé an dath ag baint úsáide as luachanna HSV.
web — Nuashonraítear an dath ag baint úsáide as teaghrán datha heicsidheachúlach gréasáin.

Sula nglaotar ar aon fheidhmeanna color bhall, ní mór sampla color a chruthú, mar a thaispeántar thíos:

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

rgb #

Nuashonraíonn sé dath réada color atá ann cheana féin ag baint úsáide as luachanna RGB.

Available Functions

1 — Nuashonraíonn sé réad datha le luach RGB pacáilte.
uint32_t rgb( 
  uint32_t value );

2 — Nuashonraíonn sé réad datha le luachanna RGB ar leithligh.
uint32_t rgb( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Parameters

Paraiméadar	Cineál	Cur síos
`value`	`uint32_t`	Luach RGB pacáilte ina bhfuil na trí chomhpháirt datha.
`r`	`uint8_t`	Slánuimhir ó 0 go 255 a léiríonn an chomhpháirt dhearg den dath.
`g`	`uint8_t`	Slánuimhir ó 0 go 255 a léiríonn an chomhpháirt ghlas den dath.
`b`	`uint8_t`	Slánuimhir ó 0 go 255 a léiríonn an chomhpháirt ghorm den dath.

Return Values

Tugann sé uint32_t a léiríonn luach RGB pacáilte an datha nuashonraithe.

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 #

Nuashonraíonn sé dath réada color atá ann cheana féin ag baint úsáide as luachanna datha, sáithiúcháin agus gile.

Available Functions

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

Parameters

Paraiméadar	Cineál	Cur síos
`hue`	`uint32_t`	Slánuimhir ó 0 go 360 a léiríonn lí an datha.
`sat`	`double`	Dúbailt ó 0.0 go 1.0 a léiríonn sáithiúlacht an datha.
`value`	`double`	Dúbailt ó 0.0 go 1.0 a léiríonn gile an datha.

Return Values

Tugann sé tagairt ar ais don réad nuashonraithe color.

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 #

Nuashonraíonn sé dath réada color atá ann cheana féin ag baint úsáide as luach heicsidheachúlach nó luach datha gréasáin.

Available Functions

color& web( 
  const char* color );

Parameters

Paraiméadar	Cineál	Cur síos
`color`	`const char*`	Luach heicsidheachúlach nó luach datha gréasáin a shainmhíníonn dath ar leith (m.sh., `“#FF0000”` le haghaidh dearg).

Return Values

Tugann sé tagairt ar ais don réad nuashonraithe color.

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