Experimental:Python Classes and Modules
The following list of important Python classes and modules is roughly grouped together by subject.
Python Reference has an alphabetical list of all TouchDesigner Python pages on this wiki.
Operator Related Classes
The following classes are Python interfaces for operators and objects that operators use. Individual operator classes (e.g. TextTOP Class and RampTOP Class) are not listed but do exist in the td
module, and links to each can be found here or by clicking on the Python Help button in their parameter dialog. These classes are found in the td module so do not need to be imported.
- OP Class - a TouchDesigner operator.
- Connector Class - a wire connector for an OP. Lists of these can be found in
OP.inputConnectors
andOP.outputConnectors
. Components also haveCOMP.inputCOMPConnectors
andCOMP.outputCOMPConnectors
. - Page Class - a parameter page. Lists of these can be found in
OP.pages
and, on components and script operators,OP.customPages
. - ParCollection Class (
OP.par
) - holds all the parameters for an OP. - ParGroupCollection Class (
OP.par
) - holds all the parameter groups for an OP.- ParGroup Class - an individual parameter group.
- ParGroupPulse Class - an individual parameter group with a pulse par.
- ParGroupUnit Class - an individual parameter group with a unit par.
- ParGroup Class - an individual parameter group.
- SequenceCollection Class (
OP.seq
) - holds all the sequences for an OP.- Sequence Class - describes and controls a set of sequential parameters. Sequential parameters will have a reference to one of these objects in their
sequence
member.- SequenceBlock Class - used to access the parGroups of a specific block (set of parGroups) in a sequence.
- Sequence Class - describes and controls a set of sequential parameters. Sequential parameters will have a reference to one of these objects in their
- CHOP Class - subclass of OPs defining CHOP operators.
- Channel Class - a channel object. Accessed through a CHOP index or other CHOP members such as
chan
,chans
etc. - Segment Class - describes a single segment from a Timer CHOP.
- Channel Class - a channel object. Accessed through a CHOP index or other CHOP members such as
- COMP Class - a subclass of OPs defining component operators.
- ObjectCOMP Class - a subclass of COMPs defining Objects, used to create and render 3D scenes.
- PanelCOMP Class - a subclass of COMPS defining Panel Components, used to create 2D UI elements.
- Panel Class - a member of panelCOMPs containing all associated panel values. Accessed through
panelCOMP.panel
.- PanelValue Class - individual panel values. Accessed through the
panel
member of panelCOMPS and also in callbacks in the Panel Execute DAT.
- PanelValue Class - individual panel values. Accessed through the
- ListAttributes Class - a collection of list attributes used in a ListCOMP.
- ListAttribute Class - contains attributes defining a cell in a ListCOMP.
- Actors Class - describes the set of all Actor COMPs used by the Bullet Solver COMP and Nvidia Flex Solver COMP. used in a BulletsolverCOMP or flexsolverCOMP.
- Bodies Class - a collection of bodies used in an ActorCOMP.
- Body Class - a single body (physics object) used in an ActorCOMP.
- Panel Class - a member of panelCOMPs containing all associated panel values. Accessed through
- VFS Class - a COMP's Virtual File System
- VFSFile Class - a virtual file contained within a Virtual File System.
- DAT Class - a subclass of OPs defining DAT operators.
- Cell Class - defines an individual cell of a DAT table.
- Peer Class - describes the network connection originating a message in the callback functions found in oscinDAT, tcpipDAT, udpinDAT, udtinDAT.
- MAT Class - a subclass of OPs defining MAT operators.
- SOP Class - a subclass of OPs defining SOP operators.
- Attributes Class - a collection of SOP attributes
- Attribute Class - information about an entity such as its color, velocity, normal, and so on.
- AttributeData Class - contains specific geometric Attribute values, associated with a Prim Class, Point Class, or Vertex Class.
- Attribute Class - information about an entity such as its color, velocity, normal, and so on.
- Group Class - describes groups lists of Prim Class or Point Class.
- Points Class - a collection of points.
- Point Class - a single geometry point.
- InputPoint Class - a special point object used in Point SOP parameters.
- Point Class - a single geometry point.
- Prims Class - a collection of primitives.
- Prim Class - a single geometry primitive.
- Poly Class - a subclass of Prim defining a geometry polygon.
- Mesh Class - a subclass of Prim defining a geometry mesh.
- Bezier Class - a subclass of Prim defining a set of Bezier curves.
- Vertex Class - a member of Prim defining a single geometry vertex.
- Prim Class - a single geometry primitive.
- Attributes Class - a collection of SOP attributes
- TOP Class - a subclass of OPs defining TOP operators.
- CUDAMemory Class - holds a reference to CUDA memory.
- CUDAMemoryShape Class - describes the shape of a CUDA memory segment.
- TextLine Class - a line of text in the Text TOP or Text SOP, after it has been formatted. Contains various members about the line such as it's text, position etc.
- CUDAMemory Class - holds a reference to CUDA memory.
- Connector Class - a wire connector for an OP. Lists of these can be found in
Helper Classes
The following helper objects are part of the td module and can thus be accessed anywhere, including expressions, without imports (e.g. absTime.frame
).
- AbsTime Class (
absTime
) - information about absolute time - App Class (
app
) - information about the TouchDesigner app, including version, installation folders, etc. - Project Class (
project
) - information about the current TouchDesigner session - TDU Class (
tdu
) - generic utilities for TouchDesigner not relating directly to TD objects.- ArcBall Class (
tdu.ArcBall
) - encapsulates many aspects of 3D viewer interaction. - Camera Class (
tdu.Camera
) - maintains a 3D position and orientation for a camera and provides multiple methods for manipulating the camera's position and direction. - Color Class (
tdu.Color
) - holds a 4 component color - Dependency Class (
tdu.Dependency
) - used to create Dependable Python data. - Matrix Class (
tdu.Matrix
) - holds a single 4x4 matrix for use in transformations. See ObjectCOMP Class for transforms of 3D objects. - Position Class (
tdu.Position
) - holds a 3 component position - Quaternion Class (
tdu.Quaternion
) - holds a quaternion object for 3D rotations - Timecode Class (
tdu.Timecode
) - holds a timecode value - Vector Class (
tdu.Vector
) - holds a 3 component vector
- ArcBall Class (
- Licenses Class (
licenses
) - information about installed license objects- DongleList Class (
licenses.dongles
) - list of attached dongles- Dongle Class - an individual dongle connected to the system
- License Class - a single instance of an installed license
- ProductEntry Class - a dongle entry for a single dongle connected to the system
- DongleList Class (
- MOD Class (
mod
) - access to modules located in TouchDesigner DATs - Monitors Class (
monitors
) - access to information about all connected display devices- Monitor Class - an individual display device
- Runs Class (
runs
) - information about all delayed run objects- Run Class - an individual delayed run object
- SysInfo Class (
sysInfo
) - current system/hardware information - UI Class (
ui
) - information about application ui elements- Colors Class (
ui.colors
) - application colors - Options Class (
ui.options
) - configurable ui options - Panes Class (
ui.panes
) - collection of all panes open in the editor- Pane Class - an individual pane object
- NetworkEditor Class - subclass of Pane that displays a network editor
- Pane Class - an individual pane object
- Preferences Class (
ui.preferences
) - collection of TouchDesigner preferences - Undo Class (
ui.undo
) - tools for interacting with the undo system, including creating script-based undo steps
- Colors Class (
Standard Python Modules
The td
module also automatically imports a number of helpful standard modules, allowing them to be accessed in expressions through their namespace (e.g. math.cos(math.pi)
):
collections
- container datatypesenum
- support for enumerationsinspect
- inspect live objectsmath
- mathematical functionsre
- regular expression operationssys
- OS specific data and functionstraceback
- stack utilitieswarnings
- warning control
TouchDesigner Utility Modules and Python Utilities
The following contain extended Python utilities for use with TouchDesigner.
- TDFunctions - A variety of utilities for advanced Python coding in TouchDesigner.
- TDJSON - JSON utilities specific to TouchDesigner.
- TDStoreTools - utilities for use with TouchDesigner's Storage and Dependency system.
- TDResources (
op.TDResources...
) - not a module, but does contain system resources that can be accessed via Python. It includes system pop-up menu, button pop-up menu, pop-up dialog, and mouse resources.
3rd Party Packages
The following 3rd party packages are automatically installed with TouchDesigner. They are not in the td module, so must be imported explicitly to be used in scripts. The name in parentheses is the actual package name used (e.g. to use OpenCV, write this at top of script: import cv2
). For information on adding or installing other Python modules, see Importing Modules.
- asn1crypto (
asn1crypto
) - Parsing and serializing ASN.1 structures. - attrs (
attr
) - Classes without boilerplate. - Certifi (
certifi
) - Root Certificates for validating the trustworthiness of SSL certificates while verifying the identity of TLS hosts. - CFFI (
cffi
) - Interaction with C code. - Chardet (
chardet
) - The Universal Character Encoding Detector. - charset-normalizer (
charset_normalizer
) - A library that helps you read text from an unknown charset encoding. - Cryptography (
cryptography
) - High level recipes and low level interfaces to common cryptographic algorithms. - decorator (
decorator
) - Define signature-preserving function decorators and decorator factories. - OAuthlib (
oauthlib
) - Library to build OAuth and OpenID Connect servers. - opencv-python (
cv2
) - Pre-built CPU-only OpenCV packages for Python. - depthai (
depthai
) - Python bindings for C++ depthai-core library. - idna (
idna
) - Support for the Internationalised Domain Names in Applications (IDNA) protocol. - jsonpath (
jsonpath_ng
) - JSONPath tools for accessing and altering JSON structures. - jsonschema (
jsonschema
) - jsonschema is an implementation of the JSON Schema specification for Python. - MWParserFromHell (
mwparserfromhell
) - An easy-to-use and outrageously powerful parser for MediaWiki wikicode. - NumPy (
numpy
) - Fundamental package for scientific computing with Python. - OpenCV (
cv2
) - Open source computer vision. - packaging (
packaging
) - Package tools including version handling, specifiers, markers, requirements, tags, utilities. Used for version string comparison. - pip (
pip
) - pip is the package installer for Python. You can use pip to install packages from the Python Package Index and other indexes. - ply (
ply
) - Parsing tools for lex and yacc. - Pygments (
pygments
) - A syntax highlighting package written in Python. - pyparsing (
pyparsing
) - A library of classes that client code uses to construct parsing grammar directly in Python code. - pyrankvote (
pyrankvote
) - PyRankVote is a python library for different ranked-choice voting systems (sometimes called preferential voting systems) created by Jon Tingvold in June 2019. - pyrsistent (
pyrsistent
) - Pyrsistent is a number of persistent collections (by some referred to as functional data structures). Persistent in the sense that they are immutable. - PyYAML (
yaml
) - YAML parser and emitter. - Requests (
requests
) - The only Non-GMO HTTP library for Python, safe for human consumption - Requests OAuthlib (
requests_oauthlib
) - Easy-to-use Python interface for building OAuth1 and OAuth2 clients - six (
six
) - Python 2 and 3 compatibility utilities. - smartypants (
smartypants
) - a Python fork of SmartyPants. - tabulate (
tabulate
) - Pretty-print tabular data in Python. - urllib3 (
urllib3
) - HTTP client. - whats-that-code (
whats_that_code
) - programming language detection library.
Installing Custom Packages and Modules
You can also install your own Python packages that are not included with TouchDesigner. For instructions, go here.