Difference between revisions of "Table DAT"

From TouchDesigner Documentation
Jump to: navigation, search
(cleaning)
(Tag: 2018.28070)
 
(One intermediate revision by one other user not shown)
Line 12: Line 12:
 
In the Table DAT's viewer you can add rows and columns and type text into any cell of its [[Node Viewer|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.
 
In the Table DAT's viewer you can add rows and columns and type text into any cell of its [[Node Viewer|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 <code>op('table1')[2,'select'] = 'yes'</code>, or append rows using <code>.appendRow()</code> in python. See also the [[Script DAT]].
+
You can also put strings into table cells using something like <code>op('table1')[2,'select'] = 'yes'</code>, or append rows using <code>.appendRow()</code> in python. See also the [[Script DAT]] and its Snippets.
 
 
 
The Table DAT can also can load a table from a <code>.txt</code> or <code>.dat</code> file on disk or on the web. Use <code>http://</code> when specifying a table on the internet. The text will be converted into tab-delimited tables.
 
The Table DAT can also can load a table from a <code>.txt</code> or <code>.dat</code> file on disk or on the web. Use <code>http://</code> when specifying a table on the internet. The text will be converted into tab-delimited tables.
Line 45: Line 45:
 
|opFamily=DAT
 
|opFamily=DAT
 
|parName=loadonstart
 
|parName=loadonstart
|parSummary=When set to 1, reloads the file from disk into the DAT when the projects starts. Pulse to reload instantly.
+
|parSummary=When On, reloads the file from disk into the DAT when the projects starts.
 
|opType=table
 
|opType=table
 
|parOrder=2
 
|parOrder=2
Line 55: Line 55:
 
|opFamily=DAT
 
|opFamily=DAT
 
|parName=loadonstartpulse
 
|parName=loadonstartpulse
|parSummary=
+
|parSummary=Instantly reloads the file. 
 
|opType=table
 
|opType=table
 
|parOrder=3
 
|parOrder=3
Line 65: Line 65:
 
|opFamily=DAT
 
|opFamily=DAT
 
|parName=write
 
|parName=write
|parSummary=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.
+
|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=4
Line 75: Line 75:
 
|opFamily=DAT
 
|opFamily=DAT
 
|parName=writepulse
 
|parName=writepulse
|parSummary=
+
|parSummary=Instantly write the file to disk. 
 
|opType=table
 
|opType=table
 
|parOrder=5
 
|parOrder=5

Latest revision as of 04:03, 10 June 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.  

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