Get node flags & wiring (why-is-it-black inspector)
get_td_node_flagsRead-only
Identify operator flags and input wiring that cause blank or black outputs in TouchDesigner. Scan a node or subtree with optional problem filtering.
Instructions
Read-only: report each node's operator flags (bypass / render / display / lock / allowCooking / clone) plus index-aware input wiring, network position, color and comment — the signals that explain a black/blank output that a parameter dump hides. Scan one node or a subtree (recursive); set only_problems to surface just the ops whose flags or cook errors would suppress output. Returns structuredContent for code to process.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Full path of the node to inspect, or the COMP whose children to scan when recursive is set. | |
| recursive | No | Also scan the immediate children (depth 1) of path. Use this on a container to diagnose its whole network in one round-trip. | |
| only_problems | No | Return only nodes whose flags or cook errors would suppress output: bypass on, allowCooking off, or a cook error present. Conservative — display/render are reported but never used to filter (they default off on many visible ops). | |
| max_nodes | No | Cap the number of nodes scanned during a recursive subtree walk. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| scanned | Yes | ||
| nodes | Yes | ||
| probe | No | ||
| warnings | Yes |