TD Sample (live)
td_sampleSample a single value from a CHOP channel or TOP pixel in a running TouchDesigner instance to verify concrete output values without rendering a full frame.
Instructions
Sample a single value from an operator in a running TouchDesigner instance (live control via the td_mcp bridge). kind='chop_channel' reads a CHOP channel via CHOP.chan(name); kind='top_pixel' reads a pixel via TOP.sample(u, v). Use this to verify concrete output values without rendering a full frame.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>",
"kind": "<kind>"
},
"name": "td_sample"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| u | No | For kind='top_pixel': horizontal sample coordinate (0..1 normalized, or a pixel index). | |
| v | No | For kind='top_pixel': vertical sample coordinate (0..1 normalized, or a pixel index). | |
| kind | Yes | What to sample: 'chop_channel' (CHOP.chan) or 'top_pixel' (TOP.sample). | |
| path | Yes | Full path of the operator to sample, e.g. '/td_mcp/sandbox/noise1'. | |
| channel | No | For kind='chop_channel': the channel name to read (e.g. 'chan1'). Required for CHOPs. |