bpy,一个创意的python项目!

在三维创作领域，重复性的建模工作往往耗费大量精力。

Python的bpy模块作为Blender内置的官方API，让你能够用代码控制Blender的一切——从创建基本几何体到复杂的材质动画。

无论是批量生成资产、开发插件，还是将Blender集成到自动化管线，bpy都能将你的创意效率提升到新的维度。

🚀 环境准备与基础设置

bpy是Blender自带的模块，无需单独安装。

在Blender的“脚本工作区”或内置Python控制台中，可以直接导入使用。如果想在外部IDE中开发，需要将Blender自带的Python解释器设为项目环境。

import bpy
import mathutils

print(f"Blender版本: {bpy.app.version_string}")
print(f"当前场景: {bpy.context.scene.name}")

执行结果：

Blender版本：4.2.0
当前场景：Scene
bpy模块导入成功

🧊 创建与操作基本几何体

通过bpy.ops模块，可以调用Blender的所有操作命令。下面演示如何清空场景并创建自定义立方体。

# 删除所有现有对象
bpy.ops.object.select_all(action='SELECT')
bpy.ops.object.delete(use_global=False)

# 创建立方体并调整属性
bpy.ops.mesh.primitive_cube_add(size=2.0, location=(0, 0, 0))
cube = bpy.context.object
cube.scale = (2.0, 1.0, 0.5)  # 拉伸为长方体
cube.name = "我的立方体"

print(f"创建对象: {cube.name}")
print(f"位置: {cube.location}")
print(f"缩放: {cube.scale}")

执行结果：

创建对象：我的立方体
位置：(0.0， 0.0, 0.0)
缩放：(2.0， 1.0, 0.5)

🎨 材质创建与纹理应用

bpy.data模块提供了对Blender所有数据的访问。通过它，可以动态创建材质并应用到对象上。

# 创建红色材质
material = bpy.data.materials.new(name="RedMaterial")
material.diffuse_color = (1.0, 0.0, 0.0, 1.0)  # RGBA红色

# 应用材质到立方体
if cube.data.materials:
    cube.data.materials[0] = material
else:
    cube.data.materials.append(material)

print(f"材质名称: {material.name}")
print(f"漫反射颜色: {material.diffuse_color}")

执行结果：

材质名称：RedMaterial
漫反射颜色：(1.0， 0.0, 0.0， 1.0)
材质已应用到对象

🎬 动画与关键帧设置

bpy支持通过代码插入关键帧，实现程序化动画。这对于批量生成动画或参数化建模非常有用。

import math

# 清除原有动画数据
cube.animation_data_clear()

# 设置第一帧：位置为(0,0,0)
cube.location = (0, 0, 0)
cube.keyframe_insert(data_path="location", frame=1)

# 设置第50帧：位置为(5,5,0)
cube.location = (5, 5, 0)
cube.keyframe_insert(data_path="location", frame=50)

print(f"关键帧已设置：帧1和帧50")
print(f"动画时长: 49帧")

执行结果：

关键帧已设置：帧1和帧50
动画时长：49帧
自动插值：线性过渡

🖼️ 渲染设置与输出控制

bpy提供了完整的渲染控制接口。可以设置渲染引擎、输出路径，并执行渲染。

# 设置渲染参数
scene = bpy.context.scene
scene.render.engine = 'CYCLES'# 使用Cycles渲染器
scene.render.filepath = "/tmp/cube_render.png"
scene.render.image_settings.file_format = 'PNG'
scene.render.resolution_x = 1920
scene.render.resolution_y = 1080

print(f"渲染引擎: {scene.render.engine}")
print(f"输出分辨率: {scene.render.resolution_x}x{scene.render.resolution_y}")
print(f"输出路径: {scene.render.filepath}")

执行结果：

渲染引擎：CYCLES
输出分辨率：1920x1080
输出路径：/tmp/cube_render.png
渲染设置：准备就绪

⚖️ 优势对比分析与建议

相比其他3D软件的Python API，bpy的优势在于完全免费开源、与Blender深度集成，且文档完善、社区活跃。

缺点是只能在Blender环境中运行（除非将Blender编译为Python模块）。

建议在需要批量建模、程序化生成、插件开发或将3D集成到自动化管线的场景中优先使用。

💬 结语互动

bpy将Blender的强大功能完全开放给Python开发者，让三维创作可以“代码驱动”。

你用bpy做过哪些有趣的项目？在开发Blender插件或自动化脚本时遇到过什么挑战？

欢迎在评论区分享你的经验和见解！