Difference between revisions of "Table DAT"

From TouchDesigner Documentation
Jump to: navigation, search
(TD Editor)
 
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
{{Glossary
 +
|Title=Table DAT
 +
|Short=A form of [[DAT]]s (Data Operators) that is structured as rows and columns of text strings.
 +
|Long=
 +
}}
 
{{Summary
 
{{Summary
|OPfamily=DAT
+
|opFamily=DAT
|OPlabel=Table
+
|opLabel=Table
|OPfilter=False
+
|opFilter=False
 
|long=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]]).
 
|long=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|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.
|OPclass=tableDAT_Class
+
|opClass=tableDAT_Class
|OPtype=table
+
|opType=table
 
|short=The Table DAT lets you hand-edit or create a table of rows and columns of cells, each cell containing a text string.
 
|short=The Table DAT lets you hand-edit or create a table of rows and columns of cells, each cell containing a text string.
|OPlicense=Non-Commercial
+
|opLicense=Non-Commercial
 
}}
 
}}
 
{{ParameterPage
 
{{ParameterPage
 
|items=
 
|items=
{{ParButton
+
{{Parameter|parLabel=Edit..
|Parlabel=Edit..
+
|opFamily=DAT
|OPfamily=DAT
+
|parName=edit
|Parname=edit
+
|parSummary=Clicking this opens a text editor to add/edit/delete text from the DAT.
|Parsummary=
+
|opType=table
|OPtype=table
+
|parOrder=0
|Parorder=0
+
|parType=
}}
+
|parReadOnly=
{{ParFilePath
+
|parItems=
|Parlabel=File
+
}}
|OPfamily=DAT
+
{{Parameter|parLabel=File
|Parname=file
+
|opFamily=DAT
|Parsummary=
+
|parName=file
|OPtype=table
+
|parSummary=The filesystem path and name of the file to load. Accepts <code>.txt</code> and <code>.dat</code> files.
|Parorder=1
+
|opType=table
}}
+
|parOrder=1
{{ParToggle
+
|parType=
|Parlabel=Load on Start
+
|parReadOnly=
|OPfamily=DAT
+
|parItems=
|Parname=loadonstart
+
}}
|Parsummary=
+
{{Parameter|parLabel=Load on Start
|OPtype=table
+
|opFamily=DAT
|Parorder=2
+
|parName=loadonstart
}}
+
|parSummary=When On, reloads the file from disk into the DAT when the projects starts.
{{ParButton
+
|opType=table
|Parlabel=Load File
+
|parOrder=2
|OPfamily=DAT
+
|parType=
|Parname=loadonstartpulse
+
|parReadOnly=
|Parsummary=
+
|parItems=
|OPtype=table
+
}}
|Parorder=3
+
{{Parameter|parLabel=Load File
}}
+
|opFamily=DAT
{{ParToggle
+
|parName=loadonstartpulse
|Parlabel=Write on Toe Save
+
|parSummary=Instantly reloads the file. 
|OPfamily=DAT
+
|opType=table
|Parname=write
+
|parOrder=3
|Parsummary=
+
|parType=
|OPtype=table
+
|parReadOnly=
|Parorder=4
+
|parItems=
}}
+
}}
{{ParButton
+
{{Parameter|parLabel=Write on Toe Save
|Parlabel=Write File
+
|opFamily=DAT
|OPfamily=DAT
+
|parName=write
|Parname=writepulse
+
|parSummary=When On, writes the contents of the DAT out to the file on disk when the project is saved.
|Parsummary=
+
|opType=table
|OPtype=table
+
|parOrder=4
|Parorder=5
+
|parType=
}}
+
|parReadOnly=
{{ParToggle
+
|parItems=
|Parlabel=Remove Blank Lines
+
}}
|OPfamily=DAT
+
{{Parameter|parLabel=Write File
|Parname=removeblank
+
|opFamily=DAT
|Parsummary=
+
|parName=writepulse
|OPtype=table
+
|parSummary=Instantly write the file to disk. 
|Parorder=6
+
|opType=table
}}
+
|parOrder=5
{{ParToggle
+
|parType=
|Parlabel=Exact Dimensions
+
|parReadOnly=
|OPfamily=DAT
+
|parItems=
|Parname=dims
+
}}
|Parsummary=
+
{{Parameter|parLabel=Remove Blank Lines
|OPtype=table
+
|opFamily=DAT
|Parorder=7
+
|parName=removeblank
}}
+
|parSummary=When enabled, do not convert blank lines into empty rows when loading files.
{{ParInteger
+
|opType=table
|Parlabel=Rows
+
|parOrder=6
|OPfamily=DAT
+
|parType=
|Parname=rows
+
|parReadOnly=
|Parsummary=
+
|parItems=
|OPtype=table
+
}}
|Parorder=8
+
{{Parameter|parLabel=Exact Dimensions
}}
+
|opFamily=DAT
{{ParInteger
+
|parName=dims
|Parlabel=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.
|OPfamily=DAT
+
|opType=table
|Parname=cols
+
|parOrder=7
|Parsummary=
+
|parType=
|OPtype=table
+
|parReadOnly=
|Parorder=9
+
|parItems=
}}
+
}}
 +
{{Parameter|parLabel=Rows
 +
|opFamily=DAT
 +
|parName=rows
 +
|parSummary=Defines the number of rows in the table.
 +
|opType=table
 +
|parOrder=8
 +
|parType=
 +
|parReadOnly=
 +
|parItems=
 +
}}
 +
{{Parameter|parLabel=Columns
 +
|opFamily=DAT
 +
|parName=cols
 +
|parSummary=Defines the number of columns in the table.
 +
|opType=table
 +
|parOrder=9
 +
|parType=
 +
|parReadOnly=
 +
|parItems=
 +
}}
 
 
|OPfamily=DAT
+
|opFamily=DAT
|Pagesummary=
+
|pageSummary=
|Pagename=Table
+
|pageName=Table
 
}}
 
}}
 
{{:DAT Generator Common Page
 
{{:DAT Generator Common Page
Line 107: Line 132:
 
}}
 
}}
 
{{DATNavBox
 
{{DATNavBox
|OPfamily=DAT
+
|opFamily=DAT
 
}}
 
}}
 
{{#invoke:Category
 
{{#invoke:Category
 
|list|DATs}}
 
|list|DATs}}

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.