Blender-MCP服务源码4-初始化项目解读
上篇文章针对Blender开发框架完成了一个基础模板的搭建,并在Blender中成功进行了运行,那这个初始化项目中是如何进行页面效果呈现的,尝试手动进行功能精简来拆解项目代码
1-核心知识点
- 1)如何绘制Blender的插件UI->如何编写自己的UI界面
- 2)了解如何快速使用Blender的开发框架->知道在哪里添加自己的核心业务
2-思路整理
- 1)Blender开发框架-如何快速的搭建项目
- 1)main.py修改项目配置
- 2)create.py创建项目
- 3)test.py进行blender调试
- 2)只需要在AddonPanels.py修改业务逻辑即可
- 1)因为当前项目依赖test.py进行调试->框架中使用了国际化不能随便移除
- 2)尝试了多次,如果是尝试核心业务就不要删除代码的逻辑和目录结构
- 3)代码的调试和发布都是编排好的脚本->不要乱动
3-参考网址
- Blender-MCP-Github地址:https://github.com/ahujasid/blender-mcp
- B站大佬开源Blender开发框架:https://github.com/xzhuah/BlenderAddonPackageTool
- B站大佬开源Blender开发框架教程
4-上手实操
1-定位代码
- 右侧:示例插件
- 左侧:示例功能
- 文字定位
定义在一个字典中,针对左右的英文再进行代码定位
- 代码定位
貌似核心的代码都在这个文件中[AddonPanels.py](Blender-MCP在进行插件安装时候-也只有一个blender插件addon.py)-> 貌似我们已经快要接触到代码的本质了
import bpyfrom ..config import __addon_name__ # 导入插件名称常量
from ..operators.AddonOperators import ExampleOperator # 导入自定义操作符类
from ....common.i18n.i18n import i18n # 导入国际化函数
from ....common.types.framework import reg_order # 导入注册顺序装饰器# 基础面板类
class BasePanel(object):bl_space_type = "VIEW_3D" # 面板所在的空间类型为 3D 视图bl_region_type = "UI" # 面板所在的区域类型为 UI 区域bl_category = "ExampleAddon" # 面板的分类名称@classmethoddef poll(cls, context: bpy.types.Context):return True # 始终显示面板# 使用注册顺序装饰器,值为 0,优先级较高
@reg_order(0)
class ExampleAddonPanel(BasePanel, bpy.types.Panel):bl_label = "Example Addon Side Bar Panel" # 面板标签名称bl_idname = "SCENE_PT_sample" # 面板的唯一标识符def draw(self, context: bpy.types.Context):addon_prefs = context.preferences.addons[__addon_name__].preferences # 获取插件偏好设置layout = self.layout # 获取布局对象# 显示国际化文本和偏好设置中的数字layout.label(text=i18n("Example Functions") + ": " + str(addon_prefs.number))# 显示并允许编辑文件路径属性layout.prop(addon_prefs, "filepath")layout.separator() # 添加分隔线row = layout.row() # 创建一行布局# 在同一行显示并允许编辑数字和布尔属性row.prop(addon_prefs, "number")row.prop(addon_prefs, "boolean")# 添加操作符按钮layout.operator(ExampleOperator.bl_idname)@classmethoddef poll(cls, context: bpy.types.Context):return True # 始终显示面板# 这个面板将在 ExampleAddonPanel 之后绘制,因为其注册顺序值更高
@reg_order(1)
class ExampleAddonPanel2(BasePanel, bpy.types.Panel):bl_label = "Example Addon Side Bar Panel" # 面板标签名称bl_idname = "SCENE_PT_sample2" # 面板的唯一标识符def draw(self, context: bpy.types.Context):layout = self.layout # 获取布局对象layout.label(text="Second Panel") # 显示标签文本layout.operator(ExampleOperator.bl_idname) # 添加操作符按钮
2-待完善
通过对上面代码的阅读,去除代码中高阶的国际化等功能,我们只保留一个【按钮】点击之后将窗口的物体放大2倍!
后续会尝试在Blender中部署一个socket和MCP本地的服务器进行通讯
- 1)文字定义,否则页面展示不出来
- 2)定义的操作
比如页面上要定义的点击事件,示例:点击按钮让图形缩小0.8倍(3步骤)
- 1)先定义Operator->直接拷贝示例后修改
- 2)再配置你的Operator->在国际化配置中配置
- 3)更换你自己的事件
import bpyfrom ..config import __addon_name__
from ..preference.AddonPreferences import ExampleAddonPreferences# 自己定义的Operator
class BlenderMCPServer(bpy.types.Operator):'''ExampleAddon'''bl_idname = "object.blender_mcp_server"bl_label = "BlenderMCPServer"# 确保在操作之前备份数据,用户撤销操作时可以恢复bl_options = {'REGISTER', 'UNDO'}@classmethoddef poll(cls, context: bpy.types.Context):return context.active_object is not Nonedef execute(self, context: bpy.types.Context):addon_prefs = bpy.context.preferences.addons[__addon_name__].preferencesassert isinstance(addon_prefs, ExampleAddonPreferences)# manipulate the scale directlycontext.active_object.scale *= 0.8return {'FINISHED'}