编写 blender python 扩展 (extension / addon)

blender 集成了 python 运行环境, 可以通过编写脚本, 来实现一些小工具, 方便进行一些操作.

本文就来编写一个简单的 blender python 扩展, 能够持续旋转被选中的物体.

使用的 blender 版本: 4.3.0 (测试版)

这里是 穷人小水滴, 专注于 穷人友好型 低成本技术. (本文为 64 号作品. )


相关文章:

参考资料:

目录

  • 1 安装扩展及效果演示
    • 1.1 python 源代码
    • 1.2 安装扩展
    • 1.3 操作及效果
  • 2 扩展的 python 代码解释
  • 3 总结与展望

1 安装扩展及效果演示

1.1 python 源代码

首先, 将下列代码保存为 test_a.py 文件:

py 复制代码
# 测试 blender 扩展 (add-on)

bl_info = {
    "name": "测试旋转物体 (Z)",
    "blender": (4, 2, 0),
    "category": "Object",
}

import math
import bpy

class 测试旋转操作(bpy.types.Operator):
    """沿 Z 轴持续旋转物体, 按 ESC 键停止"""
    bl_idname = "object.test_r"
    bl_label = "test 测试旋转物体 (Z)"
    bl_options = {'REGISTER', 'UNDO'}

    # 用于持续回调
    _定时器 = None

    def modal(self, context, event):
        # 按下 ESC 键, 结束
        if event.type == 'ESC':
            self.cancel(context)
            return {'CANCELLED'}

        # 定时器回调
        if event.type == 'TIMER':
            # 旋转速度: 180 度 / 秒
            速度 = 180.0
            # 角度 转换成 弧度
            角度 = math.radians(速度 * self._定时器.time_duration)

            # 当前选中物体
            物 = context.active_object
            # 物.rotation_mode = 'XYZ'
            物.rotation_euler[2] = 角度  # 修改 Z 轴旋转

        return {'PASS_THROUGH'}

    def execute(self, context):
        print("DEBUG test: execute")

        w = context.window_manager
        # 每 0.1 秒回调一次
        self._定时器 = w.event_timer_add(0.1, window=context.window)

        w.modal_handler_add(self)
        # 操作持续运行
        return {'RUNNING_MODAL'}

    def cancel(self, context):
        w = context.window_manager
        w.event_timer_remove(self._定时器)

def 菜单项(self, context):
    self.layout.operator(测试旋转操作.bl_idname)

# 注册组件类
def register():
    bpy.utils.register_class(测试旋转操作)
    bpy.types.VIEW3D_MT_object.append(菜单项)

    print("DEBUG test: register")

# 清理 (取消注册)
def unregister():
    bpy.utils.unregister_class(测试旋转操作)

if __name__ == "__main__":
    register()

文件名任意, 此处只是举栗.

1.2 安装扩展

(1) 打开 blender, 点击菜单 编辑 (Edit) -> 选项 (Preferences):

(2) 点击左侧 扩展 (Add-ons) -> 右侧 从本地安装 (Install from Disk):

(3) 选择之前保存的 test_a.py 文件:

(4) 然后就会安装好扩展:

如果在终端运行 blender, 还会在终端看到输出:

sh 复制代码
DEBUG test: register
Modules Installed (test_a) from '/home/s2/test_a/test_a.py' into '/home/s2/.config/blender/4.3/scripts/addons'

1.3 操作及效果

(1) 选中要操作的物体:

(2) 按 F3 键打开搜索框:

(3) 点击执行命令:

完结撒花 ~

对了, 别忘了按 Esc 键停止操作.

2 扩展的 python 代码解释

本文的主要目的是介绍 blender python 扩展如何编写, 上面实现的具体功能不是重点.

py 复制代码
bl_info = {
    "name": "测试旋转物体 (Z)",
    "blender": (4, 2, 0),
    "category": "Object",
}

定义扩展的名称, 需要的最低 blender 版本号等, 方便 blender 识别.

py 复制代码
class 测试旋转操作(bpy.types.Operator):
    """沿 Z 轴持续旋转物体, 按 ESC 键停止"""
    bl_idname = "object.test_r"
    bl_label = "test 测试旋转物体 (Z)"
    bl_options = {'REGISTER', 'UNDO'}

定义一个操作 (类), 继承 bpy.types.Operator. 此处定义类的唯一 ID, 显示标签名称等.

py 复制代码
    def modal(self, context, event):
        # 按下 ESC 键, 结束
        if event.type == 'ESC':
            self.cancel(context)
            return {'CANCELLED'}

        # 定时器回调
        if event.type == 'TIMER':
            # 旋转速度: 180 度 / 秒
            速度 = 180.0
            # 角度 转换成 弧度
            角度 = math.radians(速度 * self._定时器.time_duration)

            # 当前选中物体
            物 = context.active_object
            # 物.rotation_mode = 'XYZ'
            物.rotation_euler[2] = 角度  # 修改 Z 轴旋转

        return {'PASS_THROUGH'}

操作可以分为一次性操作 (很快结束), 和持续操作 (持续一段时间). modal 是用于持续操作的. 在这里处理回调事件, 对于定时器事件, 计算并修改物体的旋转角度.

py 复制代码
    def execute(self, context):
        print("DEBUG test: execute")

        w = context.window_manager
        # 每 0.1 秒回调一次
        self._定时器 = w.event_timer_add(0.1, window=context.window)

        w.modal_handler_add(self)
        # 操作持续运行
        return {'RUNNING_MODAL'}

这个函数在执行这个操作时, 会调用. 在这里创建一个定时器, 并持续运行.

py 复制代码
# 注册组件类
def register():
    bpy.utils.register_class(测试旋转操作)
    bpy.types.VIEW3D_MT_object.append(菜单项)

    print("DEBUG test: register")

# 清理 (取消注册)
def unregister():
    bpy.utils.unregister_class(测试旋转操作)

if __name__ == "__main__":
    register()

最后是初始化注册代码, 注册之后就可以在 blender 里使用了.

代码很简单吧, 喵 ?

3 总结与展望

本文编写了一个简单的 blender python 扩展, 实现了持续旋转物体的功能.

blender python 扩展的编写简单方便, 可以用于制作小工具, 提高效率. 也能用于结合别的软件系统, 总之, 发挥和想像的空间很大 !


本文使用 CC-BY-SA 4.0 许可发布.

相关推荐
chao_7895 分钟前
更灵活方便的初始化、清除方法——fixture【pytest】
服务器·自动化测试·python·pytest
心情好的小球藻35 分钟前
Python应用进阶DAY9--类型注解Type Hinting
开发语言·python
都叫我大帅哥36 分钟前
LangChain加载HTML内容全攻略:从入门到精通
python·langchain
说私域40 分钟前
基于开源AI大模型、AI智能名片与S2B2C商城小程序源码的用户价值引导与核心用户沉淀策略研究
人工智能·开源
说私域41 分钟前
线上协同办公时代:以开源AI大模型等工具培养网感,拥抱职业变革
人工智能·开源
Dontla43 分钟前
Fair-code介绍(Fair code)(一套新型软件模型:旨在“开源”&“商业可持续性”中找到平衡)
开源
惜.己1 小时前
使用python读取json数据,简单的处理成元组数组
开发语言·python·测试工具·json
向宇it1 小时前
【unity组件介绍】URP Decal Projector贴花投影器,将特定材质(贴花)投影到场景中的其他对象上。
游戏·3d·unity·c#·游戏引擎·材质
都叫我大帅哥2 小时前
Python的Optional:让你的代码优雅处理“空值”危机
python
曾几何时`4 小时前
基于python和neo4j构建知识图谱医药问答系统
python·知识图谱·neo4j