*********************************************************************************
Редактор приборов
версия 1.0
(с) 2015 ВостокКод
Руководство пользователя
*********************************************************************************
1. Введение
Редактор приборов (далее - редактор) предназначен для создания файлов приборов,
используемых в Приборной Панели, основной программе комплекта.
2. Прибор
Приборы имеют свой размер, имя, номер и описание.
3. Слои прибора.
Каждый прибор состоит из слоев, от 0 до 15.
Под нулевой слой в процессе редактирования может быть подложен растровый
образцовый слой, поверх которого можно создать свой прибор, ориентируясь на образец.
На слои, кроме всего прочего, могут быть нанесены Шкалы и Индикаторы.
Каждый слой имеет свой размер, равный или отличающийся от общего размера прибора,
а также координаты сдвига от единой нулевой точки координат прибора.
Слои могут быт движущимися (в рамках размера прибора):
а) вращением
б) сдвигом по оси Х
в) сдвигом по оси Y
3.1. Подслои
Слои состоят из подслоев, выводящихся стопкой в следующем порядке
(а - самый нижний):
а) Векторный подслой
б) Подслой геометрической фигуры
в) Растровый подслой
г) Подслой надписей текста (до 64 на слой)
д) Подслой шкал
е) Подслой кадров
ж) Подслой индикаторов
Векторный подслой - .svg файл.
Подслой геометрической фигуры - могут быть залитые цветом окружность или
прямоугольник.
Растровый подслой - .bmp, .tif, .png, .gif, .jpg - файл
Подслой надписей - в настоящее время выводятся надписи шрифтами: ГОСТ тип А,
ГОСТ тип Б, Ариал.
Подслой шкал - на слой может быть одновременно наложено до 32 шкал.
Подслой кадров. Кадр - последовательность SVG изображений, имеющих параметр порога
вывода. Если в панели значение, переданное параметру равно или более порога - кадр
выводится.
Подслой индикаторов - на слой могут быть выведены одновременно до 32 индикаторов.
4. Шкалы
Шкала в приборе выступает в двух качествах (отдельно или одновременно):
а) Принцип перемещения слоя , т.е. смещение слоя по х и y, для заданного
входного значения.
б) Графическое представление принципа перемещения в виде отметок.
Т.е. слой может перемещаться по шкале, но шкала не выводится, или шкала выводиться,
а слой ни как не связан со шкалой, или - слой перемещается по видной шкале.
Шкалы возможны следующих типов:
а) Радиальная
б) Линейная вертикальная
в) Линейная горизонтальная
4.0 Основные параметры шкалы
а) dX, dY - координаты на слое
б) Начальное и конечное значение
в) (для радиальной шкалы) Начальный и конечный угол, а также радиус
г) Тип шкалы
д) Направление
е) Цвет RGBA
ж) Нелинейность
з) Максимум нелинейности
и) Множитель нелинейности
к) Цена деления
л) Множитель шага
4.1 Представление чисел
Шкала имеет свое внутреннее представление чисел, на котором она основана.
Это представление может отличаться от видимых чисел, нанесенных на шкалу.
В общем виде, для получения числа внутреннего представления нужно умножить
на 10 желаемое для видимой шкалы значение.
Например, мы хотели бы получить шкалу от 0 до 100.
Задаем начальное значение шкалы: 0, конечное: 1000
Можно этого и не делать и рисовать шкалу с полным соответствием, но тогда
ход слоя, привязанного к шкале (стрелки к примеру) не будет плавным.
В силу некоторых особенностей алгоритма, нужно прибавить еще примерно 5 к
конечному значению шкалы, для гарантированного вывода последнего деления.
(не 1000 а 1005 в последнем примере).
4.2 Деления
Шкала, кроме прочих параметров имеет Цену деления. Этот параметр влияет на
видимое представление шкалы.
Например - цена деления - 10. При рисовании шкалы от 0 до 1000 на
каждое десятое значение цикла будет поставлена отметка, одна из трех видов :
а) Большая отметка
б) Средняя отметка
в) Малая отметка
Для каждой зоны шкалы(см. ниже) может быть задана своя последовательность и
форма отметок.
4.3 Нелинейность
Шкала целиком или отдельно в каждой своей зоне может быть иметь нелинейную
характеристику. Это определяется 3 параметрами:
Нелинейность, Максимум нелинейности, Множитель нелинейности
4.4 Зонирование
Шкала может быть разбита на отдельные зоны (до 20), с отличающимися
параметрами.
Эти параметры:
а) Нелинейность
б) Максимум нелинейности
в) Множитель нелинейности
г) Цена деления
д) Множитель шага
е) Последовательность Больших, Средних и Малых отметок,
ж) Форма и сдвиг относительно оси рисования Больших, Средних и Малых отметок
Разбиение на зоны следует производить соответственно внутреннему представлению
чисел шкалы.
4.5 Видимые цифры
На шкале могут быть выведены цифровые надписи, рисующиеся около Больших отметок.
Задается начальное значение и шаг. Таким образом, можно нанести желаемые значения,
не соответствующие внутреннему представлению шкалы.
Кроме того можно выбрать размер шрифта, сдвиг от оси рисования шкалы и цвет.
Например, у нас шкала с внутренним представлением от 0 до 1000. А нужно
видеть шкалу с делениями 0, 10.... 100.
Мы задаем начальное значение цифровых надписей: 0, шаг: 10.
Для создания соответствия входного значения шкалы, который может совпадать
с рисуемым и внутреннего представления шкалы следует использовать множители
значений, задаваемые в Панели.
Если включен отладочный режим шкал, мы увидим рядом с Большими отметками
синие цифры, показывающие внутреннее представление шкалы.
При сложных вариантах зонирования цифры шкал лучше рисовать с помощью
отдельных надписей на слоях или - во внешнем SVG редакторе.
5. Индикаторы
На слои прибора могут быть нанесены многоразрядные индикаторы (до 32).
Параметры индикаторов:
а) Число разрядов
б) Масштаб по X и Y
в) Координаты на слое
Каждый разряд индикатора может быть иметь свой набор цифр (выбор из 4 наборов).
Наборы можно загружать в SVG виде.
Кроме отдельного набора цифр каждый разряд может иметь свое смещение по Х.
6. Передаваемые параметры
Прибору можно передать некоторое количество внешних параметров, которые будут
прибором использованы для вычислений.
Номера внешних параметров следует определить при создании прибора.
Это следующие параметры:
а) Параметр кадра слоя
б) Параметр шкалы вращения слоя
в) Параметр шкалы по Х слоя
г) Параметр шкалы по Y слоя
д) Параметр индикатора
6.1 Отладка параметров
В окне слоя присутствуют поля ввода темно-зеленого цвета. В этих
полях можно задать значение и множитель параметров:
а) подслоя кадра
б) связи со шкалами
В самом низу окна слоя можно задать циклическую посылку значения
на любой параметр.
7. Графический интерфейс пользователя
Программа работает в однооконном режиме, окно разбито на 4 основные части:
1) Слева вверху панель управления слоями: в ней расположены галочка
включения слоя-образца, галочки включения слоев прибора (0-15), радио кнопки выбора
текущего слоя.
2) Слева посередине окно, в котором выводится редактируемый прибор,
макс. размер - 640x640.
3) Справа панель, в котором располагаются кнопки выбора окон:
Слой, Шкала, Индикатор, Свойства. При нажатии на одну из кнопок
соответствующее окно появляется ниже кнопок.
4) Внизу панель блока подстройки значений экранных полей ввода.
7.0 Блок подстройки значений
При установке курсора на любое цифровое поле ввода в редакторе, значение
из поля передается блоку подстройки:
1) в самом центре блока появляется поле со значением выбранного экранного поля
2) Слева значения выводится название поля
3) Справа значения выводится возможный диапазон значений поля
4) На нижнем движке устанавливается масштабированное значение поля.
5) 4 кнопки по бокам движка приобретают значения малого и большого шага
увеличения/уменьшения значения поля. Этими кнопками можно точно подстроить
любое значение. А движком - грубо, но плавно.
Выше движка подстройки справа находятся кнопки диапазона изменений поля, они
меняют масштаб движка.
7.1 Полное описание элементов окна "Слой".
1) Поля "Д", "В" - длина и высота слоя
2) Поля "X", "Y" - сдвиг слоя относительно общей нулевой точки координат прибора
в верхнем левом углу
3) Элементы управления кадрового подслоя:
а) Галочка задействования кадрового подслоя
б) Кнопка "Кадр" - открывает диалог выбора последовательности кадров.
Кадры могут располагаться в любой папке ОС, называются 0.svg ... n.svg
в) Будет закружено и применено столько кадров, сколько указано
в поле "Всего".
г) Правее поля "Всего" находится список номеров кадров (0-127), номер
определяет текущий кадр
д) Поле "Порог" - порог значения, начиная с которого кадр выводится
е) Поле "Парам." - номер параметра прибора, с которым сравнивается порог
кадров
ж) Поля "mX", "mY" - масштабирование кадра по длине и высоте
з) Поля "dX", "dY" - сдвиг кадра внутри слоя
и) Поле "a" - степень прозрачности кадра
4) Элементы управления подслоя надписей:
а) Галочка задействования текущей надписи
б) Список номеров надписей, позволяет определить текущую
в) Поле "Шрифт" - размер шрифта, правее - поле гарнитуры шрифта
г) Поля RGBа - цвет надписи
д) Поля "dX", "dY" - сдвиг надписи внутри слоя
е) Большое поле без названия - текст надписи
5) Элементы управления подслоя растра:
а) Галочка задействования растрового подслоя
б) Кнопка "Растр" - открывает диалог выбора файла растра
(bmp, tif, png, gif, jpg - файл)
в) Поля "Д", "В" - длина и высота подслоя, загруженная картинка масштабируется
з) Поля "dX", "dY" - сдвиг подслоя внутри слоя
6) Элементы управления послоя фигуры:
а) Галочка задействования подслоя фигуры
б) Список видов фигур (Окружность/Прямоугольник)
в) Поля RGBа - цвет фигуры
г) Поля "Д", "В" - длина и высота фигуры
д) Поля "dX", "dY" - сдвиг подслоя внутри слоя
7) Элементы управления векторного подслоя :
а) Галочка задействования векторного подслоя
б) Кнопка "Вектор" - открывает диалог выбора векторного файла (svg - файл)
г) Поля "mX", "mY" - масштабирование вект. картинки по длине и высоте
д) Поля "dX", "dY" - сдвиг подслоя внутри слоя
е) Поле "a" - степень прозрачности вект. картинки
8) Элементы управления связи слоя со шкалой вращения:
а) Галочка задействования шкалы вращения
б) Поле номера шкалы
в) Поле "Парам." - номер параметра прибора, который передается шкале
г) Поля "cX" , "cY" - координаты точки вращения, (сдвиг от В.Л. угла слоя)
д) Поля "Знач." и "Множ." - отладочное посылание значения шкале
9) Элементы управления связи слоя с линейной шкалой по X координате:
а) Галочка задействования шкалы по Х
б) Поле номера шкалы
в) Поле "Парам." - номер параметра прибора, который передается шкале
д) Поля "Знач." и "Множ." - отладочное посылание значения шкале
10) Элементы управления связи слоя с линейной шкалой по Y координате:
а) Галочка задействования шкалы по Y
б) Поле номера шкалы
в) Поле "Парам." - номер параметра прибора, который передается шкале
д) Поля "Знач." и "Множ." - отладочное посылание значения шкале
11) Поля "Запомнить слой" и "Вставить слой" - буфер обмена слоев
12) Элементы управления отладочного циклического посылания значения
приборному параметру :
а) Галочка "Цикл" задействования посылания
в) Поле "Парам." - номер параметра , которому посылается значение
г) Поля "Нач." и "Кон." - начало и конец цикла
д) Поля "Шаг" и " Множ." - шаг цикла и множитель значения
7.2 Полное описание элементов окна "Шкала".
1) Список номеров шкал, позволяет определить текущую.
2) Список слоев визуального нанесения текущей шкалы.
3) Поля "dX", "dY" - сдвиг шкалы внутри слоя
4) Поля "Нач. зн", "Кон. зн" - начальное и конечное значения шкалы во внутр.
представлении
5) Поля "Нач. угол", "Кон. угол" - начальные и конечные значения угла
рисования радиальной шкалы, посылаемые алгоритму рисования. В зависимости
от прочих параметров алгоритма, конечный угол рисования может не совпасть
с конечным значением
6) Поле "Радиус" - радиус рисования радиальной шкалы, от этого значения будут
отсчитываться сдвиги отметок.
7) Список типов шкал (Радиальная, Вертикальная, Горизонтальная)
8) Список вариантов направления линейных шкал (Вверх/вправо, Вниз/влево)
Для радиальной шкалы список также имеет действие - вправо/влево инвертирует
угол рисования.
8) Элементы управления цифровыми надписями шкалы:
а) Галочка "Цифры" - разрешение рисовать цифры
б) Поле "Начало" - начальное значение шкалы
г) Поле "Шаг" - шаг увеличения следующего значения
д) Поле "Шрифт" - размер шрифта. Правее поле выбора гарнитуры шрифта,
( В настоящей версии не задействовано, цифры рисуются шрифтом ГОСТ тип Б)
е) Поле "Сдвиг" - сдвиг цифр относительно линии рисования шкалы
9) Элементы управления дополнительными отметками ( В настоящей версии не
задействованы)
10) Элементы управления выбора и определения зон шкалы, состоят из 20
одинаковых связок — радио кнопка выбора + поле начала зоны шкалы во внутреннем
представлении
11) Кнопки "Запомнить зону", "Вставить зону" - буфер обмена зон
12) Элементы управления отметками (внутри зоны), для Больших, Средних и Малых
отметок одинаково:
а) Поле числа отметок (Больших всегда: 1)
б) Список типа отметки ( В настоящей версии не задействовано)
в) Поля "mX", "mY" - масштабирование отметки
в) Поле "Сд" - сдвиг отметки относительно оси рисования шкалы
13) Элементы управления алгоритмом шкалы (независимо от типа):
а) Поле "Нелинейность" - нелинейность приращения шкалы, при 0 - шкала линейна
б) Поле "Макс. нелинейности" - определяет место применения нелинейности при
отр. начальных значениях шкалы
в) Поле "Множ. нелин." - множитель нелинейности, параметр подстройки
нелинейных шкал
г) Поле "Множ. нелин.2" - множитель нелинейности, параметр подстройки
нелинейных шкал ( В настоящей версии не задействовано)
д) Список "Формула" - типы алгоритмов нелинейности ( В настоящей версии
не задействовано)
е) Поле "Цена деления" - шаг, через который на шкале ставится очередная отметка.
Последовательность рисования Б., С., и М. отметок задается в полях упр.
отметками (см. выше п.12)
е) Поле "Шаг шкалы" - параметр подстройки шкалы, расстояние между отметками
ж) Поле "Множитель шага" - Шаг шкалы делится на это значение
7.3 Полное описание элементов окна "Индикатор".
1) Список номеров индикаторов, позволяет определить текущий.
2) Список слоев нанесения текущего индикатора.
3) Поле "Число разрядов" - число разрядов индикатора (до 24)
4) Поля "mX", "mY" - масштабирование индикатора
5) Поля "dX", "dY" - сдвиг индикатора внутри слоя
6) Поле "Парам." - номер параметра прибора, который передается индикатору
7) Элементы управления разрядами индикатора:
а) Список "Разряд" - номера разрядов индикатора , позволяет определить текущий.
б) Список "Тип" - номер набора цифр, для текущего разряда (один из 4) наборов
Исходно наборы загружаются из папки Редактора, но можно загрузить собственные
наборы
г) Поле "Смещение" - смещение по Х рисования текущего разряда
8) Элементы управления загрузкой наборов цифр:
а) Кнопка "Набор цифр" - открывает диалог выбор файла набора.
Файл набора - svg рисунок последовательности цифр от 0 до 9 слева на право.
б) Список номеров набора, позволяет определить загружаемый
в) Поле , показывающее файл загруженного набора
7.4 Полное описание элементов окна "Свойства".
1) Поля "Длина" и "Высота" - размеры прибора ( мин. - 32, макс. - 640)
2) Галочка "Границы слоев" - позволяет отображать границы слоев, что актуально для
отсечения прозрачных или просто ненужных областей слоя, которые не задействуются.
Это важно для сохранения производительности прибора, во избежание лишнего
рисования.
Текущий слой окаймляется светло-зелеными линиями, прочие - темно зелеными.
Также отображается крестик в центре радиальной шкалы, если она
применена к слою.
3) Галочка "Отл. отметки шкалы" - позволяет отображать для шкал:
а) Точку центра шкалы, а также верт. и гор. линии, проходящие через эту точку.
Эти линии светло-красные, если выбрана текущая шкала, иначе - темно-красные.
б) Возле Больших отметок шкалы рисуются темно-синие цифры, показывающие значение
шкалы на эту отметку во внутреннем представлении
в) Показываются границы и номера зон шкалы с помощью линии, и темно-синей цифрой
номера зоны в конце линии
4) Кнопка "Имя прибора" - при нажатии разрешается изменение имени прибора в поле
справа от кнопки
5) Кнопка "Номер прибора" - при нажатии разрешается изменение номера прибора в поле
справа от кнопки. Диапазон номеров: 0 - 9999999999999999999
6) Поле "Описание" - позволяет сохранить описание-комментарий к прибору.
7) Кнопка "Слой-образец" - открывает диалог загрузки образцового слоя,
подкладываемого под прибор. Слой включается галочкой "Обр." в панели управления
слоями
8) Кнопка "Снимок" - сохраняет сохранить в виде графического .bmp файла вывод
прибора в настоящий момент редактирования. Это можно использовать, например, для
создания слоя с более аутентичными для желаемого прибора отметками в svg
редакторе на основе снимка, поскольку будут видны точные позиции отметок
(и, в случае радиальной шкалы - центр шкалы).
Папка -\GRAF\Redaktor\Snimok
9) Кнопка "Новый" - позволяет начать рисовать новый прибор, номер прибора
генерируется случайный, предыдущий прибор чаастично очищается, если не отмечена
галочка "Из наст."
10) Кнопка "Загрузить" - открывает диалог загрузки .pri файла прибора.
11) Кнопка "Сохранить" - открывает диалог сохранения .pri файла прибора.
Это - файл прибора с возможностью редактирования, в нем сохраняются все данные
прибора, вне зависимости от их задействованности в окончательном приборе.
12) Кнопка "Сохранить как прибор" - открывает диалог сохранения .prb файла прибора.
Этот файл пригоден для использования в Приборной Панели, он оптимизирован,
используются только те слои, что были включены на момент записи.
************************************************************************************
