render_preview
Render a preview image of Blender objects to inspect shape, proportions, normals, and materials. Auto-frames objects, creates a camera, renders with EEVEE, and returns the image path.
Instructions
Render a preview image and return its absolute path.
THEN OPEN THAT IMAGE AND LOOK AT IT. Read the returned image_path with
your file reading tool, or call read_preview_image. Geometry statistics
cannot tell you whether an asset has the right shape, sensible proportions,
correct normals or a material that reads properly -- only the picture can.
Auto-frames the given objects, creates an AI_PreviewCam if the scene has no camera, renders with EEVEE at 512x512 by default, and restores the scene's render settings afterwards. Images land in workspace/previews.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Square resolution. 512 is the fast default; go to 1024 only for a final check. | |
| label | No | Short label used in the filename, e.g. 'crate_v2' | |
| camera | No | Render from this camera instead of the active one | |
| engine | No | ||
| margin | No | ||
| objects | No | Objects to frame automatically. Omit and set frame_all=true to fit everything visible. | |
| samples | No | More samples means less noise and a slower render | |
| filename | No | Exact filename stem; overrides label | |
| direction | No | Viewing angle when auto-framing | |
| frame_all | No | Frame every visible object when `objects` is omitted | |
| transparent | No | Transparent background | |
| resolution_x | No | ||
| resolution_y | No | ||
| restore_camera | No | Put an existing camera back where it was after framing. A camera the bridge created stays put. | |
| view_transform | No | Colour management for this render. 'Standard' (the default here) shows the colours the materials actually specify; Blender's usual 'AgX' desaturates heavily and makes materials hard to judge. The scene's own setting is restored afterwards. | Standard |