Python依赖项 #

NijiGPen的多数功能依赖于第三方的Python软件包，需要在设置面板中手动下载与安装。如果您没有使用过有类似需求的Blender插件，强烈建议首先阅读此页面。

是否需要安装软件包 #

本插件的部分功能不需要Python软件包，包括PSD多图层渲染、笔刷与调色板导入、画布旋转与图形重排。如果您仅需要这些功能，可以跳过此教程。

其它大部分插件功能则需要手动安装软件包，其中PyClipper与SciPy & SkImage是必须的，Triangle是可选的。

安装方法 #

安装操作在插件的设置面板中进行。表格中列出3个Python软件包，单击"Check"按钮可检查它们是否已被安装。在此面板中进行操作时，下方的"Logs"区域会显示一些有用的信息。

如果您已经在Blender中使用了一些插件功能，建议先重启Blender，再进行软件包安装或卸载操作。

默认方法: 安装到Blender目录 #

默认情况下，Package Folder选项为空，此时软件包会被下载到Blender的安装目录，只需点击"Install"按钮即可。由于后台下载和安装需要时间，Blender可能会停止响应一段时间，这是正常的。过后如果软件包的状态变为"OK"，则说明安装成功。

如果没有显示任何错误信息，但状态也没有变为"OK"，请尝试重启Blender后再用"Check"按钮检查，若状态仍未改变，才说明安装未成功。

如果安装失败，有可能是插件没有操作文件的权限，例如Windows系统下，当Blender安装在C:\Program Files文件夹时就会出现这种现象。有两种解决方法：

1. 尝试以管理员权限运行Blender，再进行软件包安装。
2. 使用下一节介绍的自定义目录。

备选方法: 安装到自定义目录 #

另一种方式是新建一个空文件夹，并将其设置在Package Folder选项中。先勾选Install New Packages in Custom Path，再点击Install按钮，就可以将软件包安装到这个自定义的位置。

也可以选择下拉列表中的路径，这是存放当前系统用户的Python软件包的通用目录。

卸载方法 #

如果需要卸载已安装的软件包，请单击"Remove"按钮，过程与安装类似。

如果安装时使用了备选方法，将软件包安装在自定义目录，请手动进入该目录，删除其中所有相关文件。

问题排查 #

本插件追求较高的兼容性，同时支持Windows/macOS/Linux系统以及多种Blender版本。在这种情况下，安装软件包是一个较为复杂的问题，可能会出现预料之外的情况。如果您遇到此教程没有涉及的问题，请至GitHub询问。

在安装软件包时，插件会将安装的全过程显示在下方的日志中。如果安装发生错误，原因可能可以在日志中找到。

如果日志没有显示任何内容，且Blender停止响应，则可能是网络问题。请确认网络保持畅通，必要时可能需要设置VPN。

附录 #