td_find_empty_space
Find an empty position for a new operator in a TouchDesigner network, returning coordinates for placement without overlapping existing nodes.
Instructions
Find an empty (non-overlapping) position for a new operator in the network editor.
Returns nodeX, nodeY coordinates that can be passed directly to td_create_op.
Args: parent: Parent path to search in (e.g. "/project1") width: Estimated width of the new operator (default 200) height: Estimated height of the new operator (default 200) direction: Placement strategy — "right" (next to rightmost op), "below" (under bottommost op), or "grid" (find first free slot in grid scan) padding: Minimum gap between operators (default 50)
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": {
"parent": "<parent>"
},
"name": "td_find_empty_space"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| width | No | ||
| height | No | ||
| parent | Yes | ||
| padding | No | ||
| direction | No | right |