td_set_params
DestructiveIdempotent
Set static or live expression values on TouchDesigner node parameters. Supports static values, reactive expressions, resets, and explicit modes.
Instructions
Set node parameters (static values or live expressions).
Parameter-semantics checks are advisory here by default (param_semantics_policy= 'warn'): findings are attached but the write proceeds, since some out-of-range values are legitimate in TD (e.g. extending a soft UI range). Use param_semantics_policy='block', or the brain/transaction path which gates automatically, when you want invalid bindings to stop the write.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Absolute node path | |
| params | Yes | Dictionary of parameter names to values. Supports five modes: • Static value (plain): {'seed': 42, 'colorr': 1.0} • Expression (reactive, updates every frame): {'seed': {'expr': 'absTime.seconds * 10'}, 'tx': {'expr': "op('noise1')['chan1']"}} • Explicit static: {'seed': {'val': 42}} • Reset to default: {'seed': {'reset': true}} — resets value and clears expression • Clear expression: {'seed': {'mode': 'constant', 'val': 42}} — force constant mode Expressions make networks ALIVE — use them for anything that should move, react, or change over time. | |
| include_hints | No | If True, attach a ``hints`` block via td_get_hints. Auto-injection still fires when the params dict assigns a string to a reference-style parameter (instanceop/material/camera/lights/geometry/top/chop/sop/dat/comp). | |
| param_semantics_policy | No | Docs-grounded parameter safety policy for direct writes. 'warn' (default) preserves normal direct-tool behavior with attached findings — the write PROCEEDS even on invalid enum / out-of-range / bad op-reference; 'block' refuses the write before mutation when parameter semantics find invalid, unknown, or high-risk bindings. NOTE: this direct path is advisory by default. The brain/transaction path (td_brain_plan → td_brain_execute) HARD-FAILS the same contract violations. Pass 'block' here for equivalent strictness on direct writes. | warn |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |