【亲测免费】 BlenderUSDZ 插件使用教程

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

BlenderUSDZ 插件的目录结构如下：

BlenderUSDZ/
├── README.md
├── LICENSE
├── __init__.py
├── usdz_export.py
├── usdz_import.py
├── utils.py
└── config/
    └── settings.json

• README.md: 项目说明文件，包含项目的基本信息和使用指南。
• LICENSE: 项目的开源许可证，本项目使用 AGPL-3.0 许可证。
• __init__.py: 插件的初始化文件，负责插件的加载和初始设置。
• usdz_export.py: 导出 USDZ 文件的功能实现。
• usdz_import.py: 导入 USDZ 文件的功能实现。
• utils.py: 工具函数集合，包含一些常用的辅助函数。
• config/: 配置文件目录。
  • settings.json: 插件的配置文件，包含一些用户可自定义的设置。

2. 项目的启动文件介绍

项目的启动文件是 __init__.py，该文件负责插件的加载和初始设置。以下是 __init__.py 的主要内容：

import bpy
from .usdz_export import export_usdz
from .usdz_import import import_usdz

def register():
    bpy.utils.register_module(__name__)
    print("BlenderUSDZ 插件已注册")

def unregister():
    bpy.utils.unregister_module(__name__)
    print("BlenderUSDZ 插件已卸载")

if __name__ == "__main__":
    register()

• register(): 注册插件，将插件的功能添加到 Blender 中。
• unregister(): 卸载插件，移除插件的功能。
• if __name__ == "__main__": 这行代码确保在直接运行 __init__.py 文件时，插件会被注册。

3. 项目的配置文件介绍

配置文件位于 config/settings.json，该文件包含一些用户可自定义的设置。以下是一个示例配置文件的内容：

{
    "export_path": "path/to/export",
    "import_path": "path/to/import",
    "default_settings": {
        "scale": 1.0,
        "orientation": "YUP"
    }
}

• export_path: 导出 USDZ 文件的默认路径。
• import_path: 导入 USDZ 文件的默认路径。
• default_settings: 默认设置，包含缩放比例 (scale) 和坐标轴方向 (orientation)。

通过修改 settings.json 文件，用户可以自定义插件的行为和默认设置。

---

以上是 BlenderUSDZ 插件的基本使用教程，希望对你有所帮助。