Table DAT
Summary[edit]
The Table DAT lets you hand-edit or create a table of rows and columns of cells, each cell containing a text string. A "table" is one of the two forms of DATs (the other being simply lines of "free-form" text via the Text DAT).
In the Table DAT's viewer you can add rows and columns and type text into any cell of its node viewer. When a Table DAT has its Viewer Active on, right-mouse click on a cell to modify the table's structure, use the <Tab> key to jump to the next cell, and the up/down arrow keys to navigate to adjacent cells.
You can also put strings into table cells using something like op('table1')[2,'select'] = 'yes', or append rows using .appendRow() in python. See also the Script DAT and its Snippets.
The Table DAT can also can load a table from a .txt or .dat file on disk or on the web. Use http:// when specifying a table on the internet. The text will be converted into tab-delimited tables.
Parameters - Table Page
Edit.. edit - Clicking this opens a text editor to add/edit/delete text from the DAT.
File file - The filesystem path and name of the file to load. Accepts .txt and .dat files.
Load on Start loadonstart - When set to 1, reloads the file from disk into the DAT when the projects starts. Pulse to reload instantly.
Load File loadonstartpulse -
Write on Toe Save write - When set to 1, writes the contents of the DAT out to the file on disk when the project is saved. Pulse to save instantly.
Write File writepulse -
Remove Blank Lines removeblank - When enabled, do not convert blank lines into empty rows when loading files.
Exact Dimensions dims - When enabled, lets you define the exact number of rows and columns of the Table DAT via the /rows and /cols parameter. When you enable this, it will not destroy any existing rows or columns.
Rows rows - Defines the number of rows in the table.
Columns cols - Defines the number of columns in the table.
Parameters - Common Page
Language language - ⊞ - Select how the DAT decides which script language to operate on.
- Input
input- The DAT uses the inputs script language.
- Node
node- The DAT uses it's own script language.
Edit/View Extension extension - ⊞ - Select the file extension this DAT should expose to external editors.
- dat
dat- various common file extensions.
- From Language
language- pick extension from DATs script language.
- Custom Extension
custom- Specify a custom extension.
Custom Extension customext - Specifiy the custom extension.
Word Wrap wordwrap - ⊞ - Enable Word Wrap for Node Display.
- Input
input- The DAT uses the inputs setting.
- On
on- Turn on Word Wrap.
- Off
off- Turn off Word Wrap.
TouchDesigner Build:
| DATs |
|---|
| • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • |
A form of DATs (Data Operators) that is structured as rows and columns of text strings.
OP Snippets is a set of numerous examples of TouchDesigner operators, which you access via the Help menu. These can be copied/pasted into your projects.
An Operator Family that manipulates text strings: multi-line text or tables. Multi-line text is often a command Script, but can be any multi-line text. Tables are rows and columns of cells, each containing a text string.
To pulse a parameter is to send it a signal from a CHOP or python or a mouse click that causes a new action to occur immediately. A pulse via python is via the .pulse() function on a pulse-type parameter, such as Reset in a Speed CHOP. A pulse from a CHOP is typically a 0 to 1 to 0 signal in a channel.
