Espruino:Справочник по API/Класс Graphics/setColor()

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Функция Graphics.setColor()[1]

Синтаксис

function Graphics.setColor(r, g, b)

Параметры

  • r – значение красного цвета (между 0 и 1) ИЛИ целое число, обозначающее цвет в текущем цветовом разрешении и текущем порядке цветовых значений (color_order), ИЛИ строка с шестнадцатеричным числом в формате '#012345'
  • g – значение зеленого цвета (между 0 и 1)
  • b – Значение синего цвета (между 0 и 1)

Возвращаемое значение

Объект Graphics, на котором была вызвана эта функция, чтобы сделать цепочку вызовов.

Описание

Задает основной цвет, который будет использоваться в функциях отрисовки.

Если в аргументе r будет задано целое число, оно будет записано в пиксель напрямую. Например, в 24-битных объектах Graphics максимальный синий можно задать при помощи g.setColor(0,0,1) или g.setColor(0x0000FF). Универсальный способ получить белый цвет на всех платформах – это g.setColor(-1).

В разных разрешениях цветовые значения задаются следующим образом:

  • 32 бита – 0xFFrrggbb
  • 24 бита – 0xrrggbb
  • 16 бит – 0brrrrrggggggbbbbb (RGB565)

Кроме того, в объекте Graphics есть настройка color_order, с помощью которой можно задать порядок цветовых значений r, g и b.

Примечание

На устройствах с маленькой flash-памятью значение в аргументе r должно быть целое число, обозначающее цвет в текущем цветовом разрешении. Оно не может быть числом с плавающей точкой, а аргументы g и b будут проигнорированы.

Примеры

Эта функция используется в следующих статьях документации Espruino:

См.также

Внешние ссылки