# 要使这个插件可安装，需要按照以下教程创建扩展包： # https://docs.blender.org/manual/en/latest/advanced/extensions/getting_started.html # 导入必要的工具包 import bpy # Blender的Python API主模块 from bpy.types import Operator # 创建操作的基类 from bpy.props import FloatVectorProperty # 定义可调整的属性 from bpy_extras.object_utils import AddObjectHelper, object_data_add # 添加物体的辅助工具 from mathutils import Vector # 处理3D坐标的数学工具 # 核心函数：创建矩形平面 def add_object(self, context): # 从用户输入获取矩形的宽和高 scale_x = self.scale.x # X轴缩放 = 宽度 scale_y = self.scale.y # Y轴缩放 = 高度 # 定义矩形的四个角坐标（Z轴为0表示平面） verts = [ Vector((-1 * scale_x, 1 * scale_y, 0)), # 左上角 Vector((1 * scale_x, 1 * scale_y, 0)), # 右上角 Vector((1 * scale_x, -1 * scale_y, 0)), # 右下角 Vector((-1 * scale_x, -1 * scale_y, 0)), # 左下角 ] edges = [] # 不需要单独边（因为用面定义） faces = [[0, 1, 2, 3]] # 连接四个顶点形成一个面 # 创建新网格数据 mesh = bpy.data.meshes.new(name="New Object Mesh") mesh.from_pydata(verts, edges, faces) # 将坐标数据转为网格 object_data_add(context, mesh, operator=self) # 将网格添加到场景 # 定义Blender操作按钮 class OBJECT_OT_add_object(Operator, AddObjectHelper): """创建一个新的矩形网格物体""" # 操作描述 bl_idname = "mesh.add_object" # 操作ID（内部调用名） bl_label = "添加矩形平面" # 界面显示名称 bl_options = {'REGISTER', 'UNDO'} # 支持撤销/重做 # 定义可调整的属性（在Blender中显示为滑块） scale: FloatVectorProperty( name="缩放尺寸", # 属性名称 default=(1.0, 1.0, 1.0), # 默认值 (宽, 高, 厚度) subtype='TRANSLATION', # 界面显示为坐标控件 description="控制矩形的宽度和高度", # 鼠标悬停提示 ) # 当用户点击按钮时执行 def execute(self, context): add_object(self, context) # 调用创建函数 return {'FINISHED'} # 告诉Blender操作已完成 # 插件注册系统 # 在"添加物体"菜单中创建按钮 def add_object_button(self, context): self.layout.operator( OBJECT_OT_add_object.bl_idname, text="添加矩形", # 按钮文字 icon='PLUGIN', # 插件图标 ) # 右键菜单文档链接配置 def add_object_manual_map(): url_manual_prefix = "https://docs.blender.org/manual/en/latest/" # 点击该链接没有作用，因为这是Steam自动标注链接 url_manual_mapping = ( ("bpy.ops.mesh.add_object", "scene_layout/object/types.html"), ) return url_manual_prefix, url_manual_mapping # 注册插件到Blender系统 def register(): bpy.utils.register_class(OBJECT_OT_add_object) # 注册操作类 bpy.utils.register_manual_map(add_object_manual_map) # 注册帮助文档 bpy.types.VIEW3D_MT_mesh_add.append(add_object_button) # 添加到3D视图菜单 # 卸载插件时清理 def unregister(): bpy.utils.unregister_class(OBJECT_OT_add_object) # 注销操作类 bpy.utils.unregister_manual_map(add_object_manual_map) # 注销帮助文档 bpy.types.VIEW3D_MT_mesh_add.remove(add_object_button) # 从菜单移除按钮 # 直接运行脚本时启用插件 if __name__ == "__main__": register()