（查看更新日志）
适用于 Blender 2.83+ 及更高版本，包括 5.x
目前支持：Cycles、Eevee 和 Eevee Next

如何安装和使用该插件

安装与更新（Blender 4.2+）：

选项 1：拖拽安装

将 .zip 文件下载到任意位置。（请勿解压该 zip 文件）
将其拖入 Blender 中
请确保勾选“覆盖”和“安装时启用”选项
在 3D viewport 中，按“N”键打开侧边栏
点击 Poliigon Addon 选项卡。

选项 2：通过用户偏好设置安装

将 .zip 文件下载到任意位置。（请勿解压该 zip 文件）
在 Blender 中，导航至 Edit -> Preferences。然后进入 Add-ons 选项卡（不要与“Extensions”混淆）。
点击右上角的下拉菜单，选择 Install from Disk...
从本地计算机中选择该 .zip 文件（小技巧：你可以将 zip 文件拖入浏览弹窗中以获取路径）
确保插件显示在列表中并已启用（如有需要，可搜索“Poliigon”）
在 3D viewport 中，按“N”键打开侧边栏
点击 Poliigon Addon 选项卡

一些 Linux 用户反馈他们需要在系统上执行 pip install certifi，尽管该库通常是预装的。

更新方法：

对于 Blender 4.2 及以上版本，您可以按照与安装相同的流程进行操作。直接拖放文件，并勾选“覆盖”选项。安装完成后，请务必立即重启 Blender。

如果您在重启后更新时仍遇到任何错误，我们建议您彻底卸载该插件（请参阅下一节），重启 Blender，然后按照上述步骤重新安装。

安装与更新（Blender 2.83 - 4.1）：

将 .zip 文件下载到任意位置。（请勿解压该 zip 文件）
在 Blender 中，导航至 Edit -> Preferences。然后进入 Addons 选项卡。
点击安装按钮，找到并安装该 zip 文件。
确保插件已显示在列表中并处于启用状态（如有需要，可搜索“Poliigon”）
在 3D viewport 中，按“N”键打开侧边栏。
点击 Poliigon Addon 选项卡。

更新方法：

对于 Blender 4.2 及以上版本，您可以按照与安装相同的流程进行操作。直接拖放文件，并勾选“覆盖”选项。安装完成后，请务必立即重启 Blender。

如果您在更新时遇到任何错误，我们建议您彻底卸载该插件（请参阅下一节），重启 Blender，然后按照上述步骤重新安装。

如何卸载

不再需要使用该插件，或者安装出现问题想要彻底清除后再试？请参考以下步骤：

在 Blender 中，前往 edit > preferences，进入 addons，搜索 Poliigon（或点击插件旁边的齿轮图标）。
展开 Poliigon Addon 项目，然后点击“Remove”按钮。
1. 或者，您也可以直接取消勾选插件名称旁边的复选框。这只会禁用插件而不会将其卸载，方便您以后重新启用。但如果您是在排查故障，建议您彻底移除该插件。
确保所有 Blender 版本均已关闭。
删除您的 Poliigon Blender 设置文件夹，路径位于：C:\Users\{username}\Poliigon\blender 或 Mac/Linux 系统上的 /Users/{username}/Poliigon/blender。
可选：如果您以后不再打算使用任何 Poliigon 软件，也可以安全地删除 C:\Users\{username}\Poliigon\OnlinePreviews 文件夹。如果您使用了 Poliigon 下载的默认路径，您可以保留或移动已下载的 asset，路径位于 C:\Users\{username}\Poliigon\Library。

深度指南：

背景

该插件于 2022 年夏季首次发布，让您无需离开 Blender 即可浏览、购买、下载和导入 Poliigon asset。它支持加载纹理、模型和 HDR，最近还支持生成可用于 Blender Asset Browser 的 blender 文件。

用户账户设置

安装插件后，您可以进入 3D 视图登录您的 Poliigon 账户。按“n”键打开侧边栏，然后点击 Poliigon 选项卡。

如果尚未操作，请在 3D viewport 的 (n) 侧面板中选择 Poliigon 选项卡
点击“Login”或“Sign Up”
网页将会打开。如果您尚未登录，请完成登录流程
当看到“Return to the addon”屏幕时，请返回 Blender
确认或更改默认的 Poliigon 库文件夹。这是文件下载和导入的路径（您可以随时在用户首选项中更改或添加其他库文件夹）

Poliigon Unlimited 计划

如果您拥有有效的 unlimited plan，插件的行为会有所不同：

您将看到一个 unlimited 图标，而不是 asset 余额
您可以直接无限制地 (re)download 和导入任何 asset
您将无法预览纹理，而是直接下载它们
您下载的 asset 将出现在 Downloads 过滤器中，即使它们已不在本地

浏览插件

查看分类

点击“选择分类”按钮，您可以先按类型（Textures、Models、HDRIs 和 Free）筛选 asset，然后再进一步细分。最初只会显示一个按钮，随着子分类的可用，会添加更多按钮。点击任意分类即可返回上一级分类。显示的结果与网站上完全一致。

Asset 网格

每个 asset 下方的按钮会根据该 asset 是否已购买或下载而变化。左上角的图标可帮助您一目了然地了解 asset 的可用性：

已下载 - 由左上角的空心向下箭头图标表示，这些是您之前购买或下载过的 asset。
本地已存在 - 由实心向下箭头表示，您可以根据 asset 类型点击 Apply 或 Import 按钮。
最新发布 - 由绿色闪光图标表示，这些是过去 30 天内发布的 asset。
免费 asset - 由蓝色标签图标表示，这些 asset 可以免费下载，不会消耗您的 asset 余额，也不计入无限公平使用限制。
尚未下载 - 这些 asset 左上角不会显示图标。拥有 asset 余额的 Pro 用户将看到 Purchase 按钮。

未拥有（非无限/免费计划）

眼睛图标 - 如上箭头所示，此“快速预览”功能允许您将低分辨率、带水印的预览应用到所选对象。（目前仅适用于材质）
购买/下载 - 这将以默认分辨率下载 asset。默认设置可以在插件设置中更改，点击齿轮图标即可。
向下箭头 - 此“快速菜单”允许您查看更大的缩略图并快速在线打开该 asset。

可下载（无限套餐）或已拥有（有限套餐）

下载 - 如果已购买但尚未下载，此按钮会将 asset 下载到您 Addon 的主库文件夹中。
导入/应用 - 如果已下载，此操作会将 asset 导入到 Blender 中。如果这是材质 asset 且选中了物体，它将显示为“应用”，并自动将材质应用到所选物体上。如果未选中物体，它会将材质加载到内存中并创建一个伪用户（fake user），但不会应用它。模型始终作为新物体导入到场景中。
向下箭头 - 此快捷菜单允许您导入/下载不同分辨率的 asset，以及在本地打开文件夹。

大型详情查看器

通过向下箭头的快捷菜单，您可以为任何 asset 打开一个动态的大型详情查看器。在此菜单中，您可以轻松购买、下载和导入 asset。如果 asset 已下载，您还可以使用按钮打开本地文件夹。

筛选视图

在执行搜索或更改类别后，您可以进一步将结果筛选为以下视图之一：

全部： 查看整个在线 Poliigon 库（仅限于您的搜索词或所选类别）
已拥有： 查看您通过 asset 余额获取的 asset - 对于免费用户或未通过 asset 余额获取任何 asset 的用户，此项不会显示。
下载： 列出您之前下载过的所有 asset，无论它们当前是否在本地。
本地： 列出所有在本地找到文件的 asset。
已导入： 列出在当前 blend 文件或打开的场景中找到的 asset。

账户详情部分

显示订阅详情，包括当前状态，例如已暂停或不续订
立即订阅 / 管理账户 - 此按钮将在浏览器中打开相应页面，以便购买或编辑订阅

打开首选项和插件帮助

直接打开 Poliigon 插件首选项。也可以通过“编辑” > “首选项” > “插件”，然后搜索 Poliigon 来访问。

点击左侧的书本图标以打开此在线文档页面。

插件首选项

库 + 附加目录部分

库 - 插件下载 asset 时使用的主根文件夹
附加库 - 允许您指定用于扫描下载 asset 的附加目录。（注意 - 目前仅支持 Poliigon asset。）

Asset Browser 首选项

仅在您至少拥有一个已购买的 asset 时可见（不适用于免费或无限下载的 asset）

库名称 - 插件将在 Blender 的“文件路径”部分中创建或搜索的库路径名称。这将是 Blender Asset Browser 中 Poliigon 库的显示名称
同步本地 asset - 一个启动创建库并处理 asset 以便在库中显示的按钮。

显示首选项

这些设置现在也可以在 asset 网格上方的过滤器栏旁边的下拉菜单中找到。

缩略图大小 - 更改 3D 面板网格查看器中显示的缩略图大小
每页 asset 数量 - 主 UI 中每页显示的 asset 数量。
- 注意：为获得最佳稳定性，我们建议使用 10 或更小的页面大小
刷新数据 - (v1.2+) 强制完全刷新图标和插件内部数据，也可作为搜索栏旁 3D 视图面板中的刷新图标使用

纹理设置

默认纹理分辨率 - 下载和导入时默认（最接近）的分辨率大小。对于任何给定的 asset，你仍然可以使用 asset 下拉菜单选择其他分辨率进行下载或导入，而不必使用默认值。
贴图偏好设置
- 与 Poliigon 网站类似，你可以精细控制扩展名以及下载中包含哪些文件。这些设置也用于判断执行导入操作所需的文件。因此，请注意更改这些设置可能需要你为本地已有的 asset 下载新的贴图。对此类 asset 点击下载只会下载缺失的文件，而不一定会下载整个 asset。这些设置仅适用于采用我们最新标准格式的 asset。
- 恢复网页偏好设置： 按下此按钮会将下方的各项贴图偏好设置重置为与你在网站上的当前下载设置一致。
- 贴图勾选框： 取消勾选该框可跳过此贴图的下载和导入；仅适用于“可选”贴图，大多数贴图对于准确呈现材质是必需的。
- 扩展名下拉菜单： 在 JPG、PNG、Tiff（仅限团队版，Displacement 贴图除外）和 Exr（仅限企业版）之间进行选择。

模型设置

下载并导入 .blend 文件 - 如果勾选，将下载 .blend 文件而不是 FBX，不会影响 LOD。
链接 .blend 文件 - 如果有 .blend 文件可用且勾选了优先导入偏好设置，将尝试链接对象而不是追加。
默认模型分辨率 - 下载模型纹理时使用的默认分辨率。
下载模型 LOD - 如果勾选，将自动下载模型的所有细节层次（LOD）FBX 文件。
默认模型 LOD - 如果 LOD 已在本地，则选择要导入的细节层次。如果选择“无”（NONE），将导入默认的 .blend 文件。否则，将导入相应的 LOD FBX 文件。

HDRI 设置

默认 HDRI 灯光分辨率 - HDRI 灯光的默认分辨率，与背景分辨率分开设置。
使用 JPG 作为背景 - 如果勾选，默认导入操作将使用下方指定的不同背景分辨率。
默认 HDRI 背景分辨率 - 如果启用了“使用 JPG 作为背景”，则为 HDRI 设置默认背景分辨率。此值仅影响场景背景，不影响灯光。这是一种在不加载高内存占用 EXR 灯光文件的情况下提高背景分辨率的方法，但可能会遇到更多裁剪问题，且对场景曝光的响应效果较差。

其他设置

购买后自动下载 asset - 切换购买后是否自动下载 asset。不适用于免费或无限用户，也不会显示。
显示购买确认 - 购买 asset 时，在执行购买前显示额外的弹出确认对话框。不适用于免费或无限用户，也不会显示。
置换方式 (Disp. Method) - 导入时使用的默认表面凹凸和置换方式。选项如下：
- 仅 Normal：仅使用 Normal 贴图进行模拟凹凸表面细节。默认选项。
- 仅 Bump：使用 Displacement 贴图代替 Normal 贴图进行模拟凹凸表面细节。仅适用于 Cycles 和 Eevee Next。
- Displacement 和 Bump：使用 Displacement 贴图进行模拟凹凸表面细节和物理置换。仅适用于 Cycles 和 Eevee Next。
- 我们之前在此处提供了 Micro (adaptive) Displacements 选项，现在您可以在导入 texture asset 后，直接使用“重做上一步”菜单开启 Adaptive Displacement。
使用 16 位贴图： 如果存在，则加载更高位深度的贴图（例如用于 Normal 贴图以提高精度）。
自动检查更新（每日）： 每 24 小时检查一次更新（如果 Blender 处于打开状态）。您也可以随时点击“检查更新”。
向控制台输出详细日志： 默认启用，会将额外的调试信息添加到系统输出控制台中。不会影响插件行为。
共享插件错误/使用情况： 登录时也可设置。如果启用，将自动向开发者共享插件内遇到的错误。此外，还会发送插件内的关键事件（例如按下操作符或查看部分），以便我们更好地了解其使用情况并提升性能。我们不会发送 Poliigon Addon 之外的任何使用行为。

使用 Material

应用 Material

选择您想要应用 Material 的对象。
点击插件内 Material 选择项上的“Apply”按钮。

Material “Adjust last” / “Redo Last” 设置

导入或应用 Material 后，查看 3D 视图左下角或按 F9 键调出“adjust last”菜单。

Texture - 选择其他纹理分辨率（仅限于已在本地的尺寸）
Mapping - 在不同的纹理映射选项之间进行选择：
- 内置映射选项包括：UV、Flat、Box、Sphere、Tube
- Mosaic：一种特殊的去平铺节点，非常适合打破重复感（也可在着色器节点编辑器的“Shift-A > Poliigon Node Groups”菜单中找到）。
Displacement method - 选择要使用的 Displacement 方法（默认为用户首选项中的选择，该选项本身默认为 Normal Only）
- Normal Only：仅使用 Normal 贴图进行模拟凹凸表面细节。默认选项。
- Bump Only：使用 Displacement 贴图代替 Normal 贴图进行模拟凹凸表面细节。仅适用于 Cycles 和 Eevee Next。
- Displacement and Bump：使用 Displacement 贴图进行模拟凹凸表面细节和物理 Displacement。仅适用于 Cycles 和 Eevee Next。
- Adaptive Displacement Only：仅使用 Displacement 贴图进行几何 Displacement，并为 Material 和应用的对象设置像素级细分，配合 subdiv 修改器使用。仅限 Cycles。
Displacement strength - 调整要应用的 Displacement 强度，单位为米。如果上方选择了“Normal Only”，则此项不可见。
Scale - 更改展开映射比例的尺寸乘数。数值越高，纹理的平铺数量越多。
16-Bit textures (if any) - 加载更高位深的贴图，但会占用更多内存。
Reuse Material - 如果您之前已经以相同的纹理尺寸和映射组合导入过该 Material，则重复使用该 Material，而不是生成一个新的。
Keep Additional Texture Nodes - 如果本地还有其他未直接连接到着色器输出的纹理贴图（例如 ID 贴图或顶点混合颜色贴图），请将它们保留在 Material 中以便后续使用。如果这些 Material 贴图保持断开连接，则不会影响渲染时间。

材质调整面板

虽然“重做上一步”面板仅在导入后立即存在，但当您选择一个带有 Poliigon material 的模型和材质槽时，您可以随时前往 Properties > Material > Poliigon 选项卡。在那里，您可以调整在最初导入时所拥有的部分设置：

调整已导入的材质

要调整已导入的材质，请打开 shading 选项卡并找到材质节点组。从 v1.6.0 及更高版本开始，我们现在直接加载整个材质，而无需对材质节点进行额外的分组。此示例材质布局的片段如下所示。

Ambient Occlusion 已连接但默认处于关闭状态，因为它对于路径追踪渲染而言既不真实也不必要。如果需要，请增加颜色混合节点的 Factor 以将其应用于您的材质。

是否要导出带有材质的对象以用于游戏引擎（例如 gLTF、obj 或 fbx）？为了获得最佳效果，请断开 Ambient Occlusion 节点，否则输出文件将无法包含颜色贴图，而其他贴图可能会被保留。并非所有导出格式都能保留所有贴图。

Poliigon Nodegroup (Legacy)

在此插件 v1.6.0 版本之前，材质会导入到此旧版节点组中。预先保存的材质以及从网站下载的 blend 格式模型在导入或重复使用时可能仍会包含此节点组：

Scale - 调整材质的缩放比例。
Aspect Ratio - 用于非正方形纹理的调整，导入时会自动调整。
Translate X, Y - 沿 X、Y 轴移动纹理，对应于 UV。
Global Rotation - 旋转材质，对应于 UV。
Color Hue, Saturation, Value, Brightness, and Contrast Adj. - 调整滑块
AO Strength - 调整 Ambient Occlusion 纹理的影响程度。
Roughness Adj. - 对 Roughness 贴图的调整。
Normal Strength - 调整 Normal 贴图的强度。
Displacement Strength - 调整 Displacement 强度（默认为零！）
Displacement Mid-Level - 调整 Displacement 的中间值。
Bump Strength - 调整 Bump 贴图的强度（默认为 0.005）
Subsurface Multiplier - 调整 SSS 贴图的效果。

* 根据导入的材质，某些数值可能会缺失。例如，如果材质没有 SSS 贴图，则不会列出 Subsurface Multiplier 数值。

使用模型

导入模型

将 3D Cursor 设置到所需位置
在插件内点击“导入” (Import)
查看 F9/重做上一步 (redo last) 菜单以获取更多导入选项，例如将模型作为集合 (collections) 导入，或将导入方式从追加 (append) 更改为链接 (link)（导入 LOD 时不适用）

模型重做上一步设置

导入模型后，请查看 3D 视图左下角或按 F9 调出“重做上一步” (redo last) 菜单。

LOD - 如果有可用的 LOD，请使用以下设置进行导入。使用“链接 .blend 文件” (Link .blend file) 时不可用。LOD 始终加载磁盘上的 FBX 文件，而非源 .blend 文件，因此您可能会发现材质设置存在一些差异。
纹理 (Texture) - 更改要加载的模型纹理，仅显示已下载的模型分辨率。
作为集合导入 (Import as collection) - 如果勾选此项，将会在场景原点为该模型创建一个集合，并放置该集合的一个实例。后续的模型导入将继续引用该现有集合，而不是执行新的导入。
复用材质 (Reuse materials): - 如果您之前已经导入过此模型，则复用之前的材质，而不是创建新的副本。
链接 .blend 文件 (Link .blend file) - 如果有可用的 .blend 文件，则实时链接模型。如果禁用，所有操作将表现为“追加” (append)。

模型调整面板

与材质类似，您也可以在事后调整模型的分辨率。您只能从此面板中选择已存在于本地的分辨率。您可以在“属性” (Properties) > “物体” (Object) > Poliigon 面板中找到它。仅当选中 Poliigon 模型（例如父级空物体或其网格之一）时，此面板才会显示。

使用 HDR

导入 HDR 时，它会自动分配给当前激活的世界环境，如果需要，也会创建一个新的世界环境。除非进入渲染模式，否则您无法看到此 HDR；切换到 World 视图后，您可以在着色器窗口中看到节点布局。根据您的用户偏好，HDR 导入时会带有两个图像输入

Light - 用于实际照亮场景的高位深 EXR 文件。
Background - 在背景渲染中可见的 JPG 图像。

HDRI 重做上次设置

导入 HDR 后，请查看 3D 视图的左下角或按 F9 键调出“重做上次”菜单。

Light Texture - 用于照亮场景的 EXR 分辨率大小
Background Texture - 默认使用 Light Texture，但您可以选择另一个通常分辨率更高的 JPG
HDR Strength - 光照纹理照亮场景的强度
Z-Rotation - 使用此滑块旋转整个 HDR

HDRI 调整面板

您也可以在 Properties > World > Poliigon 面板中快速调整相同的“重做上次”设置。此功能仅适用于通过 Poliigon 导入的世界环境。

Blender Asset Browser 集成

从插件 1.4.0 版本开始，Pro 计划（非无限版）现已支持 Blender Asset Browser。此功能仅支持在 Pro 有限计划中使用资产余额购买的资产，不适用于免费下载或无限下载的 asset。

同步已下载的 asset 后，您可以轻松地将它们拖放到场景中。用于 asset 库的 Poliigon blend 文件是即时生成的，生成时会使用您当前用户偏好设置中默认的尺寸和设置变体。您会注意到 asset 旁边出现了“_LIB.blend”文件，这使得此集成功能得以正常工作。在可能的情况下，模型文件将链接到源 blend 文件，以避免数据重复。