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

Вступ #

Клас color використовується для визначення та зміни кольорів за допомогою IQ (1-го покоління) 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
- blue_green
- blue_violet
- cyan
- green
- orange
- purple
- red
- red_orange
- red_violet
- transparent
- violet
- white
- yellow
- yellow_green
- yellow_orange

Приклад #

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

// 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 #

Оновлює колір існуючого об’єкта 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

// 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 #

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

Available Functions

color& web( 
  const char* color );

Parameters

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

Return Values

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