用途:指导在 Blender Python 中编写自定义 Operator(bpy.types.Operator 子类),适用于一次性操作、弹窗参数对话框、模态交互和确认弹窗等场景。
主要能力:提供 Operator 决策树、版本兼容性矩阵(3.x、4.0+、4.2+)、关键警告与多种模式示例,包括仅 execute、带属性、invoke 属性对话框、模态、上下文覆盖和确认对话框。说明从脚本调用 Operator、注册到菜单、report 报告类型、bl_idname 命名规范、bl_options 各标志用途和返回值语义。
必要用法:从 execute()、invoke()、modal() 必须返回集合,如 {'FINISHED'}、{'CANCELLED'}、{'RUNNING_MODAL'};修改场景数据的 Operator 需设置 bl_options = {'REGISTER', 'UNDO'};poll() 必须是 @classmethod;Blender 4.0+ 用 context.temp_override() 替代已移除的字典式覆盖;bl_idname 的 category 部分须小写,格式为 "category.operator_name";不要在 Panel.draw() 中调用 bpy.ops.*。注册使用 bpy.utils.register_class 和 unregister_class。
适用场景:创建自定义 Blender 操作、交互式工具、对话框式命令、视图上下文相关调用及菜单集成。
限制:资料仅提供语法与模式说明;具体 API 细节以官方文档链接为准,其他功能、收费或平台信息暂未提供。