3D 查看器 3D 查看器显示了电路板和电路板上的元件的 3D 视图。你可以从不同的角度查看电路板，显示或隐藏不同类型的元 件，从 PCB 编辑器到 3D 查看器的交叉探测，以及生成电路板的光线跟踪渲染图。 53 NOTE The 3D model for a component will only appear if the 3D model file exists and has been → 实时渲染器 → 选择颜色 中调整。 Space Ctrl Shift 54 用 3D 查看器生成图像 当前的 3D 视图可以用 文件 → 将当前视图导出为 PNG… 或 将当前视图导出为 JPG… ，根据所需的图像格式，将其保 存为一个图像。也可以用 按钮，或 编辑 → 复制 3D 图像 将当前视图复制到剪贴板上。 3D 查看器有一个光线跟踪渲染模式，它使用比默认渲染模式更精确的物理渲染模型来显示电路板。 确的物理渲染模型来显示电路板。 光线追踪比默认 渲染模式慢，但当需要最吸引人的视觉效果时，可以使用它。使用 按钮，或者使用 偏好设置→光线追踪 来启用 光线追踪模式。在光线追踪模式下，3D 网格和选择高光不会显示。 颜色和其他渲染选项，包括光线跟踪和非光线跟踪模式，都可以在 偏好设置 → 偏好设置… → 3D查看器 中调整。 3D 查看器控制 许多查看选项是通过顶部的工具栏控制的。

程序之间共享。KiCad 手册中“通用偏好 设置”部分详细介绍了这些部分。请注意，尽管快捷键部分在所有程序之间共享，但有许多特定于 Pcbnew 的快捷键 只有在 Pcbnew 运行时才会出现在列表中。 显示选项 渲染引擎： 控制是否使用硬件加速图形或软件加速图形。 网格样式： 控制如何绘制路线网格。 网格厚度： 控制网格线或网格点的粗细。 最小网格间距： 控制两条网格线之间的最小距离 (以像素为单位)。无 NOTE TODO：编写本部分 (如何安装新的操作插件) 封装向导 封装向导是可以从封装编辑器访问的 Python 脚本的集合。 如果调用封装对话框，则选择一个给定的向导，该向导允 许您查看渲染的封装，并且您可以编辑一些参数。 如 果 插 件 未 正 确 分 发 到 您 的 系 统 软 件 包 ， 您 可 以 在 KiCad 源 代 码 树 中 的 链 接 中 找 到 最 新 版 本 ： actions in the Hotkeys section of the preferences. 操作 默认快捷键 说明 添加基板 在电路板下面添加一块基板 (慢) 抗锯齿 在最终渲染中以最高质量渲染 (慢) 切换表贴(SMD) 3D 模型 切换“表贴”属性的 3D 模型 切换直插 3D 模型 切换“直插”属性的 3D 模型 切换虚拟 3D 模型 切换“虚拟”属性的 3D 模型 翻转电路板

当 PCB 编辑器和 3D 查看器同时打开时，在 PCB 编辑器中选择一个封装也会在 3D 查看器中高亮显示该元件。高亮显 示的颜色可以在 偏好设置 → 偏好设置… → 3D 查看器 → 实时渲染器 → 选择颜色 中调整。 Appearance manager The appearance manager is a panel at the right of the viewer which 图像 将当前视图复制到剪贴板上。 3D 查看器有一个光线跟踪渲染模式，它使用比默认渲染模式更精确的物理渲染模型来显示电路板。 光线追踪比默认 渲染模式慢，但当需要最吸引人的视觉效果时，可以使用它。使用 按钮，或者使用 偏好设置→光线追踪 来启用 光线追踪模式。在光线追踪模式下，3D 网格和选择高亮不会显示。 颜色和其他渲染选项，包括光线跟踪和非光线跟踪模式，都可以在 偏好设置 → 偏好设置… 的小版本之间是独立的，以允许多个版本的偏好设置分别运行。 偏好设置对话框的第一部分（通用、鼠标和触摸板以及快捷键）是所有 KiCad 程序共享的。这些部分在 KiCad 手册 中的 "常规偏好设置" 部分有详细描述。 显示选项 渲染引擎： 控制是否使用硬件加速图形或备用图形加速。 网格样式： 控制对齐网格的绘制方式。 网格粗细： 控制网格线或网格点的粗细。 最小网格间距： 控制两条网格线之间的最小距离 (以像素为单位)。无论当前的网格设置如何，如果网格线

valid values are 0 to GetNFilters() - 1 */ char const* GetFileFilter( int aIndex ); /* 如果插件可以渲染这种类型的 3D 模型，则返回 true。 在某些情况下，插件可能尚未提供可视模型。 并且必须返回 false。 Return true if the plugin can render char const* aFileName ) { // 此伪插件不支持渲染任何模型 // this dummy plugin does not support rendering of any models return NULL; } 此源文件满足实现 3D 插件的所有最低要求。 该插件不会为渲染模型生成任何 数据，但它可以为 KiCad 提供支持的模型文件扩展名和文件扩展名过滤器列 如果要加载插件，必须将插件文件复制到 KiCad 的 插件目录。 2.2. 高级 3D 插件 本教程将引导用户开发名为 “PLUGIN_3D_DEMO2” 的 3D 插件。 本教程的目 的是演示 KiCad 预览器可以渲染的非常基本的场景图的构造。 该插件声称处 理 ‘txt’ 类型的文件。 虽然文件必须存在，以便缓存管理器调用插件，但此插 件不处理文件内容; 相反，插件只是创建一个包含一对四面体的场景图。 本教 程假定第一个教程已完成，并且已创建

由于必要的控制程度，强烈建议使用带有 pcbnew 的3键鼠标。 平移和缩放等 许多功能都需要3键鼠标。 在 KiCad 的新版本中，pcbnew 已经从 CERN 的开发人员那里看到了广泛的变 化。 这包括诸如新渲染器（OpenGL 和 Cairo 视图模式），交互式推送布线 器，差分和曲折布线和调整，重新设计的封装编辑器以及许多其他功能等功 能。 请注意，大多数这些新功能 仅 存在于新的 OpenGL 和 Cairo ”(计划)”：允许您编写插件以导出/导入其他文件类型 行动 “(实验性)”：将事件与脚本操作相关联或注册新菜单或工具栏图 标。 命令行脚本 ：可以从命令行，加载板或库中使用的脚本，修改它们，以及 渲染输出或新板。 需要注意的是，唯一支持脚本编写的 KiCad 应用程序是 Pcbnew。 未来还计划 为 Eeschema。 15.1. KiCad 对象 脚本 API 反映了 KiCad/pcbnew pcb.Save("mod_"+filename) 15.7. 封装向导 封装向导是可以从封装编辑器访问的 Python 脚本的集合。 如果调用封装对话 框，则选择一个给定的向导，该向导允许您查看渲染的封装，并且您可以编辑 一些参数。 如果插件未正确分发到您的系统软件包，您可以在 KiCad 源代码树中的链接中 找到最新版本：gitlab。 它们应位于例如“C:\Program Files\

由于必要的控制程度，强烈建议使用带有 pcbnew 的 3 键鼠标。平移和缩放等许多功能都需要 3 键鼠标。 在 KiCad 的新版本中，pcbnew 已经从 CERN 的开发人员那里看到了广泛的变化。这包括诸如新渲染器（OpenGL 和 Cairo 视图模式），交互式推送布线器，差分和曲折布线和调整，重新设计的封装编辑器以及许多其他功能等功能。 请注意，大多数这些新功能 仅存在于新的 OpenGL 和 Cairo ”(计划)”：允许您编写插件以导出/导入其他文件类型 – 行动“(实验性)”：将事件与脚本操作相关联或注册新菜单或工具栏图标。 • 命令行脚本：可以从命令行，加载板或库中使用的脚本，修改它们，以及渲染输出或新板。 需要注意的是，唯一支持脚本编写的 KiCad 应用程序是 Pcbnew。未来还计划为 Eeschema。 15.1 KiCad 对象 脚本 API 反映了 KiCad/pcbnew pcb.Save("mod_"+filename) 15.7 封装向导 封装向导是可以从封装编辑器访问的 Python 脚本的集合。如果调用封装对话框，则选择一个给定的向导，该向导允 许您查看渲染的封装，并且您可以编辑一些参数。 如果插件未正确分发到您的系统软件包，您可以在 KiCad 源代码树中的链接中找到最新版本：gitlab。 它们应位于例如“C:\Program Files\Ki

查看器 打开 3D 查看器。用鼠标中键拖动进行平 移，用鼠标左键拖动进行绕行。绕着 PCB 板运行，可以看到顶部的 LED 和电阻，以及底部的电池座。 有一种光线追踪模式，它比较慢，但能提供更精确的渲染。用 偏好设置 → 光线追踪 切换到光线追踪模式。 B 33 KiCad 库中的许多封装都带有 3D 模型，包括本指南中使用的所有封装。有些封装没有附带 3D 模型，《封装和 3D 模 型，但用户可以添加自己的模型》。 标签中设置。 48 支持 STEP（ .step ）和 VRML（ .wrl ）两种 3D 模型格式。STEP 文件在需要尺寸精度的情况下非常有用，而 VRML 文件可以用来制作更具视觉吸引力的渲染图。KiCad 库中的许多封装都有相关的 3D 模型；这些模型都以 VRML 和 STEP 格式提供。 两种模型中只有一种需要在封装中列出（通常是给出 VRML 文件名）。在为机械 CAD 目 的导出电路板的

查看器 打开 3D 查看器。用鼠标中键拖动进行平 移，用鼠标左键拖动进行绕行。绕着 PCB 板运行，可以看到顶部的 LED 和电阻，以及底部的电池座。 有一种光线追踪模式，它比较慢，但能提供更精确的渲染。用 偏好设置 → 光线追踪 切换到光线追踪模式。 B 34 KiCad 库中的许多封装都带有 3D 模型，包括本指南中使用的所有封装。有些封装没有附带 3D 模型，《封装和 3D 模 型，但用户可以添加自己的模型》。 模型 标签中设置。 支持 STEP（ .step ）和 VRML（ .wrl ）两种 3D 模型格式。STEP 文件在需要尺寸精度的情况下非常有用，而 VRML 文件可以用来制作更具视觉吸引力的渲染图。KiCad 库中的许多封装都有相关的 3D 模型；这些模型都以 VRML 和 STEP 格式提供。 两种模型中只有一种需要在封装中列出（通常是给出 VRML 文件名）。在为机械 CAD 目 的导出电路板的

dummy plugin does not support rendering of any models return NULL; } 此源文件满足实现 3D 插件的所有最低要求。该插件不会为渲染模型生成任何数据，但它可以为 KiCad 提供支持的模 型文件扩展名和文件扩展名过滤器列表，以增强 3D 模型文件选择对话框。在 KiCad 中，扩展字符串用于选择可用于 加载指定模型的插件; 例如，如果插件是‘wrl’，那么 如果要加载插件，必须将插件文件复制到 KiCad 的插件目录。 2.2 高级 3D 插件 本教程将引导用户开发名为“PLUGIN_3D_DEMO2”的 3D 插件。本教程的目的是演示 KiCad 预览器可以渲染的 非常基本的场景图的构造。该插件声称处理‘txt’类型的文件。虽然文件必须存在，以便缓存管理器调用插件，但此 插件不处理文件内容; 相反，插件只是创建一个包含一对四面体的场景图。本教程假定第一个教程已完成，并且已创

org/help/report-an-issue/ 发布日期 2021-05-09 2 欢迎 KiCad 是一个免费和开源的电子设计自动化（EDA）套件。它具有原理图捕获、集成电路模拟、印刷电路板（PCB） 布局、3D 渲染和绘图/数据导出等多种格式。KiCad 还包括一个高质量的元件库，其中有成千上万的符号、封装和 3D 模型。KiCad 对系统要求最低，可在 Linux、Windows 和 macOS 上运行。