Python in TD

Python in TouchDesigner

TouchDesigner integrates Python 3 deeply into its core. You can use Python to control parameters, manage logic, and build custom tools.

The ‘op’ Object

op('/project1/geo1') - This is how you reference any operator in your network.

The ‘me’ Object

me - Refers to the operator where the script is currently running. Very useful for relative references.

Expressions in Parameters

Instead of a static number, you can click the parameter name and type:

• me.time.frame (Current frame number)
• absTime.seconds (Time since the application started)
• op('null1')['chan1'] (The value of ‘chan1’ in the operator ‘null1’)

Parameter Binding

Binding creates a bi-directional property link:

• Python Expression: Click a parameter, change mode to ‘Bind’ (purple), and type: op('someComp').par.CustomParameter
• UI Element to Parameter: A critical use case is assigning an interactive UI slider’s component parameter directly to a target parameter using the .bindMaster attribute.

Common Tasks

• Driving Parameters: Drag a CHOP channel onto a parameter and select “CHOP Reference”.
• Accessing Tables: op('table1')[row, col]

---

(y) Return to Scripting & Architecture | (y) Return to TouchDesigner | (y) Return to Home