Difference between revisions of "Table DAT"

From TouchDesigner Documentation
Jump to: navigation, search
 
Line 48: Line 48:
 
|opType=table
 
|opType=table
 
|parOrder=2
 
|parOrder=2
 +
|parType=
 +
|parReadOnly=
 +
|parItems=
 +
}}
 +
        {{Parameter|parLabel=Sync to File
 +
|opFamily=DAT
 +
|parName=syncfile
 +
|parSummary=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.
 +
|opType=text
 +
|parOrder=3
 
|parType=
 
|parType=
 
|parReadOnly=
 
|parReadOnly=
Line 57: Line 67:
 
|parSummary=Instantly reloads the file.   
 
|parSummary=Instantly reloads the file.   
 
|opType=table
 
|opType=table
|parOrder=3
+
|parOrder=4
 
|parType=
 
|parType=
 
|parReadOnly=
 
|parReadOnly=
Line 67: Line 77:
 
|parSummary=When On, writes the contents of the DAT out to the file on disk when the project is saved.
 
|parSummary=When On, writes the contents of the DAT out to the file on disk when the project is saved.
 
|opType=table
 
|opType=table
|parOrder=4
+
|parOrder=5
 
|parType=
 
|parType=
 
|parReadOnly=
 
|parReadOnly=
Line 77: Line 87:
 
|parSummary=Instantly write the file to disk.   
 
|parSummary=Instantly write the file to disk.   
 
|opType=table
 
|opType=table
|parOrder=5
+
|parOrder=6
 
|parType=
 
|parType=
 
|parReadOnly=
 
|parReadOnly=
Line 87: Line 97:
 
|parSummary=When enabled, do not convert blank lines into empty rows when loading files.
 
|parSummary=When enabled, do not convert blank lines into empty rows when loading files.
 
|opType=table
 
|opType=table
|parOrder=6
+
|parOrder=7
 
|parType=
 
|parType=
 
|parReadOnly=
 
|parReadOnly=
Line 97: Line 107:
 
|parSummary=When enabled, lets you define the exact number of rows and columns of the Table DAT via the <code>/rows</code> and <code>/cols</code> parameter. When you enable this, it will not destroy any existing rows or columns.
 
|parSummary=When enabled, lets you define the exact number of rows and columns of the Table DAT via the <code>/rows</code> and <code>/cols</code> parameter. When you enable this, it will not destroy any existing rows or columns.
 
|opType=table
 
|opType=table
|parOrder=7
+
|parOrder=8
 
|parType=
 
|parType=
 
|parReadOnly=
 
|parReadOnly=
Line 107: Line 117:
 
|parSummary=Defines the number of rows in the table.
 
|parSummary=Defines the number of rows in the table.
 
|opType=table
 
|opType=table
|parOrder=8
+
|parOrder=9
 
|parType=
 
|parType=
 
|parReadOnly=
 
|parReadOnly=
Line 117: Line 127:
 
|parSummary=Defines the number of columns in the table.
 
|parSummary=Defines the number of columns in the table.
 
|opType=table
 
|opType=table
|parOrder=9
+
|parOrder=10
 
|parType=
 
|parType=
 
|parReadOnly=
 
|parReadOnly=

Latest revision as of 15:37, 23 October 2020


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.

PythonIcon.pngtableDAT_Class


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 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.  

Load File 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.  

Write File writepulse - Instantly write the file to disk.  

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
Art-Net • CHOP Execute • CHOP to • Clip • Convert • CPlusPlus • DAT •  Execute • DAT xport • Error • EtherDream • Evaluate • Examine • Execute • FIFO • File In • File Out • Folder • In • Indices • Info • Insert • Experimental:JSON • Keyboard In • Lookup • Merge • MIDI Event • MIDI In • Monitors • MQTT Client • Multi Touch In • NDI • Null • OP Execute • OP Find • OSC In • OSC Out • Out • Panel Execute • Parameter • Parameter Execute • Perform • Render Pick • Reorder • Script • Select • Serial • SocketIO • SOP to • Sort • Substitute • Switch • Table • TCP/IP • Text • Touch In • Touch Out • Transpose • TUIO In • UDP In • UDP Out • UDT In • UDT Out • Web Client • Web • Web Server • Experimental:Web Server • WebSocket • XML

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.

The generic thing that holds an Operator, and includes Flags (display, bypass, lock, render, immune) and its position/size in the network. Whether you "lay down an Operator" or "lay down an Node", you're doing the same thing.