OpenSCADAWiki: Doc/VCA/part4/part12 ...

Примитив является основой для отрисовки элементарных графических фигур со всевозможной комбинацией их в одном объекте. Предусматривается поддержка следующих элементарных фигур:

• Линия.
• Дуга.
• Кривая безье.
• Заливка замкнутого пространства.

Для всех фигур, содержащихся в виджете, устанавливаются единые свойства толщины, цвета и т.д., но это не исключает возможность указания вышеперечисленных атрибутов для каждой фигуры отдельно.

Включает поддержку стандартных компонентов формы:

• Редактирование строки.
• Редактирование текста.
• Флажок.
• Кнопка.
• Выбор из списка.
• Список.
• Дерево.
• Таблица.
• Слайдер.
• Строка прокрутки.

Права доступа к виджету в форме "{польз.}{группа}{другие}" плюс флаг наследования, включающий наследование владельца и его прав от вышестоящего виджета.
Где "польз.", "группа" и "другие" это:

• "__" — нет доступа;
• "R_" — только на чтение;
• "RW" — чтение и запись.

По умолчанию 01000(наследование).

Контекстное меню в форме списка строк: "{ItName}:{Signal}".
Где:

• "ItName" — имя элемента;
• "Signal" — имя сигнала, формирующее сигнал: "usr_{Signal}".

Атрибут для хранения сценария обработки событий непосредственного управления пользовательским интерфейсом. Сценарий представляет собой список команд интерфейсу визуализации, генерируемых при поступлении события (атрибут event). Прямая обработка событий для управления страницами в форме: "{event}:{evSrc}:{com}:{prm}". Где:

• "event" — ожидаемое событие;
• "evSrc" — источник события;
• "com" — команда сеанса (open, next, prev);
• "prm" — параметр команды, где используется:
  • pg_so — прямое имя желаемой страницы с префиксом;
  • 1 — имя новой страницы в общем пути, без префикса;
  • * — имя страницы берётся из имени предыдущей страницы;
  • $ — указывает на место относительно которого открывается страница.

Примеры:

• ws_BtPress:/prev:prev:/pg_so/*/*/$
• ws_BtPress:/next:next:/pg_so/*/*/$
• ws_BtPress:/go_mn:open:/pg_so/*/mn/*
• ws_BtPress:/go_graph:open:/pg_so/*/ggraph

Имя цвета в виде "{color}[-{alpha}]", где:

• "color" — стандартное имя цвета или числовое представление из трёх шестнадцатеричных чисел цвета "#RRGGBB";
• "alpha" — уровень альфа-канала [0...255], где 0 — полностью прозрачный.

Примеры:

• "red" — сплошной красный цвет;
• "#FF0000" — сплошной красный цвет в цифровом коде;
• "red-127" — полупрозрачный красный цвет.

Имя изображения в форме "[{src}:]{name}", где:

• "src" — источник изображения:
  • file — прямо из локального файла по пути;
  • res — из таблицы mime ресурсов БД.
• "name" — путь файла или идентификатор mime-ресурса.

Примеры:

• "res:backLogo" — из таблицы mime ресурсов БД для идентификатора "backLogo";
• "backLogo" — как и предыдущий;
• "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".

Список графических примитивов в формате:

• Линия, форма записи в списке, для статических и динамических параметров (могут смешиваться):
  "line:({x}|{y}):({x}|{y})[:{width}[:{color}[:{bord_w}[:{bord_clr}[:{line_stl}]]]]]"
  "line:{p1}:{p2}[:w{n}[:c{n}[:w{n}[:c{n}[:s{n}]]]]]"
  
• Дуга, форма записи в списке, для статических и динамических параметров (могут смешиваться):
  "arc:({x}|{y}):({x}|{y}):({x}|{y}):({x}|{y}):({x}|{y})[:{width}[:{color}[:{bord_w}[:{bord_clr}[:{line_stl}]]]]]"
  "arc:{p1}:{p2}:{p3}:{p4}:{p5}[:w{n}[:c{n}[:w{n}[:c{n}[:s{n}]]]]]"
  
  
  p1, p2 — начальная и конечная точки эллиптической дуги соответственно;
  p3 — центр дуги;
  p4 — первый радиус;
  p5 — второй радиус.
  
• Кривая Безье, форма записи в списке, для статических и динамических параметров (могут смешиваться):
  "bezier:({x}|{y}):({x}|{y}):({x}|{y}):({x}|{y})[:{width}[:{color}[:{bord_w}[:{bord_clr}[:{line_stl}]]]]]"
  "bezier:{p1}:{p2}:{p3}:{p4}[:w{n}[:c{n}[:w{n}[:c{n}[:s{n}]]]]]"
  
• Заливка, форма записи в списке, для статических и динамических параметров (могут смешиваться):
  "fill:({x}|{y}):({x}|{y}):...:({x}|{y})[:{fill_clr}[:{fill_img}]]"
  "fill:{p1}:{p2}:...:{pN}[:c{n}[:i{n}]]"

Где:

Например:

• line:(50|25):(90.5|25):2:yellow:3:green:2
• arc:(25|50):(25|50):1:4:(25|50)::#000000-0
• fill:(25|50):(25|50):c2:i2
• fill:(50|25):(90.5|25):(90|50):(50|50):#d3d3d3:h_31

Конфигурация строки. Формат значения данного поля для различных видов строки:

Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:

• "family" — семейство шрифта, для пробелов используйте символ '_', вроде: "Arial", "Courier", "Times_New_Roman";
• "size" — размер шрифта в пикселах;
• "bold" — усиление шрифта (0 или 1);
• "italic" — наклонность шрифта (0 или 1);
• "underline" — подчёркивание шрифта (0 или 1);
• "strike" — перечёркивание шрифта (0 или 1).

Примеры:

• "Arial 10 1 0 0 0" — Arial шрифт размером 10 пикселов и усиленный.

Значение, отличается для разных режимов:

• "Стандарт" — параметры повтора событий при удержании "{задержка}-{интервал}", время миллисекундах;
• "Переключатель" — значение переключателя;
• "Меню" — список адресов элементов меню вида "/grp1/grp2/item1";
• "Загрузка" — строка описания "{ШаблонФайлов}|{Заголовок}|{ФайлПоУмолчанию}" и содержимое загруженного файла. Шаблон файлов в виде "Изображение (*.png *.xpm *.jpg);;CSV-файл (*.csv)".
• "Сохранение" — строка описания "{ШаблонФайлов}|{Заголовок}|{ФайлПоУмолчанию}" и содержимое сохраняемого файла. Шаблон файлов как и выше.

Изображение на кнопке. Имя изображения в форме "[{src}:]{name}", где:

• "src" — источник изображения:
  • file — прямо из локального файла по пути;
  • res — из таблицы mime ресурсов БД.
• "name" — путь файла или идентификатор mime-ресурса.

Примеры:

• "res:backLogo" — из таблицы mime ресурсов БД для идентификатора "backLogo";
• "backLogo" — как и предыдущий;
• "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".

Цвет кнопки. Имя цвета в виде "{color}[-{alpha}]", где:

• "color" — стандартное имя цвета или числовое представление из трёх шестнадцатеричных чисел цвета "#RRGGBB";
• "alpha" — уровень альфа-канала [0...255].

Примеры:

• "red" — сплошной красный цвет;
• "#FF0000" — сплошной красный цвет в цифровом коде;
• "red-127" — полупрозрачный красный цвет.

Режим работы кнопки:

• "Стандарт" — обычная кнопка с возможностью повтора событий при удержании (параметры в "value");
• "Переключатель" — кнопка с фиксацией (значение в "value");
• "Меню" — открытие меню по нажатию (перечень элементов в "value");
• "Загрузка" — организация пользовательской загрузки небольших файлов через интерфейс визуализации; при нажатии кнопки в этом режиме открывается диалог выбора файла для загрузки, а содержимое выбранного файла загружается в атрибут "value";
• "Сохранение" — организация пользовательского сохранения небольших файлов через интерфейс визуализации; при записи содержимого файла в атрибут "value" пользователю будет открыт диалог выбора/указания файла для сохранения, после выбора содержимое атрибута "value" сохранится в файл, а "value" очистится.

Адрес выбранного элемента. Изменение сопровождается сигналом "ws_TableChangeSel". Формат адреса зависит от режима выбора таблицы:

• "Ячейка" — адрес ячейки в формате "{row}:{col}".
• "Строка", "Колонка" — номер строки-колонки или содержимое ячейки ключа строки-колонки, указанной атрибутом "keyID".

Структура и содержимое таблицы в виде XML:

Теги:

Конфигурация слайдера в формате: "{ВертОриент}:{Минимум}:{Максимум}:{ОдинШаг}:{СтрШаг}".
Где:

• "ВертОриент" — признак вертикальной ориентации (0 или 1), по умолчанию ориентация горизонтальная;
• "Минимум" — минимальное значение;
• "Максимум" — максимальное значение;
• "ОдинШаг" — размер одного шага;
• "СтрШаг" — размер страничного шага.

Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:

• "color" — стандартное имя цвета или числовое представление из трёх шестнадцатеричных чисел цвета "#RRGGBB";
• "alpha" — уровень альфа-канала [0...255], где 0 - полностью прозрачный.

Примеры:

• "red" — сплошной красный цвет;
• "#FF0000" — сплошной красный цвет в цифровом коде;
• "red-127" — полупрозрачный красный цвет.

Фоновое изображение. Имя изображения в форме "[{src}:]{name}", где:

• "src" — источник изображения:
  • file — прямо из локального файла по пути;
  • res — из таблицы mime ресурсов БД.
• "name" — путь файла или идентификатор mime-ресурса.

Примеры:

• "res:backLogo" — из таблицы mime ресурсов БД для идентификатора "backLogo";
• "backLogo" — как и предыдущий;
• "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".

Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:

• "family" — семейство шрифта, для пробелов используйте символ '_', вроде: "Arial", "Courier", "Times_New_Roman";
• "size" — размер шрифта в пикселах;
• "bold" — усиление шрифта (0 или 1);
• "italic" — наклонность шрифта (0 или 1);
• "underline" — подчёркивание шрифта (0 или 1);
• "strike" — перечёркивание шрифта (0 или 1).

Примеры:

• "Arial 10 1 0 0 0" — Arial шрифт размером 10 пикселов и усиленный.

Конфигурация аргумента x:

• "Строка": {len} — ширина строки;
• "Вещественный": {wdth};{form};{prec} — ширина значения, форма значения ('g', 'e', 'f') и точность;
• "Целый": {len} — ширина значения.

Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:

• "color" — стандартное имя цвета или числовое представление из трёх шестнадцатеричных чисел цвета "#RRGGBB";
• "alpha" — уровень альфа-канала [0...255], где 0 - полностью прозрачный.

Примеры:

• "red" — сплошной красный цвет;
• "#FF0000" — сплошной красный цвет в цифровом коде;
• "red-127" — полупрозрачный красный цвет.

Фоновое изображение. Имя изображения в форме "[{src}:]{name}", где:

• "src" — источник изображения:
  • file — прямо из локального файла по пути;
  • res — из таблицы mime ресурсов БД.
• "name" — путь файла или идентификатор mime-ресурса.

Примеры:

• "res:backLogo" — из таблицы mime ресурсов БД для идентификатора "backLogo";
• "backLogo" — как и предыдущий;
• "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".

Имя источника медиа в форме "[{src}:]{name}", где:

• "src" — источник:
  • file — прямо из локального (визуализатор и движок) файла по пути;
  • res — из таблицы mime ресурсов БД;
  • stream — URL потока проигрывания видео или аудио.
• "name" — путь файла или идентификатор mime-ресурса.

Примеры:

• "res:workMedia" — из таблицы mime ресурсов БД для идентификатора "workMedia";
• "workMedia" — как и предыдущий;
• "file:/var/tmp/workMedia.mng" — из локального файла по пути "/var/tmp/workMedia.mng";
• "stream:http://localhost.localhost:5050" — проигрывание видео или аудио из URL.

Тип медиа, вариант:

• "Изображение" — растровое или векторное(может не поддерживаться) изображение, вроде: PNG, JPEG, GIF, SVG;
• "Анимация" — простое анимированное изображение, вроде: GIF, MNG;
• "Полное видео" — полное видео, аудио или поток, вроде: OGG, OGM, AVI, MKV, MPG, MP3, MP4.

Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:

• "color" — стандартное имя цвета или числовое представление из трёх шестнадцатеричных чисел цвета "#RRGGBB";
• "alpha" — уровень альфа-канала [0...255], где 0 - полностью прозрачный.

Примеры:

• "red" — сплошной красный цвет;
• "#FF0000" — сплошной красный цвет в цифровом коде;
• "red-127" — полупрозрачный красный цвет.

Фоновое изображение. Имя изображения в форме "[{src}:]{name}", где:

• "src" — источник изображения:
  • file — прямо из локального файла по пути;
  • res — из таблицы mime ресурсов БД.
• "name" — путь файла или идентификатор mime-ресурса.

Примеры:

• "res:backLogo" — из таблицы mime ресурсов БД для идентификатора "backLogo";
• "backLogo" — как и предыдущий;
• "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".

Шрифт маркеров шкалы/решетки. Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:

• "family" — семейство шрифта, для пробелов используйте символ '_', вроде: "Arial", "Courier", "Times_New_Roman";
• "size" — размер шрифта в пикселах;
• "bold" — усиление шрифта (0 или 1);
• "italic" — наклонность шрифта (0 или 1);
• "underline" — подчёркивание шрифта (0 или 1);
• "strike" — перечёркивание шрифта (0 или 1).

Примеры:

• "Arial 10 1 0 0 0" — Arial шрифт размером 10 пикселов и усиленный.

Полный адрес к атрибуту параметра X DAQ или архиву.
Также поддерживается прямая установка данных по префиксу:

• "data:{XMLNodeData}" — отрисовка из прямо установленных данных;
• "line:{значение}" — отрисовка горизонтальной линии по значению, не имеет смысла для типа "XY".

Пример:

• "/DAQ/System/AutoDA/MemInfo/use" — адрес к атрибуту "use" параметра "MemInfo" контроллера "AutoDA" DAQ модуля "System";
• "/Archive/va_CPULoad_load" — адрес к архиву "CPULoad_load";
• "data:<d s="1" aprox="1" tm="1369465209" tm_grnd="1369465200" per="1">

• "line:3.14159265" — горизонтальная линия по значению "3.14159265".

Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:

• "color" — стандартное имя цвета или числовое представление из трёх шестнадцатеричных чисел цвета "#RRGGBB";
• "alpha" — уровень альфа-канала [0...255], где 0 - полностью прозрачный.

Примеры:

• "red" — сплошной красный цвет;
• "#FF0000" — сплошной красный цвет в цифровом коде;
• "red-127" — полупрозрачный красный цвет.

Фоновое изображение. Имя изображения в форме "[{src}:]{name}", где:

• "src" — источник изображения:
  • file — прямо из локального файла по пути;
  • res — из таблицы mime ресурсов БД.
• "name" — путь файла или идентификатор mime-ресурса.

Примеры:

• "res:backLogo" — из таблицы mime ресурсов БД для идентификатора "backLogo";
• "backLogo" — как и предыдущий;
• "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".

Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:

• "family" — семейство шрифта, для пробелов используйте символ '_', вроде: "Arial", "Courier", "Times_New_Roman";
• "size" — размер шрифта в пикселах;
• "bold" — усиление шрифта (0 или 1);
• "italic" — наклонность шрифта (0 или 1);
• "underline" — подчёркивание шрифта (0 или 1);
• "strike" — перечёркивание шрифта (0 или 1).

Примеры:

• "Arial 10 1 0 0 0" — Arial шрифт размером 10 пикселов и усиленный.

Шаблон категории или регулярное выражение "/{re}/". Для шаблона зарезервированы символы:

• '*' — множество любых, группа символов;
• '?' — любой, один символ;
• '\\' — используйте для экранирования специальных символов.

Список видимых и порядок колонок, разделённый символом ';'. Предусматриваются колонки:

• "pos" — номер строки;
• "tm" — дата и время сообщения;
• "utm" — микросекундная часть времени сообщения;
• "lev" — уровень сообщения;
• "cat" — категория сообщения;
• "mess" — текст сообщения.

Базовый шрифт текста документа. Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:

• "family" — семейство шрифта, для пробелов используйте символ '_', вроде: "Arial", "Courier", "Times_New_Roman";
• "size" — размер шрифта в пикселах;
• "bold" — усиление шрифта (0 или 1);
• "italic" — наклонность шрифта (0 или 1);
• "underline" — подчёркивание шрифта (0 или 1);
• "strike" — перечёркивание шрифта (0 или 1).

Примеры:

• "Arial 10 1 0 0 0" — Arial шрифт размером 10 пикселов и усиленный.

Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:

• "color" — стандартное имя цвета или числовое представление из трёх шестнадцатеричных чисел цвета "#RRGGBB";
• "alpha" — уровень альфа-канала [0...255], где 0 - полностью прозрачный.

Примеры:

• "red" — сплошной красный цвет;
• "#FF0000" — сплошной красный цвет в цифровом коде;
• "red-127" — полупрозрачный красный цвет.

Фоновое изображение. Имя изображения в форме "[{src}:]{name}", где:

• "src" — источник изображения:
  • file — прямо из локального файла по пути;
  • res — из таблицы mime ресурсов БД.
• "name" — путь файла или идентификатор mime-ресурса.

Примеры:

• "res:backLogo" — из таблицы mime ресурсов БД для идентификатора "backLogo";
• "backLogo" — как и предыдущий;
• "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".