Blender Sketchfab 插件使用教程

目录结构及介绍

blender-plugin/
├── LICENSE
├── README.md
├── addon
│   ├── __init__.py
│   ├── api.py
│   ├── config.py
│   ├── ui.py
│   └── utils.py
├── docs
│   └── usage.md
└── tests
    └── test_api.py

• LICENSE: 项目的许可证文件。
• README.md: 项目的说明文档。
• addon/: 插件的主要代码目录。
  • __init__.py: 插件的入口文件。
  • api.py: 与 Sketchfab API 交互的模块。
  • config.py: 配置文件处理模块。
  • ui.py: 用户界面模块。
  • utils.py: 工具函数模块。
• docs/: 文档目录，包含使用说明等。
• tests/: 测试代码目录。

项目的启动文件介绍

addon/__init__.py 是插件的启动文件，负责初始化插件并注册到 Blender 中。该文件通常包含以下内容：

bl_info = {
    "name": "Sketchfab Exporter",
    "blender": (2, 80, 0),
    "category": "Import-Export",
}

import bpy
from . import ui, api, config

def register():
    ui.register()
    api.register()
    config.register()

def unregister():
    ui.unregister()
    api.unregister()
    config.unregister()

if __name__ == "__main__":
    register()

• bl_info: 插件的基本信息，包括名称、兼容的 Blender 版本和分类。
• register(): 注册插件的函数。
• unregister(): 注销插件的函数。

项目的配置文件介绍

addon/config.py 文件负责处理插件的配置。通常包含以下内容：

import bpy

class SketchfabPreferences(bpy.types.AddonPreferences):
    bl_idname = __package__

    api_key: bpy.props.StringProperty(
        name="API Key",
        description="Your Sketchfab API key",
        default="",
        subtype='PASSWORD'
    )

    def draw(self, context):
        layout = self.layout
        layout.prop(self, "api_key")

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

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

• SketchfabPreferences: 插件的配置类，用于设置和保存用户的 API Key。
• api_key: 存储用户的 Sketchfab API Key。
• register(): 注册配置类的函数。
• unregister(): 注销配置类的函数。

以上是 Blender Sketchfab 插件的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助。