Pcbnew

封装可以与包含元件的三维表示的文件相关联。 要将封装与模型文件相关联，请选择 3D 设置 选项卡，如下所示。

右侧的按钮具有以下功能：

添加3D形状 显示3D文件选择对话框并创建一个 元件的新模型条目。

删除3D形状 删除所选的模型条目。

编辑文件名 显示用于手动输入的文本编辑器 模型文件名。

配置路径 显示一个配置对话框 允许用户编辑路径别名列表和 别名值。

3D 设置 选项卡包含一个面板，其中包含所选模型的预览以及模型的比例，偏移和旋转数据。

缩放值对于可视化格式（如 VRML1，VRML2 和 X3D）非常有用。 由于模型可能由任意数量的 VRML/X3D 编辑器或导出器生成，并且 VRML 不强制模型的长度单位，因此用户可以输入适当的比例值以确保模型在 3D 查看器中显示。 一些用户使用简单的 VRML 框作为元件的通用模型并选择比例值，以便框具有表示组件的正确大小。 对于机械 CAD（MCAD）模型，比例值应保持为1。 MCAD 格式始终指定单位长度，任何使用 MCAD 数据格式的导出器都将忽略缩放值。 但是 3D 查看器将始终应用比例值; 如果除了单位以外的比例值与 MCAD 模型一起使用，则 3D 查看器的输出将与任何导出的 MCAD 模型（如 IDF）不同。

通常需要偏移和旋转值以使 3D 模型与封装对齐。 由于 3D 建模软件的差异以及用户构建模型的方式不同，在绝大多数情况下，用户必须输入偏移和旋转值才能实现 3D 模型的所需定位。 旋转值以度为单位，并以 ZYX 的顺序连续应用; 所使用的惯例是当从轴的正位置朝向原点观察时，正角度导致部件顺时针旋转。

KiCad 通过插件系统支持 3D 模型格式，并为视觉模型格式 VRML1，VRML2 和 X3D 以及 MCAD 格式 IDF 提供支持。 MCAD 格式 IGES 和 STEP 通过 OCE 插件支持，该插件需要合适版本的 OpenCascade 或 OpenCascade Community Edition（OCE）软件。

在过去，KiCad 使用固定路径到 3D 模型目录，后来依靠 KISYS3DMOD 环境变量来指定模型目录的位置。 可以使用其他环境变量指定模型的其他基目录。 当前版本的 KiCad 具有专门的 别名 系统，用于处理 3D 模型名称。 新文件名管理系统（文件名解析系统）的目的是提供一种与早期版本的 KiCad 兼容的方案，同时提供更灵活的机制来指定 3D 模型文件名并提高共享项目文件的能力。

由于需要支持先前的方案，同时提供用于查找 3D 模型的灵活的新方案，因此有两种不同的方法来指定 3D 模型的基本搜索路径。

为了保持 kicad_pcb 和 pretty 数据文件的易读性，KiCad 更喜欢使用通过使用环境变量（旧方法）或别名（新方法）缩短的文件名。由于设置环境变量可能很麻烦，尤其是在基于 GUI 的操作系统上，因此扩展了支持模型搜索路径的环境变量方案，以利用 KiCad 现有的内部定义的 路径配置 对话框。该对话框可通过 首选项 → 配置路径 菜单获得，如下所示。在此对话框中设置其他路径将扩展用于查找 3D 模型文件的搜索路径。该对话框实际上并没有设置环境变量，但文件名解析系统就像它一样;如果定义了具有相同名称的实际环境变量，则环境变量的值将覆盖任何内部定义的值。相对于这些已定义变量的文件名以 $ {MY_ENV_VAR} 开头，其中 MY_ENV_VAR 是通过 路径配置 对话框或实际环境变量定义的变量。

支持缩短文件名的新方案是 别名 系统。 在这个系统中，一个路径以字符串 :my alias开头： 其中 my alias 是一个文本字符串，最好选择为短，同时对用户也很重要; 例如，包含官方 KiCad 模型的目录的别名可能具有别名 官方模型，而您的个人模型集合可能具有别名 My Models 。 可以通过单击前面显示的 3D 设置 选项卡中的 配置路径 按钮来设置别名。 别名配置对话框如下所示。

单击 添加3D形状 可以选择 3D 模型文件以显示如下所示的 3D 模型浏览器。 模型浏览器提供 3D 预览，文件过滤器和下拉路径选择器，其中包含通过环境变量或别名定义的当前搜索路径列表。 根据型号尺寸和复杂程度，选择模型时可能需要几秒钟才能显示模型。 在极端情况下，在测试期间使用的 BGA 封装模型花费大约12秒来显示。