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
.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 - Clicking this opens a text editor to add/edit/delete text from the DAT.
file - The filesystem path and name of the file to load. Accepts
Load on Start
loadonstart - When On, reloads the file from disk into the DAT when the projects starts.
Sync to File
syncfile - When On, loads the file from disk into the DAT when the projects starts. A filename must be specified. Turning on the option will load the file from disk immediately. If the file does not exist, it will be created the first time the DAT is updated. The file is monitored so that any changes made to the file will update the DAT, and any changes made to the DAT will be written to the file right away. If the file is removed, the DAT will retain its current contents.
loadonstartpulse - Instantly reloads the file.
Write on Toe Save
write - When On, writes the contents of the DAT out to the file on disk when the project is saved.
writepulse - Instantly write the file to disk.
Remove Blank Lines
removeblank - When enabled, do not convert blank lines into empty rows when loading files.
dims - When enabled, lets you define the exact number of rows and columns of the Table DAT via the
/cols parameter. When you enable this, it will not destroy any existing rows or columns.
rows - Defines the number of rows in the table.
cols - Defines the number of columns in the table.
Parameters - Common Page
language - ⊞ - Select how the DAT decides which script language to operate on.
input- The DAT uses the inputs script language.
node- The DAT uses it's own script language.
extension - ⊞ - Select the file extension this DAT should expose to external editors.
dat- various common file extensions.
- From Language
language- pick extension from DATs script language.
- Custom Extension
custom- Specify a custom extension.
customext - Specifiy the custom extension.
wordwrap - ⊞ - Enable Word Wrap for Node Display.
input- The DAT uses the inputs setting.
on- Turn on Word Wrap.
off- Turn off Word Wrap.
|• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •|
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.