Руководство пользователя

Авторские права на данный документ © 2015 принадлежит его разработчикам (соавторам), перечисленным ниже. Вы можете распространять и/или изменять его в соответствии с правилами лицензии GNU General Public License (http://www.gnu.org/licenses/gpl.html), версии 3 или более поздней, или лицензии типа Creative Commons Attribution License (http://creativecommons.org/licenses/by/3.0/), версии 3.0 или более поздней.

Соавторы

Jean-Pierre Charras.

Перевод

KiCad Russian Team + alex9, 2016.

Обратная связь

Просьба оставлять все комментарии и замечания на следующих ресурсах:

Дата публикации

31 мая 2016 года.

Знакомство c Pl_Editor

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

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

Основными элементами макета страницы являются:

  • Line (линии)

  • Rectangle (прямоугольники)

  • Text (надписи) – текст с форматными символами, которые в Eeschema или Pcbnew будут заменены актуальными значениями, такими как даты, номера страницы и т.п.).

  • Poly (полигоны; в основном – для размещения логотипов и специальных графических фигур)

  • Bitmap (растровые изображения)

Растровые изображения могут быть начерчены только в некоторых форматах (только в PDF и PS). Таким образом, для других форматов будет начерчен только ограничивающий прямоугольник.
  • Все элементы могут повторяться, а текст и полигон могут быть повернуты.

Файлы Pl_Editor

Входной файл и макет страницы по умолчанию

Pl_Editor открывает или сохраняет файлы описания макета страницы *.kicad_wks (рабочий лист KiCad).

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

Выходной файл

Описание текущего макета страницы можно записать в файл *.kicad_wks, используя формат S-выражений, широко применяемый в KiCad.

Этот файл может быть использован для отображения пользовательского макета страницы в Eeschema и/или Pcbnew.

Основные понятия

Основные свойства элементы макета страницы:

Основными элементами макета страницы являются:

  • Line (линии)

  • Rectangle (прямоугольники)

  • Text (надписи) – текст с форматными символами, которые в Eeschema или Pcbnew будут заменены актуальными значениями, такими как даты, номера страницы и т.п.).

  • Poly (полигоны; в основном – для размещения логотипов и специальных графических фигур). Эти полигоны создаются Bitmap2component и не могут быть построены в Pl_Editor, потому что не представляется возможным создавать такие фигуры вручную.

  • Bitmap (растровые изображения) – для размещения логотипов.

Растровые изображения могут быть начерчены только в некоторых форматах – PDF и PS.

При этом:

  • Text (надписи), Poly (полигоны) и Bitmap (растровые изображения) характеризуются позицией и могут быть повёрнуты.

  • Line (линии, а на самом деле – отрезки) and Rectangle (прямоугольники) определяются двумя точками: начальной и конечной. Они не могут быть повернуты (для отрезков это бесполезно).

Эти основные элементы могут быть повторены.

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

Определение координат

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

Эта функция гарантирует создание макета страницы, который не зависит от размера бумаги.

Базовые углы и координаты.

page property 1

  • Когда меняется размер страницы, положение элемента относительно его базового угла не меняется.

  • Обычно основные надписи привязаны к правом нижнем углу, поэтому при создании элемента по умолчанию задаётся именно этот угол.

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

Поворот

Элементы, позиция которых определяется только одной точкой (надпись и полигон), могут быть повёрнуты:

Нормально: Поворот = 0

text noriented

Повёрнуто: Поворот = 20 и 10 градусов

text rotated

Повтор

Элементы могут быть повторены.

Это полезно для создания сетки и меток.

page property 2

Надписи и форматные символы

Форматные символы:

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

Форматные символы в Eeschema или Pcbnew заменяются фактическими значениями.

Они похожи на символы форматирования в функции printf.

Форматный символ состоит из % и следующей за ним одной буквы.

Символ %C дополнительно содержит одну цифру (идентификатор комментария).

Форматные символы:

%% = заменяется на %

%K = версия KiCad

%Z = обозначение формата листа (A4, USLetter …​)

%Y = наименование организации

%D = дата создания

%R = номер изменения

%S = номер листа

%N = количество листов

%Cx = комментарий (x = 0 до 3 для идентификации комментария):

%C0 – обозначение и код документа

%C1 – фамилия разработчика

%C2 – фамилия проверившего

%C3 – фамилия утвердившего

%F = имя файла

%P = положение листа в иерархии схемы в Eeschema

%T = наименование изделия (и документа)

Например:

"Лист: %Z" будет выведен как "Лист: A4" или "Лист: USLetter"

Пользовательский режим отображения: активирован pagelayout normal view mode. Основная надпись отображается как в Eeschema и Pcbnew.

show fields data

Основной режим отображения: активирован pagelayout special view mode. Оригинальные надписи, введённые в Pl_Editor, отображаются вместе с форматными символами.

show fields codes

Многострочные надписи:

Надписи могут содержать несколько строк.

Есть два способа, чтобы вставить новую строку в надпись:

  1. Вставьте двухсимвольную последовательность "\n" (главным образом в диалоговом окне "Настройка страницы").

  2. Вставьте новую строку при редактировании текста в свойствах надписи.

Вот пример второго способа:

Настройка

options multi line

Вывод

multi line

Многострочные надписи в диалоговом окне "Настройка страницы"

В диалоговом окне "Настройка страницы" текстовые элементы управления не допускают текст из нескольких строк.

Для принудительного добавления в текст новой строки надо вставить двухсимвольную последовательность "\n".

Двухстрочный текст в поле Наименование:

insert newline code

Результат:

multi line 2

Тем не менее, если действительно требуется отобразить "\n" в надписи, то необходимо вставить "\\n"

insert slashnewline code

и получите:

multi line 3

Ограничения

Ограничение первого листа

При использовании Eeschema вся схема часто размещается более чем на одной странице.

Как правило элементы макета страницы отображаются на всех листах.

Но если пользователь хочет, чтобы некоторые элементы отображались только на первом листе или только на остальных, то это возможно путем выбора "Опции первого листа":

display options

Опция первого листа:

  • Отсутствует.

  • Только на первом листе: элемент виден только на первом листе.

  • Не на первом листе: элемент виден на всех листтах кроме первого.

Ограничение размера надписи

constraint options

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

  • максимальный размер по X

  • максимальный размер по Y

которые определяют ограничивающую рамку.

Когда эти параметры не равны нулю и полный размер надписи больше, чем максимальный размер по X и/или Y, то при отображении фактические высота и ширина символов динамически изменяются так, чтобы полный размер надписи соответствовал этой ограничительной рамке.

Когда фактический полный размер надписи меньше, чем максимальный размер по X и/или Y, то высота и/или ширина символов не изменяются.

Надпись без ограничительной рамки. Максимальный размер по X = 0,0. Максимальный размер по Y = 0,0.

constraints none

Та же надпись с ограничением. Максимальный размер по X = 40,0. Максимальный размер по Y = 0,0.

constraints defined

Многострочная надпись с ограничением: {картинки не коррелируются}

Настройка

constraint options

Вывод

block constraints

Вызов Pl_Editor

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

Синтаксис коммандной строки: pl_editor <*.kicad_wks file to open>

Комманды Pl_Editor

Главное окно

Главное окно Pl_Editor.

main window

Левая панель содержит список элементов.

На правой панели находится редактор настроек для выбранного элемента.

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

main toolbar

Верхняя панель инструментов обеспечивает легкий доступ к следующим командам:

pagelayout new

Select the net list file to be processed.

pagelayout load

Load a page layout description file.

save

Save the current page layout description in a .kicad_wks file.

sheetset

Display the page size selector and the title block user data editor.

print button

Prints the current page.

delete

Delete the currently selected item.

undo redo

Undo/redo tools.

zoom in zoom out zoom redraw zoom fit in page

Zoom in, out, redraw and auto, respectively.

pagelayout normal view mode

Show the page layout in user mode: texts are shown like in Eeschema or Pcbnew: text format symbols are replaced by the user texts.

pagelayout special view mode

Show the page layout in native mode: texts are displayed "as is", with the contained formats, without any replacement.

set base corner

Reference corner selection, for coordinates displayed to the status bar.

set current page

Selection of the page number (page & or other pages).

This selection has meaning only if some items than have a page option, are not shown on all pages (in a schematic for instance, which contains more than one page).

Команды рабочей области

Клавиатурные команды

F1

Увеличить масштаб

F2

Уменьшить масштаб

F3

Перерисовать экран

F4

Переместить курсор в центр окна отображения

Home

Автоматически масштабировать

Space Bar

Установить начало относительных координат в позицию курсора

Right Arrow

Переместить курсор вправо на одну позицию сетки

Left Arrow

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

Up Arrow

Переместить курсор вверх на одну позицию сетки

Down Arrow

Переместить курсор вниз на одну позицию сетки

Ctrl+Z

Отменить действие

Ctrl+Y

Повторить действие

Return

Соответствует щелчку левой кнопкой мыши

End

Соответствует двойному щелчку левой кнопкой мыши

M

Переместить элемент

S

Переместить начальную точку элемента (позицию)

E

Переместить конечную точку элемента

P

Разместить элемент

Del

Удалить элемент

Команды мыши

Scroll Wheel

Увеличение и уменьшение масштаба в текущей позиции курсора

Ctrl + Scroll Wheel

Панорамирование вправо и влево

Shift + Scroll Wheel

Панорамирование вверх и вниз

Right Button Click

Открытие контекстного меню

Контекстное меню

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

  • Добавить линию

  • Добавить прямоугольник

  • Добавить надпись

  • Добавить файл описания макета страницы

(Эти команды – для добавления базовых элементов в текущее описание макета страницы.)

  • Выбор масштаба: непосредственный выбор масштаба отображения.

  • Выбор сетки: непосредственный выбор сетки.

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

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

Строка состояния

Строка состояния находится в нижней части Pl_Editor и предоставляет полезную информацию пользователю.

pl status bar

Координаты всегда отображаются относительно угла, выбраного в качестве базового.

Левая панель

Левая панель содержит список элементов.

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

Это меню содержит основные операции: добавить новый элемент или удалить выбранный.

→ Также у выбранного элемента изменяется цвет.

Список элементов: элемент text2 выбран и выделен на рабочей области.

project tree

Правая панель

Правая панель – редактор настроек элемента.

property none

property main

В этом диалоге можно установить свойства страницы и свойства текущего элемента.

Отображаемые настройки зависят от выбранного элемента:

Settings for lines and rectangles

Settings for texts

property line

property text

Settings for poly-polygons

Setting for bitmaps

property polyline

property bitmap

Интерактивное редактирование

Выбор элемента

Элемент может быть выбран:

  • из списка элементов.

  • щелчком на нём левой кнопкой мыши.

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

Выбранный элемент окрашивается в жёлтый цвет (при выбранном тёмном фоне; если фон – светлый, то цвет выбранного элемента – серо-голубой).

edit line

Подсвеченные начальная (edit line start) и конечеая (edit line end) точки.

Щелчок на элементе правой кнопкой мыши вызывает всплывающее меню.

Варианты всплывающего меню немного зависят от сделанного выбора:

context line move start

context line move end

context line move

Если найден более чем один элемент, то для выбора элемента появится уточняющее меню:

dialog select element

drag element

Выбранный элемент (или одну из его конечных точек) можно переместить движением мыши и завершить действие, щелкнув её правой кнопкой.

Создание элемента

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

Появится всплывающее меню:

Всплывающее меню на левой панели

context createnew

Всплывающее меню на рабочей области

context createnew2

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

Логотип сначала должен быть подготовлен с помощью Bitmap2component, который создаёт файл описания макета страницы.

Пункт Добавить файл описания макета страницы позволяет выбрать этот файл для вставки логотипа (полигона).

Добавление линий, прямоугольников и надписей

При выборе одного из этих пунктов открывается диалоговое окно:

Добавление линии или прямоугольника

dialog newline

Добавление надписи

dialog newtext

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

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

В большинстве случаев базовый угол одинаков для обеих точек.

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

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

Добавление логотипов

Чтобы добавить логотип, полигон (векторизованное изображение логотипа) должен быть сначала создан с помощью Bitmap2component.

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

В этом файле содержится только один элемент – полигон.

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

После того, как полигон вставлен, он может быть перемещен, а его параметры – отредактированы.

Добавление растровых изображений

Для добавления растрового изображения можно использовать большинство растровых форматов (PNG, JPG, BMP …​).

  • После импорта растрового изображения его разрешение – 300 PPI (пикселей на дюйм).

  • Это значение может быть изменено в свойствах элемента (правая панель).

  • От этого параметра зависит фактический размер.

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

Растровое изображение может быть повторено, но не повёрнуто.