capture_screenshot
Capture a Houdini viewport or pane tab image to disk, with an optional settle delay so Karma renders converge before the screenshot is saved.
Instructions
Capture a screenshot of the viewport or a specific pane tab.
The image is written to disk only; open output_path with your file
reader to look at it. Prefer get_geometry_info, get_node_info or
get_scene_summary unless visual confirmation is genuinely needed.
The frame is the viewport's own size and view. For a set size,
render_viewport(resolution=...); to frame one object first,
frame_all(node_paths=...), and for frames of one scale across a
comparison sheet, frame_all(bounds=...) with the same box before each
capture.
A Scene Viewer capture names the network it shows (viewer_network);
viewer_note says when that is a DOP network, drawn as the simulation's
objects rather than the SOP display, or a SOP subnet, drawn as its own
display node rather than the object's output; visible_objects_note,
when the viewport's Visible Objects pattern leaves out the object the
viewer is in, so the frame shows none of it.
Args: output_path: Image file path; variables ($JOB) are expanded. Default: a new PNG in the temp dir. pane_name: Pane tab name. settle_seconds: Wait this long before capturing, without blocking Houdini, so a Karma viewport can converge after a change. Use this instead of a shell sleep between calls. Capped at 120.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "capture_screenshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pane_name | No | ||
| output_path | No | ||
| settle_seconds | No |