Preview and review
Both preview tools are read-only, return an MCP image and need no lease. They restore scene state afterward.
Single preview
render_preview writes a PNG to a new workspace path and returns it as an MCP image.
| Parameter | Meaning |
|---|---|
path | New workspace .png path |
resolution | Square size 64–2048, default 512 |
names | Optional meshes to isolate; other renderables are hidden |
direction | Camera direction from the scene center |
color_mode | material or vertex |
renderer | workbench or eevee |
orthographic | Use an orthographic camera |
Workbench checks shape. Eevee checks materials under temporary studio lighting at up to 1024 pixels and requires material colors.
Review sheet
review_sheet renders up to six views into one contact sheet exactly resolution pixels wide.
Views: front, back, left, right, top and persp.
Modes:
| Mode | Purpose |
|---|---|
shaded | Studio shading |
wireframe | Temporary wireframe stand-ins |
uv_checker | UV layout with a generated checker texture |
texel_heatmap | Blue below, green on and red above a target density |
matcap | Material capture lighting |
target_px_per_m and texture_resolution apply only to texel_heatmap. uv_layer applies to texel_heatmap and uv_checker.
Source meshes are bounded to 500,000 triangles. Copy-based modes are bounded to 200,000 triangles.