Differences

This shows you the differences between two versions of the page.

--- ru:bearlibterminal:reference [2015/03/24 14:54]
cfyzium
+++ ru:bearlibterminal:reference [2016/09/07 03:05] (current)
cfyzium
@@ Line 268: / Line 268: @@
 color_t color_from_name(const char* name); // + вариант color_from_wname для wchar_t
 </sxh>
-Эта функция возвращает численное представление цвета по его имени во встроенной палитре или текстовому представлению. Палитра представляет собой почти точную копию таковой из [[http://doryen.eptalys.net/data/libtcod/doc/1.5.2/html2/color.html|libtcod]]. Имя задается в формате "[яркость ]оттенок", например "red", "light green" или "darker orange". Возможными значениями являются:
+Эта функция возвращает численное представление цвета по его имени во встроенной палитре или текстовому представлению. Имя задается в формате "[яркость ]оттенок", например "red", "light green" или "darker #905025".
-  * Яркость: lightest, lighter, light, dark, darker, darkest.
-  * Оттенок: grey (или gray), red, flame, orange, amber, yellow, lime, chartreuse, green, sea, turquoise, cyan, sky, azure, blue, han, violet, purple, fuchsia, magenta, pink, crimson, transparent.
-Функция **color_from_name** также может конвертировать в число строки вида "#FF0000" (шестнадцатиричная запись) и "16744448" (целое десятичное число, возможно со знаком). Если альфа-канал опущен или задан нулевым, цвет трактуется как полностью непрозрачный. Функция [[#print]] использует **color_from_name** для разбора названий цветов в тегах.
+Возможные значения яркости: lightest, lighter, light, dark, darker, darkest.
+Оттенок (базовый цвет) может быть указан несколькими способами:
+  * По имени: grey (или gray), red, flame, orange, amber, yellow, lime, chartreuse, green, sea, turquoise, cyan, sky, azure, blue, han, violet, purple, fuchsia, magenta, pink, crimson, transparent.
+  * В шестнадцатиричном формате: #RRGGBB or #AARRGGBB, например #80905025
+  * В десятичном формате, разделенном запятыми: R,G,B or A,R,G,B например 128,200,150,75
+  * Как форматированное в строку целое число, например 16744448
+Новые именованные цвета могут быть добавлены в палитру вызовом [[#set|set]]:
+<sxh cpp; toolbar: false; gutter: false;>
+terminal_set("palette.octarine = #50FF25");
+</sxh>
+Или посредством [[.:reference:configuration_|конфигурационного файла]]:
+<code>
+[Palette]
+lush = dark 80,255,37
+</code>
+Функция [[#print]] использует **color_from_name** для разбора названий цветов в тегах.
 ==== color_from_argb ====