Користувацькі кольори#

Вступ #

Клас color використовується для визначення та зміни кольорів для малювання фігур та відображення тексту на екрані EXP Brain. Кольори можна створювати за допомогою значень RGB, шістнадцяткових колірних кодів, значень HSV або попередньо визначених колірних констант.

Конструктори класів #

1 — Створює об’єкт color без призначеного кольору.
color();

2 — Створює об’єкт кольору color з шістнадцяткового або цілочисельного значення.
color( 
  int value );

3 — Створює об’єкт color зі значень RGB.
color( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Деструктор класів #

Знищує об’єкт color та звільняє пов’язані з ним ресурси.

~color();

Параметри #

Параметр	Тип	Опис
`value`	`int`	Значення кольору, яке може бути або шістнадцятковим цілим числом RGB (наприклад, `0xFFF700`), або однією з попередньо визначених колірних констант, перелічених нижче.
`r`	`uint8_t`	Ціле число від 0 до 255, що представляє червоний компонент.
`g`	`uint8_t`	Ціле число від 0 до 255, що представляє зелений компонент.
`b`	`uint8_t`	Ціле число від 0 до 255, що представляє синій компонент.

Нотатки #

The following predefined color constants are supported:
- black
- blue
- cyan
- green
- orange
- purple
- red
- transparent
- violet
- white
- yellow

Приклад #

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

Функції-члени #

Клас color містить такі функції-члени:

rgb — Оновлює колір за допомогою значень RGB.
hsv — Оновлює колір за допомогою значень HSV.
web — Оновлює колір за допомогою шістнадцяткового рядка кольору у форматі web.

Перед викликом будь-яких функцій-членів color необхідно створити екземпляр color , як показано нижче:

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

rgb #

Оновлює колір існуючого об’єкта з color , використовуючи значення RGB.

Available Functions

1 — Оновлює кольоровий об’єкт упакованим значенням RGB.
uint32_t rgb( 
  uint32_t value );

2 — Оновлює колірний об’єкт окремими значеннями RGB.
uint32_t rgb( 
  uint8_t r, 
  uint8_t g, 
  uint8_t b );

Parameters

Параметр	Тип	Опис
`value`	`uint32_t`	Упаковане значення RGB, що містить усі три колірні компоненти.
`r`	`uint8_t`	Ціле число від 0 до 255, що представляє червоний компонент кольору.
`g`	`uint8_t`	Ціле число від 0 до 255, що представляє зелений компонент кольору.
`b`	`uint8_t`	Ціле число від 0 до 255, що представляє синій компонент кольору.

Return Values

Повертає значення uint32_t , що представляє упаковане значення RGB оновленого кольору.

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 #

Оновлює колір існуючого об’єкта color , використовуючи значення відтінку, насиченості та яскравості.

Available Functions

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

Parameters

Параметр	Тип	Опис
`hue`	`uint32_t`	Ціле число від 0 до 360, яке представляє відтінок кольору.
`sat`	`double`	Подвійне число від 0.0 до 1.0, яке представляє насиченість кольору.
`value`	`double`	Число типу double від 0.0 до 1.0, яке представляє яскравість кольору.

Return Values

Повертає посилання на оновлений об’єкт 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 #

Оновлює колір існуючого об’єкта color , використовуючи шістнадцяткове або веб-значення кольору.

Available Functions

color& web( 
  const char* color );

Parameters

Параметр	Тип	Опис
`color`	`const char*`	Шістнадцяткове або веб-значення кольору, яке визначає певний колір (наприклад, `“#FF0000”` для червоного).

Return Values

Повертає посилання на оновлений об’єкт 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);