Espruino:Справочник по API/Класс Graphics/setColor(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
(Новая страница: «{{Espruino/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} =<ref>[ www.espruino.com - ]</ref>= ==Синтакс...»)
 
Нет описания правки
 
(не показаны 3 промежуточные версии 2 участников)
Строка 3: Строка 3:
{{Myagkij-редактор}}
{{Myagkij-редактор}}


=<ref>[ www.espruino.com - ]</ref>=
=Функция Graphics.setColor()<ref>[https://www.espruino.com/Reference#t_l_Graphics_setColor www.espruino.com - function Graphics.setColor]</ref>=


==Синтаксис==
==Синтаксис==


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript">
 
function Graphics.setColor(r, g, b)
</syntaxhighlight>
</syntaxhighlight>


==Параметры==
==Параметры==


* '''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)


Кроме того, в объекте [https://www.espruino.com/Reference#Graphics Graphics] есть настройка color_order, с помощью которой можно задать порядок цветовых значений r, g и b.


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


== Примеры ==
== Примеры ==


Эта функция используется в следующих статьях документации [[Espruino]]:
* [https://www.espruino.com/Graphics#line=8,9,10 Графическая библиотека]


=См.также=


=См.также=


{{ads}}


=Внешние ссылки=
=Внешние ссылки=
Строка 35: Строка 50:
<references />
<references />


{{Навигационная таблица/Espruino}}
{{Навигационная таблица/Портал/Espruino}}
{{Навигационная таблица/Телепорт}}

Текущая версия от 15:54, 11 июня 2023

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


Функция 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:

См.также

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