EasyGraf - это простой графический редактор, которым можно рисовать все важные геометрические фигуры. Текст источника - это текстовый файл со строчными командами. Тип файла должен быть ".grf" или ".grfk" (файл для программы "Kurven"). Преимущество программы (и причина ей создания) состоит в том, что простой входной язык легко может производиться маленькими программами (например, в Бейсик, Турбо Паскаль или Delphi) или вводить с помощью клавиатуры, так что возможно решение специальных графических задач более просто и быстро. Примерами являются программы "Kurven" для отображения кривых и "V_Smith" для создания шаблонов Smith-диаграмм (техника СВЧ). Обе программы входят в пакет загрузки. Величина исходных файлов очень незначительна, даже при обширных представлениях она составляет только примерно 1/30 величины Bitmap. Их можно удобно включать в данные инициализации других графических программ, например, виртуального осциллоскопа или части графического узла программы анализа сети (см. также исходные файлы пакета "Ekran"). Первые версии EasyGraf были основаны на командных строках. Позже программа была дополнена возможностью графического редактирования наиболее важных элементов. В версии 2.3 была добавлена возможность вывода плоттера (плоттер типа Robotron K6418). В версии 2.4 с помощью Ini-файла была добавлена возможность установки стандартных значений и интерфейса плоттера, так что можно использовать и другие типы плоттеров. 1. Основной принцип работы программыПрограмма имеет друг над другом прозрачный основной дисплей с фоном и над ним прозрачный вспомогательный дисплей. Цвет фона можно устанавливать EasyGraf-командой (по умолчанию белый). Однако, он может изменяться командой в графических данных (командой "BG"). На основном дисплее изображаются графические объекты по данным файла. На вспомогательном дисплее можно интерактивно редактировать графические элементы и затем принимать в текст источника.Источник EasyGraf - это редактируемый файл командных строк. Каждая команда (элемент) занимает одну строку. Строки комментариев, (начинающиеся с ";") и пустые строки зачитываются. Команды - это первые 2 символа строки. Каждая строка может быть завершена точкой с запятой, после которой может следовать любой текст комментария, но он не должен содержать ещё точку с запятой. Из постановки задачи для программы получается логически, что работают, как правило, при помощи двух окон одновременно, с графическим экраном (дисплей на рабочем столе программы) и с текстом источника (окно с текстовым редактором). Рис. 1 показывает оба окна перекрытыми.  рис. 1 2. Координатная система
Основой для рисования на дисплее, размеры которого зависят от выбранного формата (см. ниже), являются системы координат. Существует две системы (см. рис. 2). Для форматов 0 ... 3 по умолчанию включена "
система с плавающей точкой"
, для формата 4 возможны только пиксельные координаты, поскольку единица измерения не определена. Нулевая точка координат находится внизу слева. Максимальное разрешение (= 1 пиксель) можно увидеть в таблице 1. Координаты задаются в виде чисел с плавающей точкой. Вторая система работает с пикселями. Нулевая точка координат находится в левом верхнем углу. Координаты или радиусы должны быть указаны как целые числа. Переход от системы с плавающей точкой к пиксельной системе осуществляется с помощью команды "PK"
. При пиксельных координатах положительное направление по оси Y идет сверху вниз, соответственно, направление для угловых спецификаций также обратное. Переход от пиксельной системы к системе с плавающей точкой осуществляется с помощью команды "FK". После такой команды установленная система действует до следующей команды переключения, или до команды "NP", или до команды "IN", или до конца файла. Для ввода данных из файла формат задается командой "FO". Эта команда должна быть первой соответствующей командой, т.е. ей может предшествовать любое количество комментариев или пустых строк. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| формат | единицы | размеры изображения | разрешение | примечания |
| 0 EasyGraf | EasyGraf - Units | 200 x 150 Units 640 x 480 пиксель | 0.313 Units/пиксель |
постоянная установка, черчение плоттером невозможно |
| 1 = A4 горизонтальный | мм | 297 x 210 мм 1188 x 840 пиксель | 0.250 мм/пиксель |
постоянная установка, черчение плоттером возможно |
| 2 = A4 вертикальный | мм | 210 x 297 мм 840 x 1188 пиксель | 0.250 мм/пиксель |
постоянная установка, черчение плоттером возможно |
| 3 = A3 | мм | 420 x 297 мм 1680 x 1188 пиксель | 0.250 мм/пиксель |
постоянная установка, черчение плоттером возможно |
| 4 пиксель | пиксель | 640 x 480 пиксель = установка по умолчанию | 1 пиксель | переменная настройка, черчение плоттером невозможно |
Таблица 1: возможные форматы изображений
Рис. 5: Три вида диалога формата в зависимости от выбранного формата или выпуска плоттера
С помощью пункта контекстного меню "Insert Command" можно открыть список элементов и выбрать один из них. Затем в окне редактирования создается соответствующая команда. Структура команды записывается в виде комментария. Необходимо вставить только недостающие параметры.
Если установить курсор на существующую командную строку и нажать на пункт контекстного меню "Show Command-Format", отобразится структура команды, о которой идет речь. Если нажать на пункт контекстного меню "Help Command-Format", то откроется руководство EasyGraf с объяснением данной команды. При "Tuning" должен стоять курсор на строке, которая описывает элемент, который предлагается клавишами у графического дисплея. После нажимания клавиши "Tuning" активный элемент предстаyвляется красным цветом на графическом дисплее, независимо от собственного цвета. Элемент может изменяться вытягиванием его углов на экране, изменением Scroll-задвижек на Control-панели или численной записью параметров.
Актуальный исходный файл имеет статус "Main File". Только с этим статусом данные могут представляться описанным способом. Однако, с помощью "Open" в меню-группе "File" редактора могут открываться дальнейшие файлы или производиться с помощью "New". Они не имеют того статуса, они служат лишь для ссылки, например, для копирования строк. Редактор имеет здесь функцию чистого текстового редактора. Меню-группу "Edit" служит для копирования или вырезки текста.
Графический дисплей позволяет изменение масштаба (Zooming) изображения и прокрутку рисунка (Scrolling) (см. рис. 1). При увеличении изображения преднамеренным путем Zooming разрешение по пикселеей не улучшается. Вследствие этого, контуры изображения будут в данном случае небрежно представлены. При вертикальном тексте величина шрифта станет неточной.
Для перемещения ползунков прокрутки можно использовать колесико мыши. Переключение между горизонтальной и вертикальной прокруткой осуществляется с помощью пункта меню "Колесо мыши горизонтально" или "Колесо мыши вертикально" контекстного меню.
Второй путь, получить данные, состоит в интерактивном графическом редактировании. Для этого дважды щелкают на желаемую точку гарфик-дисплея. После этого появляется слева на рабочем столе программы ряд клавишей для самых важных графических элементов. Выбором одного из них рисуется соответствующий элемент на вспомогательном дисплее и появляется панель для установки параметров элемента (рис. 6). Кроме того, путем нажиманием мышей на дисплей можно перемещать элемент (с его актуальными габаритными размерами) на другую точку. При актуальном элементе данным-релевантные точки маркированы красным цветом. Они могут перемещаться "хватанием" этих точек с курсором и вместе с тем величину элемента изменять. (При кругах и эллипсах может только центр перемещаться.) Сказанное имеет также значение для активного элемента во время работы с "Tuning", исходя от текстового файла (смотри наверху). Как выбранный элемент изображается и какие данные вносятся в текст источника, зависит от позиции курсора на странице текстового редактора, т.е. от того, какие форматирующие команды, записаны выше, актуальны в позиции курсора (например, "PK" = координаты в пикселях или "NP" = смещение нуля).
С помощью клавишей "take on", "Insert" или "Replace" (в зависимости от ситуации при текстовом редакторе) можно принимать данные элемента в текст источника. Параметры элемента могут устанавливаться ручным вводом в Edit-поля панели или изменением Scroll-задвижек. Цвет может изменяться также вводом данных в Edit-поле (как RGB-значение) или выбираться с помощью диалога для цвета, который появляется после нажимания цветной клавиши. (Аналогично появляется диалог для выбора шрифта после нажимания клавиши шрифта.) Control-панель может минимизироваться (см. рис. 6).
Нажимая правую кнопку мыши на графический дисплей или в текст источника, открывают всплывающее меню с самыми важными акциями программы. Меню может различаться в зависимости от ситуации работы. С "курсор крест" можно соответственно переключать курсор графического дисплея. С клавишами "Set PK" или соответственно "Set FK" производят команду "PK" (координаты пикселей) и соответственно "FK" (координаты с плавающей запятой) в тексте источника. С клавишей "Make PF" в данный момент рисования линии можно преобразовывать ее в элемент "PF" (стрелка).
рис. 6
4. Вывод данных 
Актуальное изображение можно сохранять как Bitmap-файл, нажимая клавиши меню главного окна → File → Pict. Save или → Pict. Save as. Соответствующим образом, такими клавишами в меню редактора можно сохранять текст источника как текстовый файл, а также печатать клавишей "Print".С помощью команды меню → File → Show Plott-File открывается окно редактора с данными для плоттеров в формате HPGL. Их можно вывести в текстовый файл (тип файла .HPGL) с помощью команды → File → Save as.
Плоттерный вывод вызывается с помощью команды меню "Plott". При необходимости запрашивается ввод данных для Plotter-Window. После подтверждения запроса "Плоттер готовый?" начинает выход к плоттеру.
Вывод данных HPGL непосредственно на плоттер возможен с помощью команды меню "HPGL-Import". Откроется диалог для ввода данных в текстовый редактор. Отсюда можно редактировать данные. (Для распознания) формата плпттера ищется в данных инструкция "DF; IW ..." если она не найдена, слддует сообщениe об ошибке.)
С помощью команды меню "Plott" запускается вывод к плоттеру.
5. Формат данных исходного текста
Управление программы происходит с помощью строчко-командами в ASCII-файле. При этом первые два знака в строчке интерпретируются как команда. Обычно следуют параметры как Integer- или Real-числа. Для последних принимается пункт как децимальный знак. (Команды можно писать маленькими или большими буквами.) Как отделительные знаки между параметрами можно пользовать пробел, запятую или табуляторный знак. Значение параметров зависит от их позиции в строчке. В конце любой строчки (кроме при командах TE, FP, FN, IN, BM и ME) после точкой с запятой можно писать комментарии. Также могут существовать пустые и строки комментарий, которые начинаются с точкой с запятой. Длина строчек не ограничена, но в одну строку можно писать только одну команду.6. Цвета
Цвета можно специфицировать либо целым числом (0 .. 15), соответственно 16-цветовой палитры, либо как RGB-значение цвета в форме #RRGGBB. Участия красного цвета (RR), зеленого (GG) и синего цвета (BB) указываются шестнадцатирично, каждая 00 .. FF.7. Ширины линий
Ширины линий указываются в пикселях (по умолчанию = 1). Возможны ширины 1 .. 10. Они устанавливаются целым числом. Надо обращать внимание на то, что тип линии > 0 только возможен при ширине линий = 1.8. Типы линии
Имеются 5 типов линий. Они указываются целым числом 0 .. 4 (см. рис. 7). Надо обращать внимание на то, что тип линии > 0 только возможен при ширине линий = 1.
рис. 7
9. Команды
Одна команда занимает одну строчку. Она состоит из кода команды (первые два знака строчки) и обычно следующих ей параметров в форме целых или real-числ. Их значение зависит от позиции. Команду можно писать маленькими или большими буквами. Как отделительные знаки между параметрами можно пользовать пробел, запятую или табуляторный знак.В следующей таблице назначаются целые: i или n, а real-числа: x, y, R , w или v. Цвета обозначаются с c. Само собой разумеется, что x, y и R должны указываться как целые числа, в случае, что система переключена на пиксель-координаты. Те команды, которые находятся в распоряжении для интерактивного графического редактирования, написаны красным цветом.
| - AR Рисовать дугу: | |
| AR c x y w1 w2 R | c = цвет, x , y = координаты центра, w1 = начальный и w2 = конечный угол в градусах, R = радиус. Обычный случай: 0 ≤ w1 < w2 ≤ 360° Дуга с 1-ого. до 4-ого квадранта: w2 < w1 |
| - BG Задавать цвет фона: | |
| BG c | c = цвет (Цвет фона не принимается при выходе изображения как Bitmap.) |
| - BM Bitmap: | ввод данных маленького Bitmap |
| BM x y FileName | x y = Позиция Bitmap (верхний левый угол для пиксельных координат, нижний левый угол для координат с плавающей запятой). Рисуется как прозрачное изображение на мониторе. Прозрачным цветом является белизна. Файл изображения может быть типа "bmp", "ico", "jpg" или "jpeg". |
| - BZ Кривая "Bezier": | возможны два типа |
| BZ c n xo yo x1 y1 x2 y2 | Кривая Bezier второй степени c = цвет, n = число шагов при рисовании кривой, x, y = координаты: начальная, конечная точка и якорная точка  |
| BZ c n xo yo x1 y1 ... x3 y3 | Кривая Bezier третьей степени c = цвет, n = число шагов при рисовании кривой x, y = координаты: начальная, конечная точка и две якорные точки  |
| - DA Дата: | Писание даты как текстовая строка |
| DA c x y DA c x y T | Производится текст с актуальной датой без указания времени. Производится текст с актуальной датой и временем (Т = ключевое слово). c = цвет, x y начальные координаты текста |
| - DC Определите базовый цвет: | |
| DC i c | i = номер основного цвета (0 ...15), c = новый цвет (задается в форме #RRGGBB, цвета #0 и #FFFFFF не допускаются). |
| - CR Рисовать круг: | |
| CR c x y R | c = цвет, x y = координаты центра, R = радиус |
| - EL Рисовать эллипс: | |
| EL c x y Rx Ry | c = цвет, x , y = координаты центра, Rx = радиус в x- и Ry = радиус в y-направлении. |
| - EL Рисовать дугу эллипса: | |
| EL c x y w1 w2 Rx Ry | c = цвет, x , y = координаты центра, w1 = начальный и w2 = конечный угол в градусах, Rx = радиус в x- и Ry = радиус в y-направлении. Обычный случай: w1 < w2 ≤ 360° Эллиптическая дуга с 1-ого. до 4-ого квадранта: w2 < w1 |
| - Конец данных: | обязанность только при макро-источниках |
| END | нет параметров |
| - FF Наполните фигуру цветом краской: (Flood Fill) | |
| FF c cR iS x y FI | c = цвет наполнения, cR = цвет края, iS = образец наполнения, x y = координаты начала наполнения синоним для FF Возможны 7 образцов наполнения. При прерванной линии (тип линии ≠ 0) "течёт" краска из фигуры. При изобилии всего дисплея нужно обращать внимание на то, что до этого надо рисовать край (цвет края). |
| - FK "Floating-Координаты": | переключать на тип координат "Unit" |
| FK GK | никакие параметры синоним для FK |
| - FO Установить формат: | Эта команда должна быть первой релевантный командой в исходном EasyGraf-тексте. |
| FO [F] FO Px1 Py1 [F] FO Px1 Py1 [Px2 Py2] [F] |
F = номер формата (0. . 4), если параметр отсутствует, принимается F = 0, Px1, Py1, Px2, Py2 = Координаты точек P1 или P2 окна плоттера. (Эти параметры актуальны только для выходов плоттера.) Команда не разрешена в источниках макросов. |
| - FP Задавать параметрь шрифта: Возможны различные форматы команды. | |
| FP FP iG "FontName" FP iS iR iG FP iS iR iG "FontName" FP iS iR iG iC "FontName" |
Возврат к стандартному шрифту, |
| SA FN "FontName" TS iS iR iG |
синоним для FP (общий) синоним для FP (особая форма) синоним для FP (особая форма) iS = стиль шрифта, iR = направление, iG = высота, iC = набор символов, iS может принимать значения 0 .. 3: 0 = Normal (default), 1 = Bold, 2 = Italic, 3 = Bold + Italic. iR может принимать значения 0 или 1: 0 = слева направо (default), 1 = снизу наверх. iG указывает величину в пикселах. iC может принимать значения 0 .. 5: 0 = OEM/DOS, 1 = ANSI, 2 = стандартный шрифт системы Windows, 3 = Symbol, 4 = Cyrillic, 5 = Greek. FontName должно совпадать с именем инсталлируемого шрифта. Оно должен обрамляться с " ". Между выбранным шрифтом и набором символов должна быть "совместимость", т.е. выбранный шрифт должен существовать для указанного набора символов. Если это не выполнено, то Windows выбирает подходящий шрифт. |
| - FR Наполненный прямоугольник: | |
| FR c xo yo x1 y1 GR | c = цвет наполнения, xo , yo , x1 , y1 = координаты двух по-диагонали друг к другу лежащих углов. (Если на площади прямоугольника уже находятся части рисунков, то они покрываются краской.) синоним для FR |
| - IN Вводить Макро: | вводить .grf-файл как макро |
| IN xo yo FileName IN xo yo v "FileName" IN xo yo v α "FileName" |
xo yo = Нулевая точка координат для элементов макро, v = фактор увеличения, FileName = имя графического файла (default: .grf). Если файл находится в рабочей папке, то указание имени в одиночестве достаточно, иначе полный путь должен указываться. Если путь и/или имя содержат символ пробела, то строка символов должна обрамляться в " ". (Между прочим, рабочую папку можно выбирать с помощью PopUp-меню "Set Work-Dir" {правой кнопкой мыши}.) Для координатных отношений, увеличения и вращения имеет значение то, что произнесено о команде "NP". Параметры имеют значение локально для считываемого графического файла, команды форматирования и координатная система возвращаются перед считыванием на стандарте, но восстанавливаются после завершения макро. Макро-файл может содержать все языковые элементы EasyGraf, кроме IN, NP и FO. После возвращения в первоначальный текст источника, для координатных отношений, фактора увеличения, угла поворота и форматирований имеют значение предыдущие актуальные установки. |
| - LI Рисовать линию: | между точками 1 и 2 |
| LI c iS xo yo x1 y1 | c = цвет, iS = тип линии, xo , yo , x1 , y1 = координаты точек. Возможны 5 типов линии (см. пкт. 8). Выбранный тип линии (iS) действует только локально для текущей линии. |
| - LS Задавать тип линии: | |
| LS iS iW | iS = тип линии, iW = ширина линии (default: iS = 0 iW = 1) Возможны 5 типов линии (см. пкт. 8). Типы линии ≠ 0 только возможны, если актуальная ширина линии iW = 1. Установка остается до следующей команды LS . (Однако, при команде LI локально действует там указанный параметр iS, независимо от iW.) Круговые дуги, эллиптические дуги, кривые Безье, стрелки и маркеры рисуются полной линией, несмотря на iS ≠ 0. Стрелки и маркеры всегда рисуются с iW = 1. |
| - MA текст источника - макро: | не обязанность при макро-источнике, но рекомендуетcя |
| Macro MA MA MP [F] MA xo yo [F] | синоним для MA (Параметры применяются только к управляющему чертежу макро-источника). xo = 0, yo= положение нулевой точки для контрольного чертежа, ключевое слово MP приводит к фиксации xo, yo в центре изображения. Если координаты xo = 0, yo отсутствуют, они устанавливаются равными нулю. F = номер формата (0 .. 4) для чертежа управления, если этот параметр отсутствует, принимается F = 0. Звездочка приводит к рисованию нулевой точки макроса (независимо от записи в Ini-файле). |
| - ME Сообщение (Message): | |
| ME "Message-Text" | Команда означает, что ввод данных останавливается и выписывается сообщение (Message-Text) на дисплее. Возможны отмена или продолжение ввода данных. |
| - NP Задавать нулевую точку: см. также рис. 3 | |
| NP NP xo yo [*] NP xo yo v [*] NP xo yo v α [*] |
возврат в исходное стандартное положение
v = 1, α = 0, Ключевое слово * причиняет рисование нулевой точки. Полная структура команды xo yo = новые координатные отношения, соответственно актуальной координатной системы. xo yo относятся всегда к первоначальной координатной системе, соответственно выбранному формату. Команда не позволена в пределах макро-файла (см. "IN"). v = фактор увеличения α = угол поворота в ° (default: xo = 0, yo = 0, v = 1.0, α = 0) Установка остается до следующей команды NP или до конца файла. У всех команд в пределах раздела происходит предоставленная трансформация координат. При v ≠ 1 не влияют на ширины линий, но высота шрифта изменяется. При вращении направление шрифта не изменяется. Радиусы круга и эллипса и высота маркеров (команда PX) изменяется при v ≠ 1. |
| - PC Команды для плоттера: | Вывод последовательности команд в HPGL |
| PC последовательность HPGL-команд" | |
| Проверка ошибок отсутствует. Неправильные команды могут привести к неожиданным реакциям плоттера. | |
| - PF Рисовать стрелку: | от точки 0 до точки 1 (1: показывает на точку 1) |
| PF c xo yo x1 y1 [n] | c = цвет, xo , yo , x1 , y1 = координаты n = 1 или 2 ≡ количество наконечников стрелок (по умолчанию 1) |
| - PK пиксель-координаты: | переключать на тип координат "Pixel" |
| PK | никакие параметры |
| - PO Рисовать полилинию: | максимально 50 точек |
| PO c n xo yo ... xn yn | c = цвет, n = число точек, xo , yo , ... xn , yn = координаты |
| -PX Рисовать точку (пиксель) | соответственно установку маркера |
| PX c x y PX c x y h | рисовать цветовой пиксель установку маркера c = цвет, x y = координаты, h = высота маркера:  Если h опущено, появляется лишь один цветовой пиксель. Максимальное значение для h: 10 единиц/мм для формата 0..3, 20 пикселей для формата 4 |
| - RE Рисовать прямоугольник: | |
| RE c xo yo x1 y1 | c = цвет, xo , yo , x1 , y1 = координаты двух по-диагонали друг к другу лежащих углов. Минимальная площадь 4 пикселя² или мм². |
| - TE Текст: | Писать текстовую строку |
| TE c x y "text" TE c x y iS iR iG "text" | c = цвет, x y = Начальные координаты текста text Текст должен быть разграничен знаками " ... ". Всегда текст охватывает только строку. Он может содержать сколь угодно много символы пробела. Если указаны стиль iS, направление iR и размер iG шрифта, то они действуют только локально для текущего элемента. В остальном, параметры шрифта устанавливаются командой FP. Точка начальных координат находится при горизонтальном шрифте слева внизу наряду с первым символом и при вертикальном шрифте направо снизу. Для текста все символы ASCII могут использоваться. Символы, которые не досягаемы при помощи клавиатуры, могут производиться $hh (hh = код символа как шестнадцатиричное число {2 символа, при необходимости, с преднулевым}). Если необходимо ввести сам символ $, следует написать $$. Переходы строк и символы табулятора не распознаются. По умолчанию установлены следующие параметры: Направление = слева направо, стиль шрифта = обычный. Настройки по умолчанию для имени шрифта, размера и набора символов приведены в Ini- файле.  |
| - XS Шкала в направлении X: | ||
| XS c iw x y Lo LA LI d | c = | цвет, |
 | iw = | ширина осевой линии (1..3), масштабные линии (метки) всегда имеют ширину 1 |
| x y = | начальные координаты, | |
| Lo = | общая длина в X-направлении, | |
| LA = | внешняя длина меток, | |
| LI = | внутренняя длина меток, | |
| d = | расстояние между метками. | |
| Рисуется столько зметок сколько мест есть на Lo. | ||
| - YS Шкала в направлении Y: | |
| YS c iw x y Lo LA LI d | Параметры и изображение как для XS, но вертикальное |
| c = цвет, iw = ширина осевой линии, x y = начальные координаты, Lo = общая длина в Y-направлении, LA = внешняя длина меток, LI = внутренняя длина меток, d = расстояние между метками. Рисуется столько зметок сколько мест есть на Lo. | |