参考手册

本文档由以下列出的贡献者版权所有（C）2015。 您可以根据 GNU 通用公共许可证（http://www.gnu.org/licenses/gpl.html），版本3或更高版本或知识共享署名许可的条款进行分发和/或修改。 (http://creativecommons.org/licenses/by/3.0/) ，3.0或更高版本。

Contributors

Jean-Pierre Charras.

翻译

taotieren <admin@taotieren.com>, 2019

Telegram 简体中文交流群: https://t.me/KiCad_zh_CN

反馈

请将任何错误报告、建议或新版本引导到此处:

出版日期和软件版本

2015 年 5 月 23 日。

Pl_Editor 简介

Pl_Editor 是一个图框编辑器工具，用于创建自定义标题块和框架引用。

与框架引用和其他图形项（LOGO）关联的标题栏在此称为图框。

基本图框项目是：

  • 线

  • 矩形

  • 文本 （带格式符号，将被实际文本替换， 比如 Eeschema 或 Pcbnew 中的日期，页码…​）。

  • 多边形 （主要用于放置 LOGO 和特殊图形形状）

  • 位图 。

位图只能由少量绘图仪绘制（仅限 PDF 和 PS）因此，对于其他绘图仪，仅绘制边界框。

  • 可以重复项目，可以旋转文本和多边形。

Pl_Editor 文件

输入文件和默认标题栏

Pl_Editor 读取或写入图框描述文件 *.kicad_wks（KiCad 工作表）。

在读取文件之前，将使用内部默认图框描述来显示默认的 KiCad 标题块。

输出文件

当前图框描述可以使用 S-expression 格式写入 *.kicad_wks 文件，该格式在 KiCad 中广泛使用。

此文件可用于在 Eeschema 和/或 Pcbnew 中显示自定义图框。

运作理论

基本图框项属性：

基本图框项目是：

  • 线

  • 矩形

  • 文本 （带格式符号，将由实际替换 文字，如 Eeschema 或 Pcbnew 中的日期，页码…​）。

  • 多边形 （主要用于放置 LOGO 和特殊图形形状）。 这些多边形由 Bitmap2component 创建，但不能 内置 pl_editor，因为无法创建这样的形状 用手。

  • 位图 用于放置 LOGO。

位图只能由少量绘图仪绘制：仅限 PDF 和 PS。

因此：

  • 文本，多边形 和 位图 由位置定义，和 可以旋转。

  • 线 （实际上是段）和 矩形 由两点定义： 起点和终点。 它们不能旋转（这是没用的 对于线）。

这些基本项目可以重复。

重复的文本也接受标签的增量值（仅在文本是一个字母或一个数字时才有意义）。

坐标定义

项目的每个位置，起点和终点始终相对于页面角落。

此功能可确保您可以定义不是的图框 取决于纸张尺寸 。

参考角和坐标：

page property 1

  • 更改页面大小时，项目相对于其参考角的位置不会更改。

  • 通常，标题栏附加到右下角，因此在创建项目时，此角是默认角。

对于具有两个定义点的矩形和线段，每个点都有其参考角。

旋转

可以旋转具有仅由一个点（文本和多边形）定义的位置的项目：

正常：旋转 = 0

text noriented

旋转：旋转 = 20 和 10 度。

text rotated

重复选项

项目可以重复：

这对于创建网格和网格标签很有用。

page property 2

文字和格式

格式符号：

文本可以是简单的字符串，也可以包含格式符号。

格式符号由 Eeschema 或 Pcbnew 中的实际值替换。

它们就像 printf 函数中的格式符号。

格式符号是 % 后跟 1 个字母。

%C 格式有一位数（注释标识符）。

格式符号是：

%% = 替换为 %

%K = KiCad 版本

%Z = 纸张格式名称（A4，美国信封 …​

%Y = 公司名称

%D = 日期

%R = 修订版

%S = 表格编号

%N = 张数

%Cx = 注释（x = 0 到 9 以标识注释）

%F = 文件名

%P = 表格路径（表格全名，Eeschema）

%T = 标题

例：

“Size: %Z” 显示“Size: A4” 或“Size: USLetter”

用户显示模式：pagelayout normal view mode 已激活。 标题栏显示在 Eeschema 和 Pcbnew 中

show fields data

“原生”显示模式：pagelayout special view mode 已激活。 在 Pl_Editor 中输入的本机文本及其格式符号。

show fields codes

多行文字：

文本可以是多行的。

有两种方法可以在文本中插入新行：

  1. 插入“\n”2个字符序列（主要在 KiCad 中的页面设置对话框中）。

  2. 在 Pl_Editor 设计窗口中插入一个新行。

这是一个例子：

设置

options multi line

输出

multi line

页面设置对话框中的多行文本：

在页面设置对话框中，文本控件不接受多行文本。

应插入 “\n” 2个字符序列以强制在文本中添加新行。

这是一个两行文本，在 注释 2 字段中：

insert newline code

这是实际的文字：

multi line 2

但是，如果您真的想在文本中使用 “\n” ，请输入 “\\n” 。

insert slashnewline code

并显示的文字：

multi line 3

约束

第 1 页约束

使用 Eeschema 时，完整原理图通常使用多个页面。

通常图框项目显示在所有页面上。

但是，如果用户希望某些项目仅在第1页上显示，或者不在第1页上显示，则可以通过设置此选项来实现“第1页选项”：

display options

第 1 页选项：

  • 无：没有约束。

  • 仅限第 1 页：这些项目仅在第 1 页上可见。

  • 不在第 1 页上：项目在所有页面上都可见，但页面1。

文本全尺寸约束

constraint options

仅对于文本，可以设置 2 个参数：

  • 最大尺寸 X

  • 最大尺寸 Y

它定义了一个边界框。

当这些参数不为 0 时，在显示文本时，如果全文大小大于最大尺寸 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

通常从命令行或 KiCad 管理器调用 Pl_Editor。

从命令行，语法是 pl_editor <*.kicad_wks 文件打开>。

Pl_Editor 命令

主屏幕

下图显示了 Pl_Editor 的主窗口。

main window

左窗格包含基本项目列表。

右侧窗格是项目设置编辑器。

主窗口工具栏

main toolbar

顶部工具栏可以轻松访问以下命令：

new page layout

选择要处理的网络列表文件。

open page layout

加载图框描述文件。

save

将当前图框描述保存在 .kicad_wks 文件中。

sheetset

显示页面大小选择器和标题栏用户数据编辑器。

print button

打印当前页面。

delete

删除当前选定的项目。

undo redo

撤消/重做工具。

zoom in zoom out zoom redraw zoom fit in page

分别放大，缩小，重绘和自动。

pagelayout normal view mode

在用户模式下显示图框：文本显示在 Eeschema 或 Pcbnew 中： 文本格式符号由用户文本替换。

pagelayout special view mode

以纯模式显示图框：文本按“原样”显示，带有 包含格式，无需任何替换。

set base corner

参考角选择，用于显示到状态栏的坐标。

set current page

选择页码（页面和/或其他页面）。

绘图区域中的命令（绘图面板）

键盘命令

F1

放大

F2

缩小

F3

刷新显示

F4

将光标移动到显示窗口的中心

Home

将封装放入显示窗口

空格键

设置当前光标位置的相对坐标

右箭头

将光标向右移动一个网格位置

向左箭头

将光标向左移动一个网格位置

向上箭头

将光标向上移动一个网格位置

向下箭头

将光标向下移动一个网格位置

鼠标命令

滚轮

在当前光标位置放大和缩小

Ctrl +滚轮

左右平移

Shift +滚轮

上下平移

右键单击

打开上下文菜单

上下文菜单

通过右键单击鼠标显示：

  • 添加线

  • 添加矩形

  • 添加文字

  • 附加图框描述文件

是用于将基本布局项添加到当前图框描述的命令。

  • 缩放选择：直接选择显示缩放。

  • 网格选择：直接选择网格。

追加图框描述文件 旨在添加多边形以制作 LOGO。

因为通常需要数百个顶点的 LOGO，所以不能手工创建多边形。 但是您可以附加由 Bitmap2Component 创建的描述文件。

状态栏信息

状态栏位于 Pl_Editor 的底部，为用户提供有用的信息。

pl status bar

坐标 始终相对于角 被选为 参考 。

左窗口

左侧窗口显示布局项列表。

可以选择给定项目（左键单击该行），或者在右键单击该行时，显示弹出菜单。

此菜单允许基本操作：添加新项目或删除所选项目。

→ 选定的项目也会在绘图面板上以不同的颜色绘制 。

设计树：选择项目 19，并在绘图面板上突出显示。

project tree

右窗口

右侧窗口是编辑窗口。

property none

property main

在此对话框中，您可以设置页面属性和当前项目的项目属性。

显示的设置取决于所选项目：

线条和矩形的设置

文本设置

property line

property text

多边形的设置

设置位图

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 创建 LOGO，这将创建图框描述文件。

附加图框描述文件选项附加此文件，以插入 LOGO（多边形）。

添加线条，矩形和文本

单击该选项时，将打开一个对话框：

添加线条或矩形

dialog newline

添加文字

dialog newtext

可以在此处定义端点的位置和拐角参考。

但是，可以在稍后，从右侧窗口或通过移动项目或其中一个端点来定义它们。

大多数时候角点参考对于两个点都是相同的。

如果不是这种情况，则在创建时定义角参考更好，因为如果稍后更改角参考，则项的几何将有点奇怪。

创建项目时，如果是否处于移动模式，您可以优化其位置（这对于文本和小行或矩形非常有用）

添加 LOGO

要添加 LOGO，必须首先使用 Bitmap2component 创建多边形（LOGO 的矢量图像）。

Bitmap2component 使用 * 附加图框描述文件 * 选项创建一个附加到当前设计的图框描述文件。

Bitmap2component 创建一个图框描述文件，其中只包含一个项目：多边形。

但是，此命令可用于附加任何图框描述文件，该文件与当前设计合并。

插入多边形后，可以移动它并编辑其参数。

添加图像位图

您可以使用大多数位图格式（PNG，JPEG，BMP …​）添加图像位图。

  • 导入位图时，其 PPI（每英寸像素数）定义设置为 300PPI。

  • 可以在面板属性（右侧面板）中修改此值。

  • 实际大小取决于此参数。

  • 请注意，使用更高的定义值会带来更大的输出文件，并且可能会有明显的绘制或绘图时间。

可以重复位图，但不能旋转 。