1. Общая информация

ZCAD - программа (далее по тексту - программа) с открытым исходным кодом, разрабатывается на языке Pascal с использованием IDE Lazarus и компилятора Free Pascal.

Автор - Андрей Зубарев (далее по тексту - автор) адрес электронной почты zamtmn@yandex.ru

Участник - Владимир Бобров

Участник - Владимир Абрамов адрес электронной почты vl-sx@yandex.ru

Есть два варианта сборки программы:

ZCAD - базовый набор CAD инструментов; ZCADElectrotech - набор расширеннвй инструментами для электротехнического проектирования

1.1. Лицензия

ZCAD - это программное обеспечение с открытым исходным кодом. Вы можете получить исходный код, а также разрешается копировать, перераспределять и изменять его в соответствии с условиями лицензии LGPL2 с исключениями. Для получения дополнительной информации, в том числе о доступности исходного кода, посетите страницу программы https://github.com/zamtmn/zcad или обратитесь к автору.

1.2. Отказ от ответственности

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

  1. Поставляемой вместе с программой информации предназначена для свободного ознакомления пользователей с вопросами, которые могут представлять для них интерес.

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

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

  4. ZCAD — это программа, работающая по принципу «как есть», без заключения каких-либо договорённостей или договоров между пользователями программы и автором, либо кем-то ещё, любым образом связанными с этим или родственными ему проектами, которые (договора и договоренности) могут стать предметом прямых претензий.

  5. Автор не дает каких-либо заверений или гарантий в отношении программы, в том числе, без ограничения, в отношении своевременности, актуальности, точности, полноты, достоверности, доступности или соответствия для какой-либо конкретной цели, в отношении того, что: при использовании программы не возникнет ошибок, а также, что поставляемая вместе с программой информация не нарушает прав третьих лиц.

  6. В соответствии с действующим законодательством, Автор отказывается от каких-либо заверений и гарантий, предоставление которых может иным образом подразумеваться, и ответственности в отношении программы. Ни при каких обстоятельствах автор не будет нести ответственности ни перед какой стороной за какой-либо прямой, непрямой, особый или иной косвенный ущерб в результате любого использования программа, даже если автор будет явно поставлен в известность о возможности такого ущерба.

  7. Автор оставляет за собой право вносить изменения без уведомления о них пользователей.

  8. Если в соответствии с действующими законами какие-либо условия будут признаны недействительными, остальные условия остаются в полной силе.

Используя ZCAD и информацию поставляемую вместе с программой, вы выражаете свое согласие с «Отказом от ответственности» и установленными Правилами и принимаете всю ответственность, которая может быть на вас возложена.

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

2. Быстрый старт

2.1. Системные требования

Программа работает под управлением операционных системам Windows и Linux, на 32 разрядных и 64 разрядных процессорах. для работы программы требуется 4GB оперативной памяти

2.2. Установка

ZCAD не требует какой то процедуры устанавки на компьютер. Вы можете скачать дистрибутив программы с страницы https://github.com/zamtmn/zcad/releases, для использования достаточно разорхивировать полученный архив

2.3. Запуск

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

3. Работа с программой

3.1. Интерфейс пользователя

3.1.1. Общий обзор

Интерфейс программы по умолчанию представлен на скриншоте:

zcad ui
Рисунок 1. Внешний вид окна программы

Можно выделить следующие основные элементы:

1. Окно отображения

Тут производится отображение и редактирование графической информации.

Навигация по чертежу осуществляется мышкой. Масштабировать чертеж можно вращая колесо мыши, если при этом нажать и удерживать клавишу Shift коэффициент масштабирования будет меньше и точки временных привязок не будут сброшены. Панарамировать чертеж можно двигая мышь с нажатой средней кнопкой. Если при панарамировании удерживатьт клавишу Ctrl, будет осуществляться вращение камеры. Также для навигации доступны некоторые сочетаения клавиш !!NEEDLINK!!

Редактирование чертежа также производится курсором мыши, при этом его форма зависит от ожидаемого действия: перекрестие - указание точки на чертеже, прямоугольник - выбор графического примитива. Комбинация прямоукольника и перекрестия - можно как выбрать примитив, так и указать точку на чертеже.

Программа позволяет выбирать примитивы несколькими способами:

  1. кликнув прямоугольником по примитиву - примитив будет добавлен к текущему набору выбора

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

zcad ui selectframes
Рисунок 2. Варианты рамок выбора
2. Инспектор объектов

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

На рис. Внешний вид окна программы в инспекторе отображаются настройки программы. Если в области отображения выделить несколько примитивов, инспектор примет примерно следующий вид:

zcad ui objectinspector
Рисунок 3. Свойства выделенных примитивов

Имена свойств доступных только для чтения отображаются серым цветом. Если выделенные примитивы имеют различные значения одноименных свойств, данные значения отображаются как "Разный". Если данные значения фактически отличаются, но изза настроек отображения !!NEEDLINK!! (округления) выглядят одинаково, данные значения помечаются знаком "≈".

При клике на значение свойства откроется строка редактирования и можно будет изменить значение свойства. Для некоторых свойств доступны специализированные редакторы, открывающиеся в отдельном окне по нажатию кнопки […​]

Свойства примитивов структурированны следующим образом:

Failed to generate image: Error processing request {:url=>"/plantumlpreprocessor", :body=>"@startuml\n!include styles/defaulttree-style.iuml\nlegend\nИнспектор\n|_ Обрабатывать_примитивы\n|_ Обработка_переменных\n|_ Связанные переменные\n  |_ Переменные связанных примитивов\n|_ Переменные\n  |_ Свои переменные\n|_ Расширения\n  |_ Свойства расширений примитивов\n|_ Общие\n  |_ Основные свойства примитивов\n|_ Геометрия\n  |_ Геометрические свойства примитивов\n|_ Разное\n  |_ Не геометрические свойства примитивов\n|_ Суммарно\n  |_ FILTER\n    |_ Свойства_для_фильтрации\n  |_ Просуммированные свойства\nend legend\n@enduml", :headers=>{"X-PlantUML-Basedir"=>"C:\\projects\\zcad\\cad_source\\docs\\userguide"}}
Encoding of input is UTF-8
!include styles/defaulttree-style.iuml
legend
Инспектор
|_ Обрабатывать_примитивы
|_ Обработка_переменных
|_ Связанные переменные
  |_ Переменные связанных примитивов
|_ Переменные
  |_ Свои переменные
|_ Расширения
  |_ Свойства расширений примитивов
|_ Общие
  |_ Основные свойства примитивов
|_ Геометрия
  |_ Геометрические свойства примитивов
|_ Разное
  |_ Не геометрические свойства примитивов
|_ Суммарно
  |_ FILTER
    |_ Свойства_для_фильтрации
  |_ Просуммированные свойства
end legend
  1. Обрабатывать примитивы - тут можно выбрать тип примитивов свойства которых отображаются в инспекторе, а нажатием кнопок [*] или [-] оставить только примитивы данного типа в текущем выборе или исключить их из текущего выбора

  2. Обработка переменных - Управляет способом оотображения набора переменных примитива (см. extdrVariables и Централизация) . Выбраный примитив - только переменные выбранных примитивов; Связанные примитивы - только переменные связанных примитивов; Все примитивы - обрабатываются переменные и примитивов из текущего выбора и связанных с ними примитивов, все переменные отображаются на одной вкладке; Все примитивы раздельно - обрабатываются переменные и примитивов из текущего выбора и связанных с ними примитивов, переменные отображаются на разных вкладках;

  3. Связанные переменные - на этом уровне структуры будут отображены переменные связанных примитивов, при с значением Process Обработка_переменных=Все примитивы раздельно

  4. Переменные - на этом уровне структуры будут отображены все доступные в соответствии с значением Process variables переменные. При отображении переменных свзанных примитивов возможна цветовая раскраска значений !!NEEDLINK!!

  5. Общие - тут перечисдены общие свойства примитивов: слой, цвет, вес и т.п.

  6. Расширения - если к выделенным примитивам добавлены расширения, их свойства отображаются здесь.

  7. Геометрия - различные геометрические свойства: точки вставки, координаты, длины и т.п.

  8. Суммарно - некоторые свойства допускающие суммирование, например при выборе нескольких отрезков тут будет их суммарная длина. Здесь же в ветке FILTER будут некоторые свойства допускающие фильтрацию, например можно кнопкой [*] оставить в текущем выборе тиолько примитивы лежащие на определенном слое.

3. Окно сообщений

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

4. Командная строка

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

Поле ввода имеет подсказку меняющуюся по текущей ситуации. Когда программа ожидает ввода команды подсказка имеет вид Команда> и > когда ожидается координата. Также некоторые комманды имеют контекстнную подсказку, в которой можно выбрать мышью опции команды

Перечень доступных комманд приведен в Команды команда может быть введена как просто по имени, так с операндом. Операнд указывается в скобках после имени команды. Например ввод Load вызовет диалог открытия файла чертежа и последующую его загрузку. Ввод Load(D:\file.dxf) сразу вызовет загрузку файла D:\file.dxf. Парсинг операндов выполняется силами команды, поэтому синтаксис в разных командах отличается.

Координаты можно вводить как 2D, так и 3D, при этом 2D будут переведены в 3D подстановкой 0 в качестве координаты Z. Также можно вводить как абсолютные, так и относительные (относительно последней указанной точки) значения. Относительные координаты задаются указанием знака @ перед координатой X. Если включен режим трассировки !!NEEDLINK!! и имеется привязка к оси трассировки, можно указать точку введя расстояние от точки трассировки, отложенное по оси трассировки.

Например если в открытом чертеже на запрос Команда> ввести Line, затем 10,30, затем @1,2 будет построена линия с координатами (10,30)-(11,32)

Командная строка может быть отключена. !!NEEDLINK!! В режиме с выключеной командной строкой становятся доступны буквенные сочетания клавиш - с включенной нажатия букв обрабатываются командной строкой

5. Статусная строка.

Здесь отображаются координаты курсора и прогрессбары долгих процессов. Также есть быстрый доступ к кнопкам переключения различных режимов работы программы !!NEEDLINK!!

6. Панели инструментов

Здесь сгруппированы иконки различных комманд для их быстрого запуска. !!NEEDLINK!!

7. Палитры

Могут отображаться в древовидном виде и в виде списка иконок. К каждому листу дерева или иконке списка может быть привяана произвольная команда, запускаемая при клике по элементу. Как правило это команды втавки устройств или блоков. Древовидные палитры дополнительно оснащены полем фильтра для быстрого нахождения элементов !!NEEDLINK!!

8. Навигаторы

Навигаторы служат для быстрой навигации по чертежу, нахождению на нем тех или иных элементов. Представляют из себя настраиваимую древовидную структуру отображения данных. На данный момент в программе доступны навигаторы устройств, кабелей, стояков и примитивов !!NEEDLINK!!

3.1.2. AnchorDocking

ZCAD в своей работе использует библиотеку AnchorDocking !!NEEDLINK!! данная библиотека позволяет склеить (пристыковывать) различные окна в одно. На Внешний вид окна программы 1,2,3,7,8 являются отдельными окнами склеенными в одно окно. Пустое окно программы выглядит следующим образом:

zcad empty ui
Рисунок 4. Пустое окно программы

По периметру окна расположены области для пристыковки панелей инструментов, в центре область пристыковки окон.

Панели инструментов

Включить панель инструментов можно командой ShowToolBar передав ей в качестве операнда имя панели инструментов (или в меню Вид/Показать окно/Панели инструментов). Например включаем панель View, по умолчанию она отображается в неприствкованном состоянии:

zcad empty ui with toolbar
Рисунок 5. Панель инструментов

Для пристыковки панели начинаем ее перетаскивать за свободное место (не за заголовок!), при этом будет будет подсвечиваться предпологаемое новое место расположения панели. При подведении мышки к краю окна будет подсвечена область вдоль края, при отпускании кнопки мыши панель инструментов будет пристыкована .Стыковка панели инструментов

Действие Процесс Результат

Стыковка панели инструментов

zcad empty ui drag toolbar
zcad empty ui docked toolbar

В пристыкованном состоянии панели инструментов имеют заголовок в виде двух полосок в начале панели, за этот заголовок панель можно передвигать вдоль края пристыковки и отствковывать, двойной клик по заголовку панели приведет к ее полному раскрытию. Закрыть панель инструментов можно только в отстыкованном состоянии

Окна

Включить окно программы можно командой Show передав ей в качестве операнда имя окна (или в меню Вид/Показать окно). Например включаем окно ObjectInspector, по умолчанию окно отображается в неприствкованном состоянии:

zcad empty ui with objectinspector
Рисунок 6. Не пристыкованное окно инспектора объектов

Не пристыкованные окна программы имеют два заголовка - стандартный и нестандартный. За стандартный окна можно только перемещать, за нестандартный - перемещать и пристыковывать. Стыковка окон осуществляется перетаскиванием окна на желаемое место стыковки, при этом область стыковки будет подсвечена.

Таблица 1. Варианты стыковки окон программы
Действие Процесс Результат

Стыковка первого окна

zcad empty ui try dock oi
zcad empty ui dock oi

Стыковка следующего окна справа от первого

zcad empty ui try dock second
zcad empty ui dock second

Стыковка следующего окна поверх второго

zcad empty ui try dock third
zcad empty ui dock third

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

В заголовке пристыкованных окон появляется дополнительная кнопка минимизации, которая позволяет свернуть окно в тонкий заголовок и разворачивать его при наведении мыши

При щелчке правой кнопкой мыши по любому разделительному сплитеру можно вызвать контекстное меню стыковки для настройки ее параметров.

Сохранить раскладку окон и тулбаров можно командой SaveLayout или в меню настройка\Сохранить разбивку окон поумолчанию

3.1.3. Навигаторы

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

zcad ui navigator
Рисунок 7. Навигатор устройств

Настройка навигатора производится следующим образом:

zcad ui navigator prepare
Рисунок 8. Органы управления навигатора
1. Кнопка настройки ветвлений древовидной структуры

Вызывает редактор описания ветвлений древовидной структуры навигатора, либо открывает меню действий с навигатором при нажаитии на стрелку

2. Кнопка главной функции

Включает-выключает использование в навигаторе "Главной функции" (Централизация)

3. Кнопка редактора фильтра примитивов по типу

Вызывает редактор скрипта фильтрации по типу примитивов см.Формат фильтра по типам примитивов

4. Кнопка редактора фильтра примитивов по свойствам

Вызывает редактор скрипта фильтрации по свойствам примитивов см.Формат фильтра по свойствам примитивов

5. Кнопка редактора скрипта настройки отображения дерева

Вызывает редактор скрипта настройки отображения дерева. Ветвление дерева зависит от (1. Кнопка настройки ветвлений древовидной структуры), в данном скрипте настраиваетя например количество столбцов и их заполнение. Данный скрипт выполняется при создании навигатора, при изменении скрипта выполняется пересоздание навигатора для применения изменений В общем случае скрипт выглядит так:

Оператор(Операнд[,Операнд,Операнд ...])

Доступные типы операндов:

'Строка'

Строковой параметр - любой текст заключенный в апострофы

Целое положительное число

Операторы могут разделяться точкой с запятой, запятой, пробелом, переводом строки. Доступны следующие операторы:

SetColumnsCount(Операнд1,Операнд2)

Задает количество столбцов в навигаторе, должна присутствовать 1 раз в начале скрипта
Операнд1 - Целое положительное число. Количество столбцов в навигаторе
Операнд2 - Целое положительное число. Номер столбца чья ширина будет расчитываться автоматически (нумерация с 0)

SetColumnParams(Операнд1,Операнд2,Операнд3,Операнд4,Операнд5)

Задает параметры столбцов, должна присутствовать для каждого столбца
Операнд1 - Целое положительное число. Номер столбца для которого задаетются параметры (нумерация с 0)
Операнд2 - Строка. Название сторлбца
Операнд3 - Строка. Содержимое столбца
Операнд4 - Строка. Имя переменной в которой сохраняется ширина столбца (в файле rtl\savedvar.pas) между сессиями работы. Если переменной пока нет нет, она будет создана с начальным значением 50
Операнд5 - Целое положительное число. Пока не используется

Примеры скриптов экспорта:
Два столбца Tree и Comment, содержимое переменной NMO_Name примитива в первом и статичная надпись 'Тут чтото тоже надо сделать' во втором

SetColumnsCount(2,0);
SetColumnParams(0,'Tree','@@[NMO_Name]','tmpGUIParamSave_NavDev_C0',1);
SetColumnParams(1,'Comment','Тут чтото тоже надо сделать','tmpGUIParamSave_NavDev_C1',1)

Три столбца Tree Elevation и Text, с содержимым переменных RiserName, Elevation и Text примитивов

SetColumnsCount(3,0);
SetColumnParams(0,'Tree','@@[RiserName]','tmpGUIParamSave_NavRis_C0',1);
SetColumnParams(1,'Elevation','@@[Elevation]','tmpGUIParamSave_NavRis_C1',1);
SetColumnParams(2,'Text','@@[Text]','tmpGUIParamSave_NavRis_C2',1)
6. Кнопка обновления

Вызывает перестроение дерева в навигаторе. Обычно при изменениях на чертеже навигаторы обновляются автоматически, но могут быть ситуации когда требуется в ручную вызвать обновление навигатора

7. Кнопки управления ветвлением

Количество и название кнопок зависит от (1. Кнопка настройки ветвлений древовидной структуры) нажатое или отжатое состояние показывает включен или нет данный узел в текущий момент. Узлы можно включать\выключать.

8. Сохранение текущих настроек навигатора в файл

Открывает окно выбора файла

9. Загрузка настроек навигатора из файл

Открывает окно выбора файла

10. Подменю выбора вариантов настроек навигатора

Подменю выбора заранее подготовленных вариантов настроек навигатора. Для того чтобы вариант появился в данном подменю настройку необходимо сохранить в папку $(ZCADPath)/configs

11. Быстрый фильтр содержимого навигатора

Поле ввода для быстрой фильтрации содержимого инспектора по тексту. 5Допускает применение символов ? и *

3.2. Примитивы

Основной формат файла хранения графических данных программы – DXF версии 2000, со следующими ограничениями:

  • Не поддерживается THICKNESS

  • Не поддерживаются листы, только МОДЕЛЬ

Перечень доступных примитивов:

Таблица 2. Примитивы DXF поддерживаемые программой
Примитив ZCAD имя DXF имя Предаставляющая версия Ограничения

Точка

Point

POINT

ZCAD

Линия

Line

LINE

ZCAD

3D Полилиния

3DPolyLine

POLYLINE

ZCAD

Дуговые сегменты, тип линии

Полилиния

LWPolyline

LWPOLYLINE

ZCAD

Сглаживание

Сплайн

Spline

SPLINE

ZCAD

Экспериментально

3D Фэйс

3DFace

3DFACE

ZCAD

Солид

Solid

SOLID

ZCAD

Штриховка

Hatch

HATCH

ZCAD

Дуговые сегменты, сплайны, асоциативность

Дуга

Arc

ARC

ZCAD

Окружность

Circle

CIRCLE

ZCAD

Элипс

Ellipse

ELLIPSE

ZCAD

Текст

Text

TEXT

ZCAD

МТекст

MText

MTEXT

ZCAD

Коды форматирования

Вставка блока

BlockInsert

INSERT

ZCAD

Устройство

Device

ZCAD

Выровняный размер

AlignedDimension

DIMENSION

ZCAD

Экспериментально

Повернутый размер

RotatedDimension

DIMENSION

ZCAD

Экспериментально

Диаметральный размер

DiametricDimension

DIMENSION

ZCAD

Экспериментально

Радиальный размер

RadialDimension

DIMENSION

ZCAD

Экспериментально

Кабель

Cable

ZCADElectrotech

Электрическая ывноска

Leader

ZCADElectrotech

Трасса

Net

ZCADElectrotech

Суперлиния

SuperLine

ZCADElectrotech

Экспериментально

Данный список будет расширен, но не до полного охвата примитивов DXF.

Файлы, обработанные ZCAD, можно редактировать в AutoCAD (и других CAD программах) не применяя команды, очищающие расширенные данные примитивов. Если расширенные данные примитива будут разрушены, при последующей обработке файла ZCAD, он будет воспринят как стандартный примитив DXF, т.е. кабель станет просто полилинией, а устройство обычным блоком

3.2.1. Device

Условное графическое обозначение (далее УГО) оборудования на чертеже - это примитив DEVICE (устройство) в терминах ZCAD. В отличие от стандартного примитива DXF – INSERT (вставка блока) содержит в себе как жестко определенные в описании блока примитивы, так и динамические, которые можно двигать относительно точки вставки. Динамические примитивы уникальны для каждой вставки устройства, их количество и конфигурация могут отличаться и настраиваться Все имена описаний устройств начинаются с приставки DEVICE_, при вставке блока с названием, начинающимся с DEVICE_, он автоматически будет конвертирован в примитив DEVICE

Например, чтобы вставить на план дымовой пожарный извещатель как устройство, нужно вставить блок DEVICE_PS_DAT_SMOKE. Если вставить просто блок PS_DAT_SMOKE, он не будет конвертирован в примитив DEVICE и останется примитивом DXF – INSERT (вставка блока), не приобретая свойств устройства.

Устройство DEVICE_PS_DAT_SMOKE состоит из 2х блоков:

  • DEVICE_PS_DAT_SMOKE – динамическая часть устройства

  • PS_DAT_SMOKE постоянная часть устройства

Постоянная часть устройства содержит в себе собственно УГО:

ents device const part
Рисунок 9. Постоянная часть устройства
ents device var part
Рисунок 10. Динамическая часть устройства

Динамическая часть устройства содержит дополнительные примитивы например в данном случае:

  • Обозначение имени устройства

  • контур подрезки присоединенных кабелей

  • коннектор для присоединения кабелей (коннекторов может быть несколько, это самостоятельное устройство).

3.3. Расширения примитивов

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

  • extdrAdd - привязать расширение к примитиву/примитивам

  • extdrRemove - отвязать расширение от примитивп/примитивов

  • extdrAllList - вывести список всех доступных расширений

  • extdrEntsList - вывести список расширений привязаных к примитиву/примитивам

3.3.1. extdrLayerControl

Управление слоем применяется для управления видимостью примитивов в динамической части устройств. У примитива с данным расширением появляются дополнительные параметры

extdr params extdrlayercontrol
Рисунок 11. Параметры расширения extdrLayerControl
  • True слой - Имя слоя при True результате выражения

  • False слой - Имя слоя при False результате выражения

  • Выражение - Выражение имеющее Boolean резудльтат

Выражение может состоять из простых математических функция и включать имена переменных. При вычислении переменные ищутся в расширении extdrVariables данного примитива, при отсутствии запрашиваются у централи (см. раздел Централизация) и далее у владельца примитива по иерархии.

При ошибке в выражении или отсутствии требуемого слоя в чертеже текущий слой примитива не меняется.

3.3.2. extdrSmartTextEnt

Управление текстовыми примитивами для управления параметрами текстов в динамической части устройств. У примитива с данным расширением появляются дополнительные параметры

extdr params extdrsmarttextent
Рисунок 12. Параметры расширения extdrSmartTextEnt
  • Дистанция начала отображения выноски - После удаления текста от точки вставки устройства на данную дистанцию к тексту начинает пририсовываться выноска

  • Выносная линия - Отображение выноссной линии

  • Сдвиг начала выносной линии - Сдвиг начала выносной линии от точки вставки устройства. Положительное значение - радиус круга, отрицательное - половина стороны квадрата

  • Базовая линия - Отображение базовой линии

  • Смещение X базовой линии - Смещение X координаты начала базовой линии от точки вставки текста. Положительное значение - абсолютное смещение, отрицательное - относительное смещение, домножается на высоту текста

  • Смещение Y базовой линии - Смещение Y координаты начала базовой линии от точки вставки текста. Положительное значение - абсолютное смещение, отрицательное - относительное смещение, домножается на высоту текста

  • Переопределение высоты - Если не нулевое значение, высота текста всегда будет равна этой величине, независимо от масштаба устройства

  • Переопределение горизонтального выравнивания - Разрешение переопределения горизонтальной составляющей выравнивания текста в зависимости от точки вставки текста относительно устройства

  • Переопределение вертикального выравнивания - Разрешение переопределения вертикальной составляющей выравнивания текста в зависимости от точки вставки текста относительно устройства

  • Переопределение угла поворота - Разрешение переопределения угла поворота текста

  • Значение угла поворота - Абсолютное значение угла поворота

3.3.3. extdrVariables

Представляет собой хранилище дополнительных типизированных данных (Переменных) привязанных к примитиву. Каждая переменная имеет имя, тип и "пользователькое" имя. * Имя - идентификатор состоящий из латинских букв и цифр, начинается с буквы. По имени программа обращается к переменным и различает их. Имя регистронезависимо * Тип - определяет содержимое переменной, может быть как простым (Перечень простых типов данных), так и сложным. сложные типы являются комбинацией простых и определены в файле rtl\system.pas на паскалеподобном скриптовом языке * Пользователькое имя - имя переменной для пользователя, пользователь видтит его например в инспекторе обхектов, может быть любым

Перечень простых типов данных

Double

Число двойной точности

Single

Число одинарной точности

UnicodeString

Строка UTF16

String

Платформозависимо. UTF8/16 На данный момент строка UTF8, возможно станет UTF16

AnsiString

Строка UTF8

Boolean

False/True

Byte

8 бит, без знака

ShortInt

8 бит, c знаком

SmallInt

16 бит, c знаком

LongInt

32 бит, c знаком

Int64

64 бит, c знаком

Cardinal

Алиас к LongWord

Integer

Платформозависимо. 64/32/16 бит, c знаком

PtrInt

Размерность указателя, c знаком

Word

16 бит, без знака

LongWord

32 бит, без знака

QWord

64 бит, без знака

DWord

Алиас к LongWord

Uint64

Алиас к QWord

Pointer

Платформозависимо. Указатель 64/32/16 бит, c знаком

Набор и значения переменных у примитивов можно редактировать командами VarsEd и VarsEdSel Значения переменных доступны для изменения в инспекторе объектов (см. раздел 2. Инспектор объектов) при выделении примитивов. Значения переменных можно экспортировать-импортировать командами DataExport и DataImport

Примитивы в черетеже имеют древовидную структуру, так все примитивы являются дочерними объектами чертежа, примитивы в динамической части устройства это дочерние объекты этого устройства и т.д. При поиске у примитива какойлибо переменной и не нахождении ее зкад обращается к родительскому примитиву и ищет ее там, так пока не дойддет до вершины дерева - чертежа !!NEEDLINK!!

Централизация

Дополнительно к древовидной иерархии примитивов расширения переменных у разных примитивов могут ссылаться друг на друга. Этот механизм называется централизация

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

При таком объединении один примитив в связке выбирается главным (централь), другие сылаются на него (представители) В идеальном случае все переменные связки хранятся в централи, у представителей нет своих переменных, они лишь предоставляют доступ к централи, при такой организации у пользователя не возникает путаницы с фактическим местом нахождения переменной. Но также возможно хранить переменные и в представителях.

Создать централизованные примитивы можно командой VarsLink

3.4. Команды

3.4.1. 3DPoly

Команда:

3DPoly

Иконка:

pline

Меню:

Черчение > 3D Полилиния

Черчение примитива 3DPolyLine. После запуска команды последовательно указать мышью вершины полилинии. Завершение черчения - ESC или запуск другой команды

3.4.2. About

Команда:

About

Иконка:

about

Меню:

Справка > О программе

Показ окна "О программе"

AddToOwner

3.4.3. Arc

Команда:

Arc

Иконка:

arc

Меню:

Черчение > Дуга

Черчение примитива Arc (дуга) по 3м точкам. После запуска команды последовательно указать 3 точки дуги

3.4.4. BEdit

Команда:

BEdit

Иконка:

bedit

Меню:

Изменить > Блок/Устройство > Редактор блоков

Предвыбор примитивов:

Не требуется, но можно заранее выделить вставку редактируемого блока или устройства

Редактирование определения блока из чертежа. В случае если до запуска команды выбрана вставка блока, редактор переходит в режим редактирования определения этого блока. Если выделение отсутствует, команда позволяет выбрать редактируемое определение в инспекторе обхектов.

cmd params bedit
Рисунок 13. Опции команды BEdit

Текущий блок тут показан текущий редактируемый блок или Модель если редактирование блока не осуществляется, в окне чертежа отображено пространство модели. В поле Выбор блока можно выбрать блок для редактирования. При этом в окне чертежа откроется определение выбранного блока, а название вкладки чертежа поменяется на BEdit(ИмяЧертежа:ИмяБлока) После завершения редактирования повторный запуск BEdit вернет редактор в модель. Все внесенные изменения будут сохранены в определении блока без запроса на сохранение. Для обновления вставок блока на чертеже требуется выполнить регенерацию чертежа Regen Если редактировалась динамическая часть определения устройств, убновить ее для уже вставленных устройств возможно только повторной вставкой BlockReplace (заменить вставленные устройства на самих себя)

При переключении из пространства модели в пространство определения блока и обратно положение камеры не меняется, возможна ситуация когда после переключения в окне чертежа ничего не видно. Исправить ситуацию можно командой Zoom с опцией All - Zoom(All)

BlockPreViewExport BlockReplace BlockRotate BlockScale BlocksInBasePreViewExport

3.4.5. Cam_reset

Команда:

Cam_reset

Меню:

Вид > Камера в начало

Сброс текущих настроек видового окна чертежа (положения камеры), после выполнения команды в центре видового окна отображается начало координат, напрвление взгляда совпадает с осью Z

3.4.6. Cancel

Команда:

Cancel

Прерывает текущую выполняемую команду

ChangeProjType

3.4.7. Circle

Команда:

Circle

Иконка:

circle

Меню:

Черчение > Окружность >

Операнды:

CR, CD, 2P, 3P. Не обязательный (CR используется в случае не указания)

Пример использования:

Circle

Пример использования 2:

Circle(3P)

Черчение примитива Circle. После запуска команды последовательно задать точки на окружности, в зависимости от операнда клманды.

  • CR - укзывается центр и радиус окружности

  • CD - укзывается центр и диаметр окружности

  • 2P - укзывается центр 2 точки на окружности (лежащие на концах диаметра)

  • 3P - укзывается центр 3 точки на окружности

Circle2 ClearFileHistory Colors

Connection2Dot

3.4.8. Copy

Команда:

Copy

Иконка:

copy

Сочетания клавиш:

Ctrl+ALT+C; C

Предвыбор примитивов:

Требуется

Копирование выбраных примитивов. Исходные примитивы нужно выбрать до запуска команды. После запуска требуется базовую точку для копирования и базовые точки для вставки. Завершение копирования - ESC или запуск другой команды

3.4.9. CopyBase

Команда:

CopyBase

Иконка:

copyclipbase

Сочетания клавиш:

Ctrl+Shift+C

Меню:

Правка > Копировать в буфер обмена с базовой точкой

Предвыбор примитивов:

Требуется

Копирует выбраные примитивы в буфер обмена, перед копированием нужно указать базовую точку

3.4.10. CopyClip

Команда:

CopyClip

Иконка:

copyclip

Сочетания клавиш:

Ctrl+C; Ctrl+INS

Меню:

Правка > Копировать в буфер обмена

Предвыбор примитивов:

Требуется

Копирует выбраные примитивы в буфер обмена

CopyFromOwner

3.4.11. CutClip

Команда:

CutClip

Иконка:

cutclip

Сочетания клавиш:

Ctrl+X

Меню:

Правка > Вырезать в буфер обмена

Предвыбор примитивов:

Требуется

Копирует выбраные примитивы в буфер обмена и стирает их из чертежа

DBaseAdd DBaseLink DBaseRename

3.4.12. DataExport

Команда:

DataExport

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

cmdprompt dataexport

Что позволяет выполнить в командной строке следующие действия:

1. Задать имя файла с экспортируемыми значениями

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

2. Задать фильтр примитивов

Ожидание ввода значения фильтра примитивов по типу. см. Формат фильтра по типам примитивов

3. Задать фильтр свойств примитивов

Ожидание ввода значения фильтра примитивов по параметрам. см. Формат фильтра по свойствам примитивов

4. Задать скрипт экспорта

Ожидание ввода скрипта выполняющего экспорт. см. Формат скрипта экспорта

5. Задать имя файла в диалоговом режиме

Откроет диалог выбора файла, можно выбрать любой файл csv. Выбор файла сделает его файлом по умолчанию и также как (1) выполнит экспорт и завершит команду

Также все это можно сделать с помошью инспектора объектов, который при выполнении команды имеет вид:

cmd params dataexport
Рисунок 14. Опции команды DataExport
Формат фильтра по типам примитивов

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

Оператор(Операнд)[;Оператор(Операнд)]

Операторы могут разделяться точкой с запятой, запятой, пробелом, переводом строки. Доступны следующие операторы:

IncludeEntityMask('Mask*')

Включить типы примитивов по маске

IncludeEntityName('Name')

Включить тип примитивов по имени

ExcludeEntityMask('Mask*')

Исключить типы примитивов по маске

ExcludeEntityMask('Name')

Исключить тип примитивов по имени

Все операторы в качестве операнда принимают строковой параметр заключенный в апострофы.
Примеры фильтров примитивов:
Включить в экспорт примитивы Cable и Device:

IncludeEntityName('Cable');
IncludeEntityName('Device')

Включить в экспорт все типы примитивов:

IncludeEntityMask('*')

Включить в экспорт примитивы PolyLine и Line:

IncludeEntityName('*Line') ExcludeEntityName('3DPolyLine')
Формат фильтра по свойствам примитивов

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

Оператор(Операнд[,Операнд])[;Оператор(Операнд[,Операнд])]

Операторы могут разделяться точкой с запятой, запятой, пробелом, переводом строки. Доступны следующие операторы:

IncludeIfMask(Операнд,'Маска*')

Включить примитив в результат если операнд соответствует маске

IncludeIfSame(Условие)

Включить примитив в результат в случае выполнения условия

Условный операторы пока доступен только один:

SameMask(Операнд1,'Маска')

Условие считается выполненным если текстовое значение операнда1 соответствует маске

Or(Условие1,Условие2)

Объединение условий 1 и 2 по закону ИЛИ

Доступные типы операндов:

'Строка'

Строковой параметр - любой текст заключенный в апострофы

%%('ИмяПараметра')

Возвращает значение параметра текущего примитива в виде строки

Имена параметров для разных примитивов могут отличатся, в общем случае это параметры доступные в инспекторе объектов для данного типа примитивов, в случае отсутствия у примитива данного параметра возвращается пустая строка. Примерный перечень доступных параметров смотри в https://github.com/zamtmn/zcad/blob/master/cad_source/zcad/gui/odjectinspector/uzcoiregistermultiproperties.pas
Примеры фильтров по свойствам примитивов:
Включить в результат только примитивы типа кабель, или примитивы с параметром 'Name' удовлетворяющим маске 'CABLE_*' (это блоки\устройства, т.к. только у них есть имя)

IncludeIfSame(
              Or(SameMask(%%('Name'),'CABLE_*'),
              SameMask(%%('EntityName'),'Cable'))
             )

Включить в результат только примитивы с параметром 'Name' удовлетворяющим маске 'EL_CABLE_*' (это блоки\устройства, т.к. только у них есть имя)

IncludeIfMask(%%('Name'),'EL_CABLE_*')
Формат скрипта экспорта

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

Оператор(Операнд[,Операнд])[;Оператор(Операнд[,Операнд])]

Операторы могут разделяться точкой с запятой, запятой, пробелом, переводом строки. Доступны следующие операторы:

Export(Операнд1[,Операнд2, ...])

записать строку операндов c разделителями в новую строку файла csv

DoIf(Условие,Оператор)

Выполнить оператор в случае выполнения условия

Условный операторы пока доступен только один:

SameMask(Операнд1,'Маска')

Условие считается выполненным если текстовое значение операнда1 соответствует маске

Доступные типы операндов:

'Строка'

Строковой параметр - любой текст заключенный в апострофы

%%('ИмяПараметра')

Возвращает значение параметра текущего примитива в виде строки

@@('ИмяПеременной')

Возвращает значение переменной текущего примитива в виде строки

Имена переменных могут быть любыми, в случае отсутствия у примитива данной переменной возвращается значение '!!ERR(ИмяПеременной)!!'. Имена параметров для разных примитивов могут отличатся, в общем случае это параметры доступные в инспекторе объектов для данного типа примитивов, в случае отсутствия у примитива данного параметра возвращается пустая строка. Примерный перечень доступных параметров смотри в https://github.com/zamtmn/zcad/blob/master/cad_source/zcad/gui/odjectinspector/uzcoiregistermultiproperties.pas

Примеры скриптов экспорта:

Если текущий примитив устройство, записываем в csv строку 'Device','NMO_Name',Значение переменной NMO_Name,'Position',Значение переменной Position

DoIf(
     SameMask(%%('EntityName'),'Device'),
     Export(%%('EntityName'),'NMO_Name',@@('NMO_Name'),'Position',@@('Position'))
     )

Если текущий примитив устройство, записываем в csv строку 'Device','NMO_Name',Значение переменной NMO_Name,'Power',Значение переменной Power

DoIf(
     SameMask(%%('EntityName'),'Device'),
     Export(%%('EntityName'),'NMO_Name',@@('NMO_Name'),'Power',@@('Power'))
     )

Если текущий примитив кабель, записываем в csv строку 'Cable','NMO_Name',Значение переменной NMO_Name,'AmountD',Значение переменной AmountD

DoIf(
     SameMask(%%('EntityName'),'Cable'),
     Export(%%('EntityName'),'NMO_Name',@@('NMO_Name'),'AmountD',@@('AmountD'))
     )

Если текущий примитив кабель, записываем в csv строку 'Cable','NMO_Name',Значение переменной NMO_Name,'CABLE_Segment',Значение переменной CABLE_Segment

DoIf(SameMask(%%('EntityName'),'Cable'),
     Export(%%('EntityName'),
            'NMO_Name',@@('NMO_Name'),
            'CABLE_Segment',@@('CABLE_Segment'))
     )

3.4.13. DataImport

Команда:

DataImport

Операнды:

Не обязательный. Путь и имя файла CSV

Пример использования:

DataImport

Пример использования 2:

DataImport(E:\myfile.csv)

Импорт данных примитивов из внешнего файла CSV. При вызове без параметров будет открыто окно выбора файла, после выбора данные будут импортированы из соответствующего файла. Имя файла можно передать параметром, тогда данные из файла будет импортированы сразу, без окна выбора. В составе строки параметра могут использоваться макросы !!NEEDLINK!!.
Разделителем в CSV файле должна быть точка с запятой, файл должен состоять из строк следующей структуры:

ИмяПримитива

Переменная1

Значение1

…​

…​

ПеременнаяN

ЗначениеN

Где ИмяПримитива - внутреннее имя примитива ZCAD, например DEVICE, CABLE и т.д.
Далее попарно идут Переменная - имя переменной, Значение - значение данной переменной. Причем все переменные кроме последней являются идентифицирующими, последняя переменная - собственно импортируемое значение
Например при импорте следующей строки:

DEVICE

NMO_Name

M1

Position

10

Power

1.5

Произойдет следующее: с текущего чертежа будут выбраны все устройства (примитивы DEVICE) среди них будут отобраны имеющие имя M1 (переменная NMO_Name='M1') и позицию 10 (переменная Position=10) при наличии у отобраных устройств переменной Power ей будет присвоено значение 1.5 Если переменной Power у устройства нет с ним никаких действий произведено небудет.

dbgAppExplorer dbgBlocksList dbgClipboard dbgCmdList dbgGetAV dbgMemSummary dbgPlaceAllBlocks DeSelectAll

3.4.14. DevDefSync

Команда:

DevDefSync

Предвыбор примитивов:

Требуется

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

DimAligned DimDiameter DimLinear DimRadius DimStyles Dist

3.4.15. DockingOptions

Команда:

DockingOptions

Показ модального окна настройки параметров стыковки. Также окно натройки можно вызвать в контекстном меню сплитеров и заголовков окон докинга

zcad ui dockingoptions
Рисунок 15. Окно настройки параметров стыковки

!!NEEDDETAILS!!

3.4.16. DWGClose

Команда:

DWGClose

Иконка:

close

Сочетания клавиш:

Ctrl+F4

Меню:

Файл > Закрыть

Закрыть текущий чертеж. В случае присутствия изменений в чертеже, будет предложено сохранить файл чертежа на диск

3.4.17. DWGNew

Команда:

DWGNew

Иконка:

new

Сочетания клавиш:

Ctrl+N

Меню:

Файл > Новый чертеж

Создать новый чертеж. !!NEEDDETAILS!!

3.4.18. DWGNext

Команда:

DWGNext

Сочетания клавиш:

Ctrl+Tab

Меню:

Окно > Следующее окно

Если в программе открыто несколько чертежей текущим становится следующий открытый чертеж

3.4.19. DWGPrev

Команда:

DWGPrev

Сочетания клавиш:

Ctrl+Shift+Tab

Меню:

Окно > Предидущее окно

Если в программе открыто несколько чертежей текущим становится предидущий открытый чертеж

EL_AutoGen_Cable_Remove EL_Cable EM_SEPBUILD EM_SRBUILD El_CableMan El_Cable_Invert El_Cable_Join El_Cable_Legend El_Cable_RenN_0N El_Cable_Select El_ExternalKZ El_Find El_Leader El_Material_Legend El_Wire El_Wire

3.4.20. Erase

Команда:

Erase

Иконка:

erase

Сочетания клавиш:

Del

Меню:

Правка > Стереть

Предвыбор примитивов:

Требуется

Стирает выбранные примитивы на чертеже

ExampleCreateLayer ExampleInsertDevice ExecuteFile ExportDevWithAxis ExportTextToCSV

3.4.21. extdrRemove

Команда:

extdrRemove

Предвыбор примитивов:

Требуется

Операнды:

Обязательный. Имя расширения

Пример использования:

extdrRemove(extdrVariables)

Отвязка указанного расширения (см. Расширения примитивов) от выбраных примитивов. В случае к выбраному примитиву не привязано данное расширение, он будет проигнорирован

3.4.22. extdrAllList

Команда:

extdrAllList

Команда выводит список доступных для привязки расширений (см. Расширения примитивов)

3.4.23. extdrEntsList

Команда:

extdrEntsList

Предвыбор примитивов:

Требуется

Команда выводит список привязаных к выбранным примитивам расширений (см. Расширения примитивов)

3.4.24. extdrAdd

Команда:

extdrAdd

Предвыбор примитивов:

Требуется

Операнды:

Обязательный. Имя расширения

Пример использования:

extdrAdd(extdrVariables)

Привязка указанного расширения (см. Расширения примитивов) к выбраным примитивам. В случае к выбраному примитиву уже привязано данное расширение, он будет проигнорирован

FindAllIntersections Get3DPoint Get3DPoint_DrawRect GetLength GetPoint GetRect GetVertexX GetVertexY GetVertexZ Help Import Insert Insert2 InsertLayersFromBase InsertTestTable InverseSelected KIP_CDBuild KIP_Cable_Mark KIP_LugTableBuild

3.4.25. Layer

Команда:

Layer

Иконка:

layers

Меню:

Format > Слои …​

Показ модального окна управления слоями

zcad ui layersform prepare
Рисунок 16. Окно управления слоями

!!NEEDDETAILS!!

LayerOff LayerOn LayOff Line LineOld LineTypes

3.4.26. Load

Команда:

Load

Иконка:

open

Сочетания клавиш:

Ctrl+O

Меню:

Файл > Открыть

Операнды:

Не обязательный. Путь и имя файла dxf

Пример использования:

Load

Пример использования 2:

Load(E:\myfile.dxf)

Загрузка файла DXF. При вызове без параметров будет открыто окно выбора файла, после выбора будет открыт данный файл. Имя файла можно передать параметром, тогда файл будет открыт сразу, без окна выбора. В составе строки параметра могут использоваться Макросы сокращений путей, например команда Load($(ZCADAutoSaveFilePath)) приведет к загрузке файла автосохранения

3.4.27. LoadActions

Команда:

LoadActions

Операнды:

Обязательный. Путь и имя файла с описанием экшенов

Пример использования:

LoadActions(E:\actionscontent.xml)

Загрузка файла описаний экшенов !!NEEDLINK!!. Загрузка обычно происходит на ранней стадии запуска программы, поэтому команда обычно используется в скрипте $(ZCADPath)/preload/stage0.cmd0 !!NEEDLINK!!.

3.4.28. LoadLayout

Команда:

LoadLayout

Операнды:

Не обязательный. Имя файла раскладки окон и тулбаров

Пример использования:

LoadLayout

Пример использования 2:

LoadLayout(defaultlayout.xml)

Загрузка и применение файла раскладки окон !!NEEDLINK!!. При отсутствии операнда будет произведена загрузка файла раскладки поумолчанию !!NEEDLINK!!. При отсутствии файла раскладки указанного поумолчанию будет загружен файл defaultlayout.xml Файлы раскладки ищутся в папке $(ZCADPath)/components

3.4.29. LoadMenus

Команда:

LoadMenus

Операнды:

Обязательный. Путь и имя файла с описанием меню

Пример использования:

LoadMenus(E:\menuscontent.xml)

Загрузка файла описаний меню !!NEEDLINK!!. Загрузка обычно происходит на ранней стадии запуска программы, поэтому команда обычно используется в скрипте $(ZCADPath)/preload/stage0.cmd0 !!NEEDLINK!!.

3.4.30. LoadPalettes

Команда:

LoadPalettes

Операнды:

Обязательный. Путь и имя файла с описанием палитр

Пример использования:

LoadPalettes(E:\palettescontent.xml)

Загрузка файла описаний палитр !!NEEDLINK!!. Загрузка обычно происходит на ранней стадии запуска программы, поэтому команда обычно используется в скрипте $(ZCADPath)/preload/stage0.cmd0 !!NEEDLINK!!.

3.4.31. LoadToolbars

Команда:

LoadToolbars

Операнды:

Обязательный. Путь и имя файла с описанием тулбаров

Пример использования:

LoadMenus(E:\toolbarscontent.xml)

Загрузка файла описаний тулбаров !!NEEDLINK!!. Загрузка обычно происходит на ранней стадии запуска программы, поэтому команда обычно используется в скрипте $(ZCADPath)/preload/stage0.cmd0 !!NEEDLINK!!.

3.4.32. MatchProp

Команда:

MatchProp

Иконка:

matchprop

Пример использования:

MatchProp

Перенос свойств примитива на другие примитивы. После запуска предлагается выбрать исходный примитив, чьи свойства будут взяты как исходные. После выбора в инспекторе объектов будут показаны опции команды

cmd params matchprop
Рисунок 17. Опции команды MatchProp

Далее предлагается выбрать целевые примитивы, свойства исходного примитива отмеченые в опциях будут присвоены целевым примитивам.

3.4.33. Merge

Команда:

Merge

Операнды:

Обязательный. Путь и имя файла dxf

Пример использования:

Merge(E:\myfile.dxf)

Подгружает файл DXF в текущий чертеж. Повторные определения блоков игнорируются

3.4.34. MergeBlocks

Команда:

MergeBlocks

Операнды:

Обязательный. Путь и имя DXF файла

Пример использования:

MergeBlocks (E:\actionscontent.xml)

Подгружает файл DXF в библиотеку блоков !!NEEDLINK!!. Повторные определения блоков игнорируются !!NEEDLINK!!. Загрузка обычно происходит на стадии запуска программы, поэтому команда обычно используется в скрипте $(ZCADPath)/preload/autorun.cmd !!NEEDLINK!!.

3.4.35. Mirror

Команда:

Mirror

Иконка:

mirror

Предвыбор примитивов:

Требуется

Зеркальное отражение выбраных примитивов относительно прямой. Исходные примитивы нужно выбрать до запуска команды. После запуска требуется указать 2 точки лежащие на прямой относительно которой будет произветено отражение. Во время указания прямой в инспекторе объектов можно указать действие над исходными примитивами - удалить или отавить в чертеже

3.4.36. Move

Команда:

Move

Иконка:

move

Сочетания клавиш:

Ctrl+ALT+M; M

Предвыбор примитивов:

Требуется

Перенос выбраных примитивов. Исходные примитивы нужно выбрать до запуска команды. После запуска требуется указать 2 точки вектора на который будет произветен перенос.

MultiSelect2ObjIbsp NavSelectSubNodes NumDevices OPS_SPBuild OPS_Sensor_Mark ObjInspCopyToClip OnDrawingEd Options OrtoDevPlace Pan PasteClip PlaceSmokeDetectorOrto PolyDiv PolyEd PolyTest Polygon Print ProfileBuild ProjectTree QSave Quit ReadBlockLibrary RebuildTree Rectangle Redo Regen RegenZEnts

3.4.37. Rotate

Команда:

Rotate

Иконка:

rotate

Сочетания клавиш:

Ctrl+ALT+R; R

Предвыбор примитивов:

Требуется

Поворот выбраных примитивов. Исходные примитивы нужно выбрать до запуска команды. После запуска требуется указать точку определяющую угол поворота.

RotateEnts

3.4.38. SaveAs

Команда:

SaveAs

Иконка:

saveas

Сочетания клавиш:

Shift+Ctrl+S

Меню:

Файл > Сохранить как …​

Сохранить текущий чертеж под новым именем. Будет открыто окно выбора файла, после чего произойдет сохранение. Имя чертежа будет изменено, дальнейшие команды QSave будут сохранять файл под новым именем

3.4.39. SaveLayout

Команда:

SaveLayout

Меню:

Настройки > Сохранить разбивку окон по умолчанию

Соxранить текущую разбивку окон как разбивку по умолчанию в файл $(ZCADPath)/components/defaultlayout.xml

3.4.40. SaveOptions

Команда:

SaveOptions

Меню:

Настройки > Сохранить параметры

Соxранить текущие настройки программы в файлы $(ZCADPath)/rtl/sysvar.pas !!NEEDLINK!! и $(ZCADPath)/rtl/config.xml !!NEEDLINK!!

Scale SelMat SelObjChangeColorToCurrent SelObjChangeDimStyleToCurrent SelObjChangeLTypeToCurrent SelObjChangeLWToCurrent SelObjChangeLayerToCurrent SelObjChangeTStyleToCurrent SelSim SelectAll SelectFrame SelectObjectByAddres SelectOnMouseObjects SetObjInsp Show ShowPage ShowToolBar SnapProperties StoreFrustum Stretch Text TextStyles TreeStat Undo Units UnitsMan

3.4.41. UpdatePO

Команда:

UpdatePO

Обновление файлов локазизации (Локализация программы), выполнить команду можно только запустив программу с ключем командной строки updatepo (Переключатели коммандной строки) Команда позволяет записать в файл languages\rtzcad.po все новые строки требующиеперевода обнаруженные в файлах данных при этом запуске программы и стереть из данного файла строки которые требовали перевода раньше, но при этом запуске обнаружены небыли. Команда выводит диалоговое окно на подтверждение действий, в случае подтверждения, rtzcad.po перезаписывается

VarReport

3.4.42. VarsEd

Команда:

VarsEd

Иконка:

varsed

Меню:

Изменить > Редактор переменных примитива

Предвыбор примитивов:

Примитив, редактирование переменных которого будет осуществляться

!!NEEDDETAILS!!

3.4.43. VarsEdBD

Команда:

VarsEdBD

Операнды:

Обязательный. Имя блока набор переменных которого будет редактироваться

Пример использования 2:

Load(DEVICE_PS_SMOKE)

!!NEEDDETAILS!!

3.4.44. VarsEdSel

Команда:

VarsEdSel

Иконка:

varsedsel

Меню:

Изменить > Редактор переменных нескольких примитивов

Предвыбор примитивов:

Примитивы, редактирование переменных которых будет осуществляться

!!NEEDDETAILS!!

Команда:

VarsLink

Создание централизованной связки примитивов (см. Централизация) После запуска команды предлагается указать главный примитив звязки (централь) затем его представителей. Указанные примитивы должны иметь расширение extdrVariables и не участвовать в других связках

!!NEEDDETAILS!!

View Zoom ZoomWindow ft rt test

4. Настройка программы

4.1. Параметры работы

ZCAD пока не имеет отдельного окна настроек, настройки постоянно доступны в инспекторе объектов (см. раздел 2. Инспектор объектов) когда на чертеже не выбрано никаких примитивов.

zcad oi options
Рисунок 18. Настройки программы

Настройки сгруппированы следующим образом

  • Пути - настройка путей программы

  • Графика - настройка путей программы

  • Отображение - настройка путей программы

  • Система - настройка путей программы

  • Черчение - настройка путей программы

  • Проектирование - настройка путей программы

  • Интерфейс - настройка путей программы

4.1.1. Пути

На данной вкладке сгруппированы пути используемые программой для поиска файлов.

  • Файлы поддержки - пути поиска различных файлов программы

  • Шрифты - пути поиска шрифтов

  • Файл альтернативного шрифта - файл шрифта используемый для замены отсутствующих шрифтов

  • Шаблоны - путь для поиска файлов шаблонов чертежей

  • Шаблон по умолчанию - файл шаблона используемый программой при создании нового чертежа

  • Текущая раскладка окон - файл раскладки окон загружаемый при запуске программы

  • Программа - путь к бинарному файлу (вычисляется при запуске, доступен только для чтения)

  • Временные файлы - путь к папке временных файлов (вычисляется при запуске, доступен только для чтения)

  • База описаний устройств - путь к "базе данных" оборудования программы

В качестве разделителя для путей используется ";", разделитель путей "/", также доступны следующие макросы:

Таблица 3. Макросы сокращений путей

$(ZCADPath)

Путь к бинарному файлу

$(ZCADAutoSaveFilePath)

Путь к файлу автосохранения

$(TEMP)

Путь к папке временных файлов

$(SystemFontsPath)

Путь к папке шрифтов ОС (пока только win, возвращает SHGetSpecialFolderPath(CSIDL_FONTS))

$(UserFontsPath)

Путь к папке шрифтов пользователя (пока только win, возвращает SHGetSpecialFolderPath(CSIDL_LOCAL_APPDATA)\Microsoft\Windows\Fonts)

4.1.2. Графика

На данной вкладке сгруппированы настройки графической подсистемы зкад

  • Устройство отображения - графическая библиотека используемая для рендера чертежа. Доступны варианты: OpenGL - предпочтительный вариант (требует наличия драйвера производителя видеокарты), GDI - вариант для случая когда первый вариант не работает, LCLCanvas - данный вариант не предназначен для работы с чертежом, но если не работают на OpenGL, ни GDI можно попробовать его. Настройка работает только для вновь открытых/созданных чертежей, уже открытые чертежи по прежнему будут использовать устройство отображения выбранное на момент их создания

  • Параметры текущего устройства отображения - здесь собраны некоторые настройки и отладочная информация устройства отображения используемого текущим чертежом

  • Версия GLU - версия библиотеки GLU используемая программой (используется для триангуляции и построения сплайнов, ZCAD не может работать с реализацией GLU от Microsoft, в комплекте поставляется MESA GLU) (доступен только для чтения)

  • Расширения GLU - список расширений предоставляемый GLU (доступен только для чтения)

  • Время рендера - время в милисекундах затраченое на последнее полное отображение чертежа (доступен только для чтения)

  • Время обновления - время в милисекундах затраченое на последнее последнее обновление чертежа. Для экономии ресурсов ZCAD старается по возможности не перечерчивать весь чертеж, а только обновлять его измененные фрагменты (доступен только для чтения)

  • Максимальное время одного прохода рендера - время в милисекундах доступное на рендер чертежа, в случае его превышения ретдер будет остановлен и продолжен в следующем цикле обработки событий. 0 - возможность не используется (доступен только для чтения)

  • Ухудшение изображения - параметры управления детализацией отрисовки чертежа. При включеении и превышении порога времени рендера, детализация чертежа будет уменьшаться для уменьшения времени отрисовки

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

  • Максимально шаблонов типа в линии - Максимально доступное количество штрихов\точек\символов в примитивах, при превышении примитив будет отрисован сплошной линией

4.1.3. Отображение

  • Системная геометрия - отображение некоторой вспомогательной информации, например габаритов примитивов

  • Цвет вспомогательной геометрии - цвет для выыода информации из предидущего пункта

  • Масштаб колеса мыши - коэффициент масштабирования чертежа при вращении колеса

  • Размер амертуры привязки - размер в пикселях зоны "притягивания" курсора к точкам привязки

  • Размер прицела - размер в процентах от размера видимой области графического курсора ZCAD

  • Убирать системный курсор в области отрисовки - опция отключает системнвй курсоп при черчении, оставляя только курсор ZCAD

  • Размер ручек - размер "ручек" редактирования примитивов

  • Цвет фона - RGB цвет фона чертежа

  • Цвет не выбраных ручек - индексный цвет "ручек" примитивов

  • Цвет выбраных ручек - индексный цвет выбраных "ручек" примитивов

  • Цвет горячих ручек - индексный цвет "ручек" находящихся под курсором

  • Масштаб отображения толщин линий - число от 2 до 20 характеризующее толщину отображения веса линий на чертеже, больше - жирнее

  • Толщина линий по умолчанию - толщина линий принятая для отображения веса линий Default

4.1.4. Система

  • Версия программы - версия сборки в формате git describe --tags (доступен только для чтения)

  • Информация о сборке - разня информация: целевая платформа, версия компилятора и т.п. (доступен только для чтения)

  • Время работы - длительность текущей сессии (доступен только для чтения)

  • Один экземпляр - контроль повторного запуска программы. При установке данного параметра возможен запуск только одной сессии программы, попвтки запустить следующую сессию только активируют уже запущенную

  • Не показывать заставку - отключение сплэш скрина при запуске программы

  • Не загружать раскладку окон - не загружает файл раскладки окон программы при старте, программа запускается в "отдоканом" режиме (доступен только для чтения, устанавливается ключем командной строки !!NEEDLINK!!)

  • Обновления PO файлов - режим контроля и обновления фпйлов локализации программы, используется совместно с командой UpdatePO !!NEEDLINK!! (доступен только для чтения, устанавливается ключем командной строки !!NEEDLINK!!)

4.1.5. Сохранение

  • Автосохранение - включает работу автосохранения

  • Время до автосохранения - время в секундах оставшееся до очередного автосохранения (доступен только для чтения)

  • Время между автосохранениями - настройка времени между сохранениями в секундах

  • Файл автосохранения - путь и имя файла автосохранения

4.1.6. Черчение

  • Отображать вес линий - Включение отображения веса линий

  • Режим привязки - Битовая маска настроек привязок. в данном месте просто для информации, не используется

  • Режим полярной трассировки - Включение трассировки

  • Текущий слой - отображает и позволяет редактировать текущий слой

  • Текущий вес линии - отображает и позволяет редактировать текущий вес линии

  • Текущий вес цвет - отображает и позволяет редактировать текущий цвет

  • Масштаб типов линий чертежа - отображает и позволяет редактировать глобальный масштаб типов линий чертежа

  • Текущий масштаб типов линий примитивов - отображает и позволяет редактировать текущий масштаб типов линий

  • Стиль размеров - отображает и позволяет редактировать текущий стиль размеров

  • Поворачивать текст в описании линий - Поворачивает текстовые элементы в стилях линий для более удобного чтения

  • Стиль текста - отображает и позволяет редактировать текущий стиль текста

  • LUnits (формат линейных едениц) - аналог DXF переменной LUnits

  • LUPrec (точность линейных едениц) - аналог DXF переменной LUPrec

  • AUnits (формат угловых едениц) - аналог DXF переменной AUnits

  • AUPrec (точность угловых едениц) - аналог DXF переменной AUPrec

  • AngDir (направление положительного угла) - аналог DXF переменной AngDir

  • AngBase (базовый угол) - аналог DXF переменной AngBase

  • InsUnits (масштаб вставки блока) - аналог DXF переменной InsUnits

  • TextSize (размер вновь созданных текстовых примитивов) - аналог DXF переменной TextSize

  • Настройка шаговой привязки - настройки привязки к регулярной прямоугольной сетке

  • Шаг сетки - настройки отображения регулярной прямоугольной сетки

  • Показать сетку - включение отображения сетки

  • Шаг - включение шаговой привязки

  • Редактирование составных объектов - включение отдельного выделения примитивов являющихся частью сложных примитивов !!NEEDLINK!!

  • Вспомогательная гелметрия - отображение вспомогательной геометрии

  • Отображать выбранный объект в инспекторе - показывать свойства выбранного примитива в инспекторе

4.2. Структура директорий

Общая структура директорий программы имеет вид:

Failed to generate image: Broken pipe
!include styles/filesystem-tree-style.iuml
legend
**cad**
|_ **autosave** //для файлов автосохранения//
|_ **bin** //бинарные файлы в подкаталогах по платформам//
  |_ **i386_win32**
  |_ **x86_64_win64**
|_ **blocks** //библиотека блоков//
  |_ **el**
  |_ **general**
  |_ **ops**
|_ **components** //разлирчнве скрипты, конфигурационные файлы//
|_ **fonts** //шрифты shx и ttf//
|_ **images** //иконки//
  |_ **actions**
  |_ **draw**
  |_ **dim**
  |_ **snap**
  |_ **valec**
  |_ **zelectro**
  |_ **palettes**
|_ **languages** //файлы локализаций//
|_ **log** //логи//
|_ **menu** //конфигурационные файлы элементов пользовательского интерфейса//
  |_ **BMP** //устаревшее расположение иконок//
|_ **plugins** //для будущего применения//
|_ **preload** //папка для скриптов выполяемых при запуске программы//
|_ **programdb** //встроенная база оборудования//
|_ **rtl** //различные скрипты//
  |_ **dwg**
  |_ **objcalc**
  |_ **objdefunits**
  |_ **include**
  |_ **styles**
  |_ **velec**
|_ **sample** //примерв//
|_ **template** //шаблоны пустых чертежей//
end legend

Отдельно стоит рассмотреть содержимое директории components:

Failed to generate image: Broken pipe
!include styles/filesystem-tree-style.iuml
legend
**components**
|_ **autorun.cmd** //командный скрипт выполняемый на последней стадии запуска программы//
|_ **blockpreviewexport.cmd** //командный скрипт генерации иконок встроенных устройств//
|_ **stage0.cmd0** //командный скрипт выполняемый на раннней стадии запуска программы//
|_ **_sys.dxf** //файл с определениями блоков размерных стрелок. Устарел.//
|_ **empty.dxf** //пустой файл используемый как шаблон для сохранения dxf//
|_ **zcad.lin** //встроенные описания типов линий//
|_ **logo.png** //сплашскрин. надо перекинуть в images//
|_ **oldpalette.rgb** //устаревшее определение цветов//
|_ **palette.rgb** //текущее автокад совместимое определение цветов//
|_ **main.sf** //используется командой получения спецификаций//
|_ **32inch_2560x1440.xml** //вариант раскладки окон//
|_ **defaultlayout.xml** //вариант раскладки окон//
|_ **defaultlayoutbackup.xml** //вариант раскладки окон//
|_ **myfulscreen.xml** //вариант раскладки окон//
|_ **suppressedshortcuts.xml** //файл подавления сочетаний клавиш//
|_ **testlayout.xml** //вариант раскладки окон//
end legend

И директорию preload:

Failed to generate image: Broken pipe
!include styles/filesystem-tree-style.iuml
legend
**preload**
|_ **autorun.cmd** //командный скрипт выполняемый на последней стадии запуска программы//
|_ **stage0.cmd0** //командный скрипт выполняемый на раннней стадии запуска программы//
end legend

Также после выполнения скрипта stage0.cmd0 будут выполнены все скрипты[.filepath].cmd0 лежащие в данной директории и ниже по иерархии файловой системы, а после выполнения скрипта autorun.cmd будут выполнены все скрипты[.filepath].cmd лежащие в данной директории и ниже в данной директории и ниже

4.3. Переключатели командной строки

При запуске ZCAD из коммандной строки можно задать опции коммандной строки корректирующие его поведение. Некоторые опции работают как флаги, некоторые опции требуют указания аргументов

Таблица 4. Переключатели коммандной строки

nosplash

Не показывать сплэшскрин

updatepo

Обновить файлы локализации (используется совместно с командой UpdatePO) ведет учет всех запросов на локализацию, помечает неиспльзуемые и добавляет вновь встреченые строки. При использовании ключа фактически перевод строк не производится, интерфейс остается английским

noloadlayout

Не загружать файл раскладки окон

notcheckuniqueinstance

Не проверять повторный запуск, с данным ключем может быть запущено несколько копий программы

logfile

Принудительно задать путь к лог файлу. Требует аргумент - путь и имя файла

leam

Принудительно разрешить все модули логирования

lem

Принудительно разрешить укзанный модуль (модулии) логирования. Требует аргумент(ы) - имя модуля(лей)

ldm

Принудительно запретить укзанный модуль (модулии) логирования. Требует аргумент(ы) - имя модуля(лей)

lemm

Принудительно разрешить модулии логирования чьи имена соответствуют маске(кам). Требует аргумент(ы) - маску(ки) имени модуля(лей)

ldmm

Принудительно запретить модулии логирования чьи имена соответствуют маске(кам). Требует аргумент(ы) - маску(ки) имени модуля(лей)

lcl

Установить уровень логирования. Требует аргумент - уровень логирования

maxstackframecount

Установить максимальную глубину размотки стека при обработке ошибок

runscript

Запустить скрипт(ы) после запуска программы. Требует аргумент(ы) - Имя файла(ов) скрипта(ов)

Таблица 5. Уровни логирования

LM_Trace

Вывод всего подряд. Максимально подробный и перегруженный лог.

LM_Debug

Журналирование моментов вызова «крупных» операций

LM_Info

Разовые операции, которые повторяются крайне редко, но не регулярно. (загрузка конфига, плагина, запуск бэкапа)

LM_Warning

Неожиданные параметры вызова и т.п. Вообще все, что может свидетельствовать о не штатном использовании.

LM_Error

Вывод сообщений об ошибках.

LM_Fatal

Вывод сообщений об критических ошибках, имхо стоит убрать.

LM_Necessarily

Вывод в любом случае.

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

Список доступных модулей логирования пока не определен, его можно посмотреть в конце лога при штатном запуске

Пример запуска программы:

zcad nosplash logfile d:\zcad.log lem translator,shx ldm default lcl lm_trace

Не показывать сплэшскрин,переназначить вывод лога в d:\zcad.log, разрешить вывод сообщений в лог от системы (модуля) перевода и парсера shx шрифтов, запретить сообщения модуля по умолчанию, установить уровень логирования LM_Trace

5. Для разработчика

5.1. Cборка программы из исходников

Программа имеет 2 режима сборки ZCAD и ZCADELECTROTECH, в первом только базовые CAD функции, во втором плюсом чуток электрической специфики. Советую пробовать собрать ZCADELECTROTECH, т.к. я его сам всегда использую, соответственно он более стабилен.

Простая компиляция исходников даст вам только файл zcad.exe, но для для работы нужны некоторые другие файлы, без которых программа не работает (не говоря о allgeneratedfiles.inc, zcadversion.inc и buildmode.inc без которых даже не скомпилируется)

Для автоматизации процесса сборки был написан скрипт на основе сисемы сборки make. Опишу его использование применительно к тридцатидвух битным Lazarus2.2 и fpc3.2.2 под управлением ОС Windows

Итак:

5.1.1. Установка Lazarus

Устанавливаем последний релизный Lazarus (2.2 на момент написания текста). Гарантированно ZCAD компилится в транковом Lazarus транковым fpc, с релизами бывают нюансы, но они решаемы.

Запускаем, проверяем работоспособность Lazarus - собираем тестовый пустой проект. тут проблем быть не должно.

Ищем идущую в комплекте fpc утилиту make, она скорее всего лежит тут lazarus\fpc\3.2.2\bin\i386-win32\make.exe но, мало ли. В дальнейшем я считаю что Lazarus установлен на диск C, и путь для запуска make соответственно C:\lazarus\fpc\3.2.2\bin\i386-win32\make.exe если что - уточнить по месту)).

Также еще понадобятся такие пути:

  • путь к Lazarus C:\lazarus

  • путь к первичному файлу настроек Lazarus, по умолчанию он C:\Users\<ИМЯПОЛЬЗОВАТЕЛЯ>\AppData\Local\lazarus

Если имя пользователя у вас на кириллице, примите мои поздравления! Требуются дополнительные действия, пользователи с нормальными именами спокойно переходят к пункту 2.

Кириллица в путях не поддерживается утилитой make, или я с этим не разобрался. Придется "перенастроить" Lazarus чтоб настройки хранились по 'нормальным' путям. Для этого в папке C:\lazarus создаем файл runlazarus.bat следующего содержания:

startlazarus.exe --pcp=C:\lazarus\mylazcfg

и далее всегда используем его для запуска Lazarus IDE, все что написано ниже вам следует отредактировать из расчета что путь к настройкам Lazarus будет C:\lazarus\mylazcfg

5.1.2. Получение ZCAD

Клонируем исходники зкада (или скачиваем архивом, но это плохо, лучше клонировать git ом). Некоторые части исходников оформлены субмодулями git , поэтому:

субмодули git используемые ZCAD нужно инициализировать и обновить.

По описаным выше причинам путь до папки zcad не должен содержать нелатинские символы Тут будет много файлов\папок, но основные:

  • zcad\cad_source - папка с исходниками зкад

  • zcad\environment - папка с файлами окружения программы и исходник небольшой програмки typeexporter настраивающей исходники зкад для компиляции

  • zcad\Makefile - файл с скриптами установки

  • zcad\cad - данной папки изначально нет, будет создана в пункте 4 и содержит скомпилированный дистрибутив zcad со всеми нужными файлами

5.1.3. Установка пакетов от которых зависит ZCAD

Для облегчения я приложил пакеты от которых зависит ZCAD в дистрибутив исходников (за исключением идущих в составе Lazarus). Открываем командную строку в папке zcad, там где лежит файл Makefile

Нужно установить в Lazarus пакеты требуемые для компиляции ZCAD, данный пункт выполняется только один раз, для свеже установленного Lazarus, если пакеты установлены, пропускаем данный пункт (но если что, то повторное выполнение ничего страшного не несет). Выполняем:

C:\lazarus\fpc\3.2.2\bin\i386-win32\make installpkgstolaz LP=C:\lazarus PCP=C:\Users\<ИМЯПОЛЬЗОВАТЕЛЯ>\AppData\Local\lazarus

installpkgstolaz это пропишет в конфигах Lazarus требуемые пакеты из zcad\cad_source\other и zcad\cad_source\components и пересоберет Lazarus. По неясным причинам пересборка в данном пункте иногда завершается ошибкой, но ничего страшного, просто идем дальше, Lazarus докомпилирует все нужное в 4.

5.1.4. Компиляция ZCAD

Собственно запускаем компиляцию зкад, запустив следующее:

[.shell]C:\lazarus\fpc\3.2.2\bin\i386-win32\make cleanzcadelectrotech LP=C:\lazarus PCP=C:\Users\<ИМЯПОЛЬЗОВАТЕЛЯ>\AppData\Local\lazarus#

cleanzcadelectrotech - данная цель выполнит сборку программы в режиме ZCADELECTROTECH, замените на cleanzcad - если желаете режим ZCAD

Скрипт выполнит следующее:

  • СОТРЕТ папки zcad\cad и zcad\cad_source\autogenerated если они присутствует СО ВСЕМ ИХ СОДЕРЖИМЫМ ничего не спрашивая

  • создаст папки zcad\cad и zcad\cad_source\autogenerated

  • скопирует нужные для работы файлы из zcad\environment\runtimefiles в zcad\cad

  • создаст файл zcad\cad_source\zcadversion.inc

  • создаст файл zcad\cad_source\autogenerated\buildmode.inc

  • скомпилирует zcad\cad_source\cad_source\utils\typeexporter.lpi и запустит его с нужными параметрами, typeexporter в свою очередь наполнит zcad\cad_source\autogenerated в том числе создаст zcad\cad_source\autogenerated\allgeneratedfiles.inc (только после этого шага зкад может быть собран)

  • скомпилирует ZCAD

Если все прошло нормально, имеем наполненную как надо папку zcad\cad, в том числе свежесозданный запускаемый бинарник zcad\cad\bin\i386-win32\zcad.exe В дальнейшем можно просто открыть в Lazarus файл zcad\cad_source\zcad.lpi и смотреть-собирать исходники как обычно в IDE

Lazarus, FPC и ZCAD развивающиеся проекты, информация устаревает и бывают нюансы. В частности на данный момент из-за бага FPC https://gitlab.com/freepascal.org/fpc/source/-/issues/39387 в IDE работает только полная пересборка зкада, т.е. в Lazarus если просто нажать F9 зкад не соберется с вылетом компилятора, при любых изменениях надо всегда выполнять полную пересборку shift-F9

5.2. Локализация программы

Для локализации ZCAD используется система интернационализации на основе Gettext и *.po файлов встроенная в Lazarus. Локализации подлежат как тексты прописанные в исходниках программы, так и заданные в файлах загружаемых во время работы программы - например файл zcad\menu\menuscontent.xml содержит наполнение палитр программы, его содержимое неизвестно в момент компиляции программы, он будет прочитан только при запуске. Обычный подход предпологает разные копии загружаемых в рантайм файлов для каждой локализаации. Но в ZCAD принят несколько другой подход - перевод содержимого данных файлов в момент их загрузки.

Прежде всего стоит заметить, как описано в (Структура директорий) файлы локализаций используемые программой лежат в папке cad/languages, данная папка создается в процессе (Cборка программы из исходников) в нее копируются файлы из соответствующих мест environment. Поэтому работа с локализацией осуществляется в cad/languages, но для коммита файлы нужно скопировать в папку environment.

Тексты прописанные в исходниках программы и оформленные как resourcestring при компиляции программы автоматически собираются в файле zcad.po и разносятся по файлам локализаций zcad.XX.po где XX - идентификатор языка. Файлы zcad.XX.po можно непоследственно переводить используя предназначенные для этого программы например Poedit и подобные. На данный момент ZCAD имеет только русскую локализацию zcad.ru.po. добавить локализацию можно просто создав соответствующий файл, например zcad.de.po для немецкой.

Также в cad/languages лежат файлы перевода пакетов используемых в ZCAD:

  • anchordockstr.XX.po перевод пакета докинга окон AnchorDocking

  • lclstrconsts.XX.po перевод LCL

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

Запускаем программу с ключем командной строки (Переключатели коммандной строки) updatepo. При этом локализация программы не будет выполняться, будет работать оригинальный английский интерфейс. Создаем новый чертеж и вводим команду UpdatePO (UpdatePO) будет показано окно с информацией сколько обнаружено неактуальных строк и сколько добавлено новых. При нажатии Ok будет перезаписан файл rtzcad.po, неактуальные строки будут удалены, новые добавлены.

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

C:\lazarus\fpc\3.2.2\bin\i386-win32\make updatelocalizedpofiles LP=C:\lazarus PCP=C:\Users\<ИМЯПОЛЬЗОВАТЕЛЯ>\AppData\Local\lazarus

Образование путей смотри (Cборка программы из исходников), сценарий updatelocalizedpofiles выполняет обновление файлов локализации.

После этого файлы rtzcad.XX.po можно переводить в специализированной программме