File Types

From TouchDesigner Documentation
Jump to: navigation, search

TouchDesigner can import and export most common media file formats. Files can be loaded into TouchDesigner by:

  • Drag-and-Drop: Drag a file directly into TouchDesigner and drop it to automatically create an OP or a component.
  • Open With... menu: Right-click on a TouchDesigner supported file in Windows and select Open With...->TouchDesigner 0xx to launch TouchDesigner with the file pre-loaded.
  • Load a file using Operators like Movie File In TOP, File In CHOP, File In SOP, Audio File In CHOP. Files can be loaded from disk or from the web using http://file-url.
  • Start TouchDesigner using the operating system shell command touchdesigner filename.ext, which will start TouchDesigner with your file pre-loaded.

Native TouchDesigner Files[edit]

TouchDesigner has three native files types:

  • .toe: TouchDesigner Environment files are the default file type for creating projects.
  • .tox: TouchDesigner Component files let you save out components. .tox files enable the re-use and portability of component libraries.
  • .tog: TouchDesigner Geometry files are exports of other geometry types in a native TouchDesigner format.

Files Imported[edit]

File Type Supported Extensions Operator Type
Audio .aif .aiff .wav .mp3 .flac .ogg .m4a .avi .flv .m2ts .m4v .mkv .mov .mp4 .mpeg .mpg .mts .wmv .3gp .mxf .ts .r3d Audio File In CHOP, Audio Play CHOP, File In CHOP
Image .tif .tiff .bmp .gif .hdr .jpeg .jpg .pic .png .swf .tga .dds .exr .dpx .ffs Movie File In TOP
Movie .avi .flv .m2ts .m4v .mkv .mov .mp4 .mpeg .mpg .wmv .3gp .mxf .ts .r3d Movie File In TOP
Point Cloud .obj .ply .exr .xyz .pts .csv .txt .fits/.fit(astronomy format) Point File In TOP
Geometry and Scene .usd, .usda, usdc, .usdz .fbx .obj .3ds .dxf .dae .abc USD COMP, FBX COMP, Geometry COMP, File In SOP, Alembic SOP
Channel (Houdini) .bchan .bclip .chan .clip File In CHOP
Geometry (Houdini) .bhclassic .hclassic File In SOP
MIDI .mid .midi MIDI In CHOP
Shader .glsl .frag .vert, geometry shaders Text DAT
Script .bat .cmd .txt Text DAT
Table .dat Table DAT
Font .ttf .otf Text TOP, Text SOP

The Movie File In TOP also supports audio embedded in a movie. Tip: Tie an Audio Movie CHOP to the Movie File In TOP to get the audio, then an Audio Device Out CHOP to play it. An Info CHOP attached to either operator gives extra inside info.

Files Exported[edit]

File Type Supported Extensions Operator Type or Dialog
Audio .aif .aiff .wav Save File on RMB menu
Image .tif .tiff .jpeg .jpg .bmp .exr .png .dds File -> Create Movie, RMB menu
Movie .mov .mp4 Movie File Out TOP, File -> Create Movie
Project .toe File -> Save Env
Component and Scene .tox File -> Save, RMB menu components
Channel .bchan .bclip .chan .clip File Out CHOP, RMB menu
Geometry .tog .bhclassic .fbx RMB menu
Shader .frag .glsl .vert Phong MAT
Script .py .html .md .dat .rtf .tsv .txt .xml RMB menu
Table .dat RMB menu

An Operator Family that contains its own Network inside. There are twelve 3D Object Component and eight 2D Panel Component types. See also Network Path.

TouchDesigner Component file, the file type used to save a Component from TouchDesigner.

Any component can be extended with its own Python classes which contain python functions and data.

Each SOP has a list of Points. Each point has an XYZ 3D position value plus other optional attributes. Each polygon Primitive is defined by a vertex list, which is list of point numbers.

The OpenGL code that creates a rendered image from polygons and textures. Shaders can be made of up to three parts: Vertex Shader, Geometry Shader and/or Pixel Shader, which are either embedded inside Materials, or placed in Text DATs and referenced to a GLSL Material.

A set of commands located in a Text DAT that are triggered to run under certain conditions. There are two scripting languages in TouchDesigner: Python and the original Tscript. Scripts and single-line commands can also be run in the Textport.

An Operator Family that creates, composites and modifies images, and reads/writes images and movies to/from files and the network. TOPs run on the graphics card's GPU.

Any floating window that is not a Pane or Viewer.

TOuch Environment file, the file type used by TouchDesigner to save your project.

A CHOP outputs one or more channels, where a channel is simply a sequence of numbers, representing motion, audio, etc. Channels are passed between CHOPs in TouchDesigner networks. See also Export.

The 3D data held in SOPs and passed for rendering by the Geometry COMP.