blender-context

Blender 编辑器上下文查询

获取当前 Blender 编辑器状态、选中对象、场景信息、文件名、视口相机等。

⚠️ 仅适用于 Blender — 通过 run_python 执行

---

获取选中物体列表

import bpy

selected = bpy.context.selected_objects
active = bpy.context.active_object

print(f"选中物体数量: {len(selected)}")
for obj in selected:
    is_active = " ★" if obj == active else ""
    print(f"  {obj.name} (类型: {obj.type}){is_active}")

if active:
    print(f"\n激活物体: {active.name}")
else:
    print("\n无激活物体")

---

获取场景信息

import bpy

scene = bpy.context.scene
filepath = bpy.data.filepath

print(f"文件路径: {filepath or '(未保存)'}")
print(f"文件名: {bpy.path.basename(filepath) or '(未保存)'}")
print(f"场景名称: {scene.name}")
print(f"物体总数: {len(bpy.data.objects)}")
print(f"网格数量: {len(bpy.data.meshes)}")
print(f"材质数量: {len(bpy.data.materials)}")
print(f"纹理/图像数量: {len(bpy.data.images)}")
print(f"帧范围: {scene.frame_start} - {scene.frame_end}")
print(f"当前帧: {scene.frame_current}")
print(f"FPS: {scene.render.fps}")
print(f"渲染引擎: {scene.render.engine}")
print(f"渲染分辨率: {scene.render.resolution_x} x {scene.render.resolution_y}")

# 按类型统计物体
from collections import Counter
type_counts = Counter(obj.type for obj in bpy.data.objects)
print("\n物体类型统计:")
for obj_type, count in sorted(type_counts.items()):
    print(f"  {obj_type}: {count}")

---

获取激活物体详情

import bpy
import math

active = bpy.context.active_object
if active is None:
    print("⚠️ 没有激活物体")
else:
    loc = active.location
    rot = active.rotation_euler
    scl = active.scale

    print(f"名称: {active.name}")
    print(f"类型: {active.type}")
    print(f"位置: ({loc.x:.3f}, {loc.y:.3f}, {loc.z:.3f})")
    print(f"旋转: ({math.degrees(rot.x):.1f}°, {math.degrees(rot.y):.1f}°, {math.degrees(rot.z):.1f}°)")
    print(f"缩放: ({scl.x:.3f}, {scl.y:.3f}, {scl.z:.3f})")
    print(f"可见: {active.visible_get()}")
    print(f"隐藏: {active.hide_viewport}")

    # 材质信息
    if hasattr(active.data, 'materials') and active.data is not None:
        mats = active.data.materials
        print(f"\n材质 ({len(mats)} 个):")
        for i, mat in enumerate(mats):
            if mat:
                print(f"  [{i}] {mat.name}")
            else:
                print(f"  [{i}] (空槽位)")

    # 修改器信息
    if hasattr(active, 'modifiers'):
        mods = active.modifiers
        if mods:
            print(f"\n修改器 ({len(mods)} 个):")
            for mod in mods:
                print(f"  {mod.name} (类型: {mod.type})")

    # 约束信息
    if hasattr(active, 'constraints'):
        cons = active.constraints
        if cons:
            print(f"\n约束 ({len(cons)} 个):")
            for con in cons:
                print(f"  {con.name} (类型: {con.type})")

    # 网格数据（如果是 MESH 类型）
    if active.type == 'MESH' and active.data:
        mesh = active.data
        print(f"\n网格数据:")
        print(f"  顶点数: {len(mesh.vertices)}")
        print(f"  边数: {len(mesh.edges)}")
        print(f"  面数: {len(mesh.polygons)}")
        print(f"  UV 层: {len(mesh.uv_layers)}")