Pivot-Painter-for-Blender 项目启动与配置教程

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

Pivot-Painter-for-Blender 是一个开源项目，旨在为 Blender 提供一个旋转绘画工具。以下是项目的目录结构及其介绍：

Pivot-Painter-for-Blender/
├── __init__.py           # 初始化文件，Python 包的标准文件
├── README.md             # 项目说明文件
├── blender               # Blender 插件目录
│   ├── __init__.py       # 初始化文件，Blender 插件的标准文件
│   ├── add-ons           # 插件主目录
│   │   ├── __init__.py   # 初始化文件
│   │   └── pivot Painter # Pivot-Painter 主模块
│   │       ├── __init__.py # 初始化文件
│   │       ├── properties.py # 属性定义文件
│   │       └── operators.py # 操作定义文件
│   └── ...              # 其他相关文件
└── ...                  # 其他文件和目录

在这个目录结构中，blender 目录是项目的核心，包含了所有与 Blender 插件相关的文件。

2. 项目的启动文件介绍

项目的启动主要通过 Blender 插件系统进行。在 blender/add-ons/__init__.py 文件中，通常会包含以下代码来注册插件：

import bpy

from .pivot_Painter import register, unregister

def register():
    bpy.utils.register_module(__name__)
    # 这里可以添加其他插件初始化的代码

def unregister():
    bpy.utils.unregister_module(__name__)
    # 这里可以添加其他插件卸载的代码

用户在 Blender 中安装此插件时，Blender 会自动调用 register 函数，而卸载时则会调用 unregister 函数。

3. 项目的配置文件介绍

项目的配置主要通过 properties.py 文件进行。这个文件定义了插件在 Blender 用户界面中的属性，例如工具的设置和参数。以下是一个简单的配置文件示例：

import bpy

class PivotPainterProperties(bpy.types.PropertyGroup):
    # 定义一个整数属性，用于控制笔刷大小
    brush_size: bpy.props.IntProperty(
        name="Brush Size",
        description="笔刷大小",
        default=10
    )

    # 定义一个布尔属性，用于启用或禁用某个功能
    enable_feature: bpy.props.BoolProperty(
        name="Enable Feature",
        description="启用功能",
        default=True
    )

# 注册属性组
def register():
    bpy.utils.register_class(PivotPainterProperties)

    # 将属性组添加到Blender的类型中
    bpy.types.Scene.pivot_painter_properties = bpy.props.PointerProperty(
        type=PivotPainterProperties
    )

# 卸载属性组
def unregister():
    del bpy.types.Scene.pivot_painter_properties
    bpy.utils.unregister_class(PivotPainterProperties)

在上述代码中，PivotPainterProperties 类定义了插件在 Blender 用户界面中的属性，然后在注册和卸载函数中分别注册和卸载这些属性。这样，用户就可以在 Blender 的用户界面中调整这些设置了。