blender-viewport-capture

Blender 视口截图

捕获 Blender 3D 视口画面，用于 AI 视觉分析（构图、光照、场景检查等）。

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

核心方法

方法 1：OpenGL 渲染截图（推荐）

使用 bpy.ops.render.opengl() 进行视口 OpenGL 渲染，捕获当前 3D 视口画面。

import bpy
import os
import tempfile

# 保存原始设置
scene = bpy.context.scene
original_path = scene.render.filepath
original_format = scene.render.image_settings.file_format
original_quality = scene.render.image_settings.quality

# 设置输出
output_dir = os.path.join(tempfile.gettempdir(), "artclaw_captures")
os.makedirs(output_dir, exist_ok=True)

import time
timestamp = int(time.time())
output_path = os.path.join(output_dir, f"viewport_{timestamp}.png")

scene.render.filepath = output_path
scene.render.image_settings.file_format = 'PNG'
scene.render.image_settings.quality = 90

# 执行 OpenGL 渲染（视口截图）
bpy.ops.render.opengl(write_still=True)

# 恢复原始设置
scene.render.filepath = original_path
scene.render.image_settings.file_format = original_format
scene.render.image_settings.quality = original_quality

print(f"✅ 视口截图已保存: {output_path}")

方法 2：带自定义分辨率的截图

import bpy
import os
import tempfile
import time

scene = bpy.context.scene

# 保存原始设置
original_path = scene.render.filepath
original_format = scene.render.image_settings.file_format
original_quality = scene.render.image_settings.quality
original_res_x = scene.render.resolution_x
original_res_y = scene.render.resolution_y
original_pct = scene.render.resolution_percentage

# 设置截图分辨率
scene.render.resolution_x = 1920
scene.render.resolution_y = 1080
scene.render.resolution_percentage = 100

# 设置输出路径
output_dir = os.path.join(tempfile.gettempdir(), "artclaw_captures")
os.makedirs(output_dir, exist_ok=True)
timestamp = int(time.time())
output_path = os.path.join(output_dir, f"viewport_{timestamp}.jpg")

scene.render.filepath = output_path
scene.render.image_settings.file_format = 'JPEG'
scene.render.image_settings.quality = 85

# 执行截图
bpy.ops.render.opengl(write_still=True)

# 恢复所有原始设置
scene.render.filepath = original_path
scene.render.image_settings.file_format = original_format
scene.render.image_settings.quality = original_quality
scene.render.resolution_x = original_res_x
scene.render.resolution_y = original_res_y
scene.render.resolution_percentage = original_pct

print(f"✅ 视口截图已保存: {output_path}")