Команды: Глобальные параметры

Глобальные параметры не являются свойствами какого-либо объекта. Их действие распространяется на все объекты, в том числе на все слайды.

DefColor color = rgb
DefColor color = rgb [ .. color2 = rgb2 ]

Добавить в палитру цвет с номером color, заданный описанием rgb.

Описание цвета rgb представляет собой либо список трёх чисел R,G,B через запятую (R-красный, G-зелёный, B-синий), либо целочисленный код, заданный десятичным числом или шестнадцатиричным в формате 0xBBGGRR (как в языке С). Если color<27, команда изменяет стандартный предопределённый цвет.

Вторая форма команды определяет в палитре диапазон ячеек с номерами от color до color2 включительно, заполняя их цветами, равномерно переходящими от rgb до rgb2.

DefColorHSV color = hsv
DefColorHSV color = hsv [ .. color2 = hsv2 ]

Команда аналогична DefColor, но цвет задаётся триплетом hue, saturation, value.

DefFont style = library : family , width x height , flags , charset

Создание или модификация стиля шрифта style. По умолчанию в палитре определены 8 стандартных шрифтов:
1 = title — шрифт для заголовка,
2 = name — шрифт для названий осей,
3 = label — шрифт для меток осей,
4 = info — шрифт для надписей на графике,
5 = inside — шрифт для надписей внутри точек TI,
6 = near — шрифт для надписей около точек TN,
7 = right — шрифт для комментария TR,
8 = status — шрифт для статусной строки,

library
Имя шрифтовой библиотеки, зависящее от операционной системы и текущей реализации ChartLib. Каждому стилю style должен соответствовать определённый шрифт в каждой библиотеке library. Параметр не может быть опущен. В настоящей версии поддерживаются две библиотеки шрифтов:

Win — шрифты Windows, используемые при рисовании в окне и файле EMF или BMP;
Clf — шрифты собственного внутреннего формата CLF (ChartLive Font), используемые при формировании файлов PNG или JPEG. Это растровые шрифты с антиалиасингом, которые должны быть предварительно сгенерированы с помощью утилиты ttf2clf, входящей в состав дистрибутива ChartLive. Директория, в которой находятся эти шрифты, должна быть прописана в переменной среды CLFONTSDIR или установлена командой CLFontsDir.

family
Название семейства шрифта, принятое в данной шрифтовой библиотеке library. Для библиотеки Clf это имя файла, содержащего шрифт (расширение обязательно, возможно также указать полный путь).

width
Ширина символов в пикселах. Если параметр width опущен или равен нулю, выбирается пропорциональный шрифт.

height
Высота символов в пикселах.

flags
Флаги дополнительных свойств шрифта, кодируемые буквами:

N — нормальный,
B — жирный,
b — полужирный,
I — наклонный,
U — подчёркнутый,
S — перечёркнутый,
L — вертикальная надпись, читаемая слева,
R — вертикальная надпись, читаемая справа,
V — вертикальная надпись, читаемая сверху вниз.
Если параметр flags опущен, выбирается нормальный шрифт.

charset
Символьный набор, из списка: ANSI, DEFAULT, OEM, MAC, SYMBOL, BALTIC, CHINESEBIG5, EASTEUROPE, GB2312, GREEK, HANGUL, RUSSIAN, SHIFTJIS, TURKISH, JOHAB, HEBREW, ARABIC, THAI.
Если параметр charset опущен, предполагается ANSI.

Пример:

#DefFont title = Win: Arial Narrow, 0x16, b, RUSSIAN
#DefFont title = Clf: Courier9x15BI.clf, 9x15, BI

CLFontsDir = path

Имя директории, в которой находятся CLF-шрифты. Имя обязано заканчиваться разделителем \ или /.

По умолчанию при инициализации библиотеки делается попытка прочитать это имя из переменной среды CLFONTSDIR. Если такая переменная не установлена, то CLF-шрифты будут считываться из текущей директории. Если в текущей директории CLF-шрифты отсутствуют, то надписи на формируемых изображениях формата PNG и JPEG будут отсутствовать.

DefStyle = style_name

Начать определение стиля с именем style_name. Все последующие команды вплоть до первой EndStyle или DefStyle будут не исполняться, а запоминаться в списке команд стиля.

Запомненный список команд (стиль) может быть применён в дальнейшем к любой области, в том числе к слайду, с помощью команды Style.

EndStyle

Закончить определение стиля.

Совет: Важно не забыть эту команду в конце определения стиля. Иначе все последующие команды будут не выполняться, а запоминаться в стиле.

DefaultButton oper = butt

Переопределить стандартное функционирование кнопок мыши при выполнении операции oper со всеми объектами. Имя операции oper может принимать следующие значения:
Shift — сдвиг (графика или оси);
Zoom — масштабирование (графика или оси);
Select — выбор (точки на графике);
Activate — активизация (точки на графике);
Execute — запуск команды (соответствующей точке на графике);
Ignore — игнорировать нажатие.
Комбинация кнопок butt может принимать следующие значения (при совмещении нескольких кнопок значения отделяются запятой или плюсом): shift, alt, ctrl, left, right, middle, double.

Стандартное функционирование кнопок для всех объектов:

#DefaultButton Shift = right
#DefaultButton Zoom = left
#DefaultButton Select = shift+left
#DefaultButton Activate = left
#DefaultButton Execute = left
#DefaultButton Ignore = ctrl,alt,middle
Стандартное функционирование кнопок может быть изменено для каждого объекта в отдельности аналогичной командой Button.

Совет: При использовании возможности запуска точек (свойство TE) рекомендуется переопределить #Button Activate=right, чтобы избежать одновременного выполнения функций Activate и Execute.

Syntax = usage1 {symbols1} ... usageN {symbolsN}

Установить синтаксис входного потока данных. Каждому символу строки symbolsi назначается роль usagei. Роли задаются однобуквенными кодами:
C — допустимые символы начала управляющей команды;
N — допустимые символы-разделители десятичных знаков в числах;
T — допустимые символы-разделители часов-минут-секунд;
D — допустимые символы-разделители дня-месяца-года;
F — допустимые символы-разделители полей в строках данных;
Q — два символа для левой и правой кавычки в строках данных;
E — обозначение пустого поля (empty) во входных данных;
Разделители N, T, D, F и Q должны быть различными.

В строках symbolsi разрешается указывать непечатные спецсимволы.

По умолчанию входной синтаксис задан командой

#Syntax = C{#} N{.} T{:} D{/} Q{""} F{\t,} E{???}

Locale = text

Установить локализацию (установки страны и языка) по правилам функции setlocale языка C. Строка описания text может принимать значения eng, rus, american, deu, fra, и другие. Данная команда влияет только на формат вывода чисел и дат. Формат ввода устанавливается командой Syntax.

Encoding = char

Указывает кодировку входного потока строк. Символ char может принимать следуюшие значения:
W — кодировка Windows CP-1251,
D — кодировка DOS альтернативная,
K — кодировка KOI-8,
I — кодировка ISO-8859-5.
Если параметр не задан, строки входного потока не перекодируются.

OutEncoding = char

Указывает выходную кодировку при формировании таблиц и выдаче информации о точках графика. По умолчанию W.

SystemDate = date
SystemDate = today

Дата, устанавливаемая автоматически для значений типа дата/время, если указано только время. Если параметр SystemDate не задан, по умолчанию берётся системная (сегодняшняя) дата. Тот же эффект достигается второй формой команды.

About = text

Текст, выводимый в статусную строку по окончании размещения слайда.