Poly Haven Assets 项目使用教程

Poly Haven Assets 项目使用教程

polyhavenassetsA Blender add-on to integrate our assets natively in the asset browser项目地址:https://gitcode.com/gh_mirrors/po/polyhavenassets

1. 项目的目录结构及介绍

Poly Haven Assets 是一个 Blender 插件，用于在 Blender 的资产浏览器中集成 Poly Haven 的资源。项目的目录结构如下：

polyhavenassets/
├── __init__.py
├── addon.py
├── ui.py
├── utils.py
├── assets/
│   ├── hdris/
│   ├── textures/
│   └── models/
├── config/
│   ├── settings.json
│   └── defaults.json
└── README.md

• __init__.py: 插件的初始化文件。
• addon.py: 插件的主要功能实现。
• ui.py: 用户界面的定义。
• utils.py: 工具函数和辅助功能。
• assets/: 包含不同类型的资产，如 HDRI、纹理和模型。
• config/: 配置文件目录，包含用户设置和默认设置。
• README.md: 项目的说明文档。

2. 项目的启动文件介绍

项目的启动文件是 __init__.py。这个文件负责初始化插件，并注册必要的类和函数。以下是 __init__.py 的主要内容：

bl_info = {
    "name": "Poly Haven Assets",
    "category": "Asset",
    "version": (1, 0, 0),
    "blender": (2, 80, 0),
    "description": "Integrate Poly Haven assets natively in the asset browser"
}

import bpy
from .addon import register, unregister

def register():
    bpy.utils.register_class(PolyHavenAssets)

def unregister():
    bpy.utils.unregister_class(PolyHavenAssets)

• bl_info: 包含插件的基本信息，如名称、类别、版本和 Blender 版本要求。
• register(): 注册插件类和功能。
• unregister(): 注销插件类和功能。

3. 项目的配置文件介绍

项目的配置文件位于 config/ 目录下，主要包括 settings.json 和 defaults.json。

• settings.json: 存储用户的自定义设置，如资产路径、显示选项等。
• defaults.json: 存储插件的默认设置，用于初始化和重置用户设置。

以下是 settings.json 的一个示例：

{
    "asset_path": "assets/",
    "display_options": {
        "show_hdris": true,
        "show_textures": true,
        "show_models": false
    }
}

• asset_path: 指定资产的存储路径。
• display_options: 控制不同类型资产的显示选项。

通过这些配置文件，用户可以自定义插件的行为和显示内容，以满足不同的需求。

polyhavenassetsA Blender add-on to integrate our assets natively in the asset browser项目地址:https://gitcode.com/gh_mirrors/po/polyhavenassets