td_screenshot
Capture a TOP frame as base64 inline or save to disk for visual verification. Without a save path, returns base64 data; set save_path for token-efficient metadata-only response.
Instructions
Capture a TOP frame as base64 inline, or to disk via save_path.
Use this for a quick single-frame visual: with save_path set the image is
written to disk TD-side and only metadata + the path come back — use this for
repeated visual verification. Without it the response embeds base64 image
data; ask the user before repeated base64 screenshots because each image can
consume significant tokens in model context. Prefer td_capture_frame when you
want metadata-first (resolution/format/bytes) with the image behind a
confirm/save_path gate; prefer td_capture_and_analyze when you also need
cooking state and errors folded into the same call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Path to a TOP node to capture as an image (e.g. '/project1/null1', '/project1/render1') | |
| quality | No | JPEG quality from 0.0 (smallest) to 1.0 (best). Default 0.5 gives good diagnostic quality at ~85KB. | |
| save_path | No | Optional disk destination. When set, TouchDesigner writes the image to this path and the tool returns metadata + the saved path with NO base64 payload (near-zero token cost — the cheap visual-verify loop). Accepts an absolute path under your home directory or a bare filename (saved under ~/.tdpilot/captures/). Extension must be .png/.jpg/.jpeg. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |