些函数标识插件类，提供特定插件的名称，提供插件类 API 的版本信息，提供 特定插件的版本信息，并提供插件类 API 的基本版本兼容性检查。 简而言 之，这些功能是： /* 返回命名插件类的 UTF-8 字符串 */ /* Return a UTF-8 string naming the Plugin Class */ char const* GetKicadPluginClass( void ); /* Revision ); 用户必须实现的功能如下： /* 返回插件支持的扩展字符串数 */ /* Return the number of extension strings supported by the plugin */ int GetNExtensions( void ); /* 返回请求的扩展字符串；有效值为 0 到 GetNExtensions() - 1 Return “PLUGIN_3D_DEMO1” 的非常基本的 3D 插 件。 本教程的目的只是为了演示一个非常基本的 3D 插件的构造，除了提供一 些允许 KiCad 用户在浏览 3D 模型时过滤文件名的过滤字符串之外什么都不 做。 这里演示的代码是任何 3D 插件的绝对最低要求，可以用作创建更高级插 件的模板。 为了构建演示项目，我们需要以下内容： CMake KiCad 插件头 KiCad 场景图库

该部分之前可以有任意数量的注释行; 导出器将注 释行复制到库文件中，并可用于跟踪元数据，例如对用于确定元件边框和尺寸 的文档的引用。 元件边框部分包含字符串，整数或浮点数字段。 字符串是可包含空格的字符 组合; 如果字符串包含空格，则必须引用它。 引号不得出现在字符串中。 浮点 数可以使用十进制或指数表示法表示，但十进制表示法是人类可读性的首选。 小数点必须是点而不是逗号。 IDF 文件必须只包含7 位 ASCII 记录 1 必须跟随记录 2，记录 2 有四个字段： 1. 几何名称：与零件号组合的字符串必须形成元件边框的唯一标识符。 对于 标准化包，包名称是几何名称的良好值，例如 SOT-23 。 对于独特的包装， 制造商的部件号是几何名称的不错选择。 2. 部件号：虽然显然是用于部件号，例如 BS107，但最好使用此字符串来帮助 描述包。 例如，如果几何名称是 TO-92 ，则部件号条目可用于描述焊盘的 IDF 文件中的注释为用户提供有关边框的更多信息，例如对用于尺寸信息 的源的引用。 4.3. 几何和部件编号条目 仔细考虑要赋予几何和部件编号条目的值。 总之，这些字符串充当 MCAD 系 统的唯一标识符。 理想情况下，字符串的值对用户有一定的意义，但这不是 必需的：这些值主要用于 MCAD 系统用作唯一 ID。 理想情况下，所选择的值 在任何大型边框集中都是唯一的; 选择好的价值将导致更少的冲突，特别是在

控制虚线的长度，而 间隔长度 控制虚线和圆点之间的间距。虚线和 间隔的长度是相对于行宽而言的：间隔长度为 2 意味着是行宽的两倍。 文本替换变量可以在文本变量部分创建。 这些变量允许你将变量名称替换为任何文本字符串。 这种替换发生在变量 名称在 ${VARIABLENAME} 的变量替换语法内的任何地方。 例如，您可以创建一个名为 VERSION 的变量，并将文本替换设置为 1.0 。 现在，在 PCB 分，搜索将匹配。 通配符： 当选择时，通配符可以在搜索词中使用。 ? 匹配任何单个字符， * 匹配任何数量的字符。请注意，当选择 这个选项时，不会返回部分匹配结果：搜索 abc* 将匹配字符串 abcd ，但搜索 abc 则不会。 缠绕： 选择后，搜索结果将在达到最后一次点击后返回到第一次点击。 搜索封装位号： 选择搜索是否应适用于封装位号。 搜索封装值： 选择搜索是否应适用于封装值字段。 DATA0_EXT 的网络，则使用值为 DATA0* 的分组依据将创建一个包含这两个网络的组。 通过将分组依据模式从通配 符更改为 RegEx (正则表达式)，可以创建更复杂的分组。 分组依据模式的子字符串 (Substr) 变体将为以不同方式匹 配该模式的每组网络创建组。 例如，如果您有 U1D+ ， U1D- ， U2D+ 和 U2D- ，分组模式 U*D 将在通配符模式下匹配所有四个网络，创建一个单

部分组成。该部分之前可以有任 意数量的注释行; 导出器将注释行复制到库文件中，并可用于跟踪元数据，例如对用于确定元件边框和尺寸的文档的 引用。 元件边框部分包含字符串，整数或浮点数字段。字符串是可包含空格的字符组合; 如果字符串包含空格，则必须引用 它。引号不得出现在字符串中。浮点数可以使用十进制或指数表示法表示，但十进制表示法是人类可读性的首选。小 IDF 导出器 5 / 11 数点必须是点而不是逗号。IDF 1）。记录 1 必须跟随记录 2，记 录 2 有四个字段： 1. 几何名称：与零件号组合的字符串必须形成元件边框的唯一标识符。对于标准化包，包名称是几何名称的良好 值，例如 SOT-23 。对于独特的包装，制造商的部件号是几何名称的不错选择。 2. 部件号：虽然显然是用于部件号，例如 BS107，但最好使用此字符串来帮助描述包。例如，如果几何名称是 TO-92 ，则部件号条目可用于描述焊盘的布局或该特定 使用 IDF 文件中的注释为用户提供有关边框的更多信息，例如对用于尺寸信息的源的引用。 4.3 几何和部件编号条目 仔细考虑要赋予几何和部件编号条目的值。总之，这些字符串充当 MCAD 系统的唯一标识符。理想情况下，字符串 的值对用户有一定的意义，但这不是必需的：这些值主要用于 MCAD 系统用作唯一 ID。理想情况下，所选择的值在 任何大型边框集中都是唯一的; 选择好的价值将导致更少的冲突，特别是在复杂的板上。

控制虚线的长度，而 间隔长度 控制虚线和圆点之间的间距。虚线和 间隔的长度是相对于行宽而言的：间隔长度为 2 意味着是行宽的两倍。 文本替换变量可以在文本变量部分创建。 这些变量允许你将变量名称替换为任何文本字符串。 这种替换发生在变量 名称在 ${VARIABLENAME} 的变量替换语法内的任何地方。 例如，您可以创建一个名为 VERSION 的变量，并将文本替换设置为 1.0 。 现在，在 PCB 分，搜索将匹配。 通配符： 当选择时，通配符可以在搜索词中使用。 ? 匹配任何单个字符， * 匹配任何数量的字符。请注意，当选择 这个选项时，不会返回部分匹配结果：搜索 abc* 将匹配字符串 abcd ，但搜索 abc 则不会。 Wrap: 选中时，搜索结果将在到达最后一个匹配项后返回到第一个匹配项。 搜索封装位号： 选择搜索是否应适用于封装位号。 搜索封装值： 选择搜索是否应适用于封装值字段。 用户可以移动钻孔/拾放文 件原点和网格原点。 X 轴： 控制 X 坐标向右还是向左增加。 Y 轴： 控制 Y 坐标是向上还是向下增加。 文本变量 KiCad支持文本变量，允许你用定义的文本字符串替换变量名称。 这种替换发生在变量名称在 ${VARIABLENAME} 的 变量替换语法内的任何地方。 你可以在 原理图或 电路板设置 对话框中定义自己的文本变量，但也有一些内置的系统文本变量。系统文本变量可能

、文字大小和文字外观。此外，可以为所有图层配置标注对象 的特性。有关标注属性的更多详细信息，请参阅下面的标注部分。 文本替换变量可以在文本变量部分创建。 这些变量允许你将变量名称替换为任何文本字符串。 这种替换发生在变量 名称在 ${VARIABLENAME} 的变量替换语法内的任何地方。 例如，您可以创建一个名为 VERSION 的变量，并将文本替换设置为 1.0 。 现在，在 PCB DATA0_EXT 的网络，则使用值为 DATA0* 的分组依据将创建一个包含这两个网络的组。 通过将分组依据模式从通配 符更改为 RegEx (正则表达式)，可以创建更复杂的分组。 分组依据模式的子字符串 (Substr) 变体将为以不同方式匹 配该模式的每组网络创建组。 例如，如果您有 U1D+ ， U1D- ， U2D+ 和 U2D- ，分组模式 U*D 将在通配符模式下匹配所有四个网络，创建一个单 于每个 ( 必须有匹配的 ) 。在子 句中，标记和值之间用空格分隔。按照惯例，使用单个空格，但是可以在标记之间使用任意数量的空格字符。在文本 字符串有效的地方，没有任何空格的字符串可以用 " 或 ' 引起来，也可以不加引号。包含空格的字符串必须始终用 引号引起来。在需要嵌套引号的地方，可以使用 " 作为外引号字符，使用 ' 作为内引号字符 (反之亦然)，从而实现 单层嵌套。换行符

表中的每一行都存储了几个描述库的字段： 活动 启用/禁用库。 暂时减少加载的库集很有用。 昵称 昵称是用于将符号分配给元件的简短唯一标识符。符号 由'：'字符串表示。 库路 径 路径指向库位置。 插件 类型 确定库文件格式。 选项 存储库特定选项（如果插件使用）。 说明 简要描述库内容。 3.2.2. 常规选项 显示 网格尺寸 网格大小选择。 您可以通过按 “发布日期” 按左箭头按钮将日期设置 为今天，但不会自动更改。 4.2. 搜索工具 “查找” 图标（ ）可用于访问搜索工具。 您可以在当前工作表或整个层次结构中搜索引用，值或文本字符串。 找到 后，光标将定位在相关子表中的找到元素上。 4.3. 网表工具 网表图标（ ）打开网表生成工具。 该工具创建一个文件，描述整个层次结构中的所有连接。 在多表层次结构中，任何本地标签仅在其所属的工作表内可见。 出，三态，电源端口等）来添加引脚。 如果其他符号具有相同的设计，则添加别名，如果已从其他符号创建符 号，则将其固定或删除。 添加可选字段，例如 PCB 设计软件使用的封装名称和/或定义其可见性。 通过添加描述字符串和数据表链接等来记录符号。 将其保存在所需的库中。 12.3. 符号库编辑器概述 符号库编辑器主窗口如下所示。 它由三个工具栏组成，可快速访问常用功能 和符号查看/编辑区域。 并非所有命令都可在工具栏上使用，但可以使用菜单

词的一部分，搜索将匹配。 通配符: 当选择时，通配符可以在搜索词中使用。 ? 匹配任何单个字符，而 * 则匹配任何数量的字符。请注意，当 选择这个选项时，不会返回部分匹配：搜索 abc* 将匹配字符串 abcd ，但搜索 abc 不会。 搜索引脚名称和编号： 选择搜索是否应适用于引脚名称和编号。 搜索隐藏字段： 选择搜索是否只适用于可见字段，或是否应包括隐藏的符号字段。 只搜索当前原理图： bom_csv_grouped_extra 输出一个 CSV 文件，其中包含设计中的每个元件。元件按值、封装、DNP（不使用） 和命令行中指定的任何额外字段分组。要指定额外的字段，在命令行的末尾添加所需的字段名作为引号字符串。 例如，要包括 MPN 字段，命令行的结尾应该是 <脚本路径>/bom_csv_grouped_extra.py "%I" "O.csv" "MPN" 。BOM 中的列是： 项目编号 位号 出、三态、电源输出等）来添加引脚。 确定该符号是否应从另一个具有相同图形设计和引脚定义的符号中衍生出来。 添加可选的字段，如 PCB 设计软件使用的封装名称和/或定义其可见性。 通过添加描述字符串和数据手册链接来记录该符号，等等。 将其保存在所需的库中。 符号编辑器的主窗口如下所示。它包括三个用于快速访问常用功能的工具条和一个符号查看/编辑区。 不是所有的命 令都可以在工具栏上使用，但所有的命令都可以在菜单中使用。

17 / 151 活动 启用/禁用库。暂时减少加载的库集很有用。 昵称 昵称是用于将符号分配给元件的简短唯一标识符。符号由’：’ 字符串表示。 库路径 路径指向库位置。 插件类型 确定库文件格式。 选项 存储库特定选项（如果插件使用）。 说明 简要描述库内容。 3.2.2 常规选项 3.2.2.1 显示 网格尺寸 网格大小选择。 将日期设置为今天，但不会自动更改。 Eeschema 简介 23 / 151 4.2 搜索工具 “查找”图标（ ）可用于访问搜索工具。 您可以在当前工作表或整个层次结构中搜索引用，值或文本字符串。找到后，光标将定位在相关子表中的找到元素上。 4.3 网表工具 网表图标（ ）打开网表生成工具。 该工具创建一个文件，描述整个层次结构中的所有连接。 在多表层次结构中，任何本地标签仅在其所属的工作表内可见。例如：表 如果其他符号具有相同的设计，则添加别名，如果已从其他符号创建符号，则将其固定或删除。 Eeschema 简介 84 / 151 • 添加可选字段，例如 PCB 设计软件使用的封装名称和/或定义其可见性。 • 通过添加描述字符串和数据表链接等来记录符号。 • 将其保存在所需的库中。 12.3 符号库编辑器概述 符号库编辑器主窗口如下所示。它由三个工具栏组成，可快速访问常用功能和符号查看/编辑区域。并非所有命令都 可在工具栏上使用，但可以使用菜单访问。

面板允许您创建总线别名，这是总线中信号组的名称。 有关总线别名的更多信息，请参阅 [总线-别 名，总线别名文档]。 53 文本变量 文本替换变量可以在文本变量部分创建。 这些变量允许您用变量名替换任何文本字符串。 这种替换发生在变量名称 在 ${VARIABLENAME} 的变量替换语法中使用的任何地方。 例如，您可以创建一个名为 VERSION 的变量并将文本替换设置为“1.0”。 现在，在 PCB 词的一部分，搜索将匹配。 通配符: 当选择时，通配符可以在搜索词中使用。 ? 匹配任何单个字符，而 * 则匹配任何数量的字符。请注意，当 选择这个选项时，不会返回部分匹配：搜索 abc* 将匹配字符串 abcd ，但搜索 abc 不会。 搜索引脚名称和编号： 选择搜索是否应用于引脚名称和编号。 搜索隐藏字段： 选择搜索是否只应用于可见字段，或是否应包含隐藏的符号字段。 Search the bom_csv_grouped_extra 输出一个 CSV 文件，其中包含设计中的每个元件。元件按值、封装、DNP（不使用） 和命令行中指定的任何额外字段分组。要指定额外的字段，在命令行的末尾用引号字符串添加所需的字段名。例 如，要包括 MPN 字段，命令行的结尾应该是 <脚本路径>/bom_csv_grouped_extra.py "%I" "O.csv" "MPN" 。 BOM 中的列是：