Caption a TOP (is the output alive?)
caption_topRender a preview of a TouchDesigner operator and generate a plain-text caption with color stats to verify the network is rendering correctly, using vision or histogram analysis.
Instructions
Read-only: render a TOP's preview and return a plain-text description of it — the headless 'is the output alive?' primitive. Two paths: (a) a configured vision LLM endpoint when available, (b) a DETERMINISTIC luma/colour-histogram fallback decoded from the preview PNG pixels (always works, no model needed). Reports dominant colours, mean luma, near-black fraction, a coarse classification ('black'/'very dark'/'dark'/'bright'/'colorful'/'mid'), and a friendly caption. Returns {node_path, width, height, source:'vision'|'histogram', caption, stats{...}, warnings}. Use it after a build to confirm the network is actually rendering instead of a black frame. The vision path is currently inert (no vision field on the tool context) and falls back to the histogram.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node_path | Yes | Path of the TOP to caption. | |
| width | No | Width to render the preview at before describing it. Smaller is faster. | |
| height | No | Height to render the preview at before describing it. Smaller is faster. | |
| use_vision | No | Use the configured vision LLM endpoint when available; else fall back to a deterministic histogram description. |