Difference between revisions of "Palette:opBrowser"

From TouchDesigner Documentation
Jump to: navigation, search
Line 1: Line 1:
[[Image:opBrowser.png|opBrowser]]
+
[[Image:opBrowserNumbered.png|opBrowser]]
 +
# Path
 +
# Control buttons
 +
# Tree pane
 +
# Viewer pane
 +
# Parameters pane
 
{{CustomSummary
 
{{CustomSummary
 
|COMPname=opBrowser
 
|COMPname=opBrowser
Line 21: Line 26:
 
|Parsummary=Show the <code>Component</code> in the browser tree. Otherwise, the top level will be <code>Component</code>'s children
 
|Parsummary=Show the <code>Component</code> in the browser tree. Otherwise, the top level will be <code>Component</code>'s children
 
|Parreadonly=False}}
 
|Parreadonly=False}}
 +
{{CustomToggle
 +
|Parname=Includewirehierarchy
 +
|Parlabel=Include Wire Hierarchy
 +
|Parorder=1
 +
|Parsummary=Organize the OP tree using hierarchy created by grey Component wires as well as depth.
 +
|Parreadonly=False}}
 +
{{CustomToggle
 +
|Parname=Includeresultparents
 +
|Parlabel=Include Result Parents
 +
|Parorder=1
 +
|Parsummary=Include the top level OPs in the tree.
 +
|Parreadonly=False}}   
 
{{CustomToggle
 
{{CustomToggle
 
|Parname=Limitmaxdepth
 
|Parname=Limitmaxdepth
Line 179: Line 196:
 
|Parlabel=Par Expression
 
|Parlabel=Par Expression
 
|Parorder=17
 
|Parorder=17
|Parsummary=
+
|Parsummary=OPs with this string in their expressions
 
|Parreadonly=False}}
 
|Parreadonly=False}}
 
{{CustomToggle
 
{{CustomToggle
Line 185: Line 202:
 
|Parlabel=Par Non-Default Only
 
|Parlabel=Par Non-Default Only
 
|Parorder=18
 
|Parorder=18
|Parsummary=
+
|Parsummary=Ps with non-default parameters only
 
|Parreadonly=False}}
 
|Parreadonly=False}}
{{CustomPython
+
{{CustomString
 
|Parname=Lambdafilterkey
 
|Parname=Lambdafilterkey
 
|Parlabel=Lambda Filter Key
 
|Parlabel=Lambda Filter Key
Line 227: Line 244:
 
|Parsummary=Show Tags column in tree
 
|Parsummary=Show Tags column in tree
 
|Parreadonly=False}}
 
|Parreadonly=False}}
{{CustomToggle
+
{{CustomMenu
 
|Parname=Typecolumn
 
|Parname=Typecolumn
 
|Parlabel=Type Column
 
|Parlabel=Type Column
 
|Parorder=5
 
|Parorder=5
|Parsummary=Show Type column in tree
+
|Parsummary=Set Type Column to display OP type abbreviations or full OP type name. Turning the column off is also an option.
 
|Parreadonly=False}}
 
|Parreadonly=False}}
 +
{{CustomInteger
 +
|Parname=Typecolumnwidth
 +
|Parlabel=Type Column Width
 +
|Parorder=9
 +
|Parsummary=Width of Type column in pixels.
 +
|Parreadonly=False
 +
|Paritems=}}
 
{{CustomToggle
 
{{CustomToggle
 
|Parname=Viewerbutton
 
|Parname=Viewerbutton
Line 251: Line 275:
 
|Parsummary=Show Network button column in tree
 
|Parsummary=Show Network button column in tree
 
|Parreadonly=False}}
 
|Parreadonly=False}}
{{CustomInteger
 
|Parname=Typecolumnwidth
 
|Parlabel=Type Column Width
 
|Parorder=9
 
|Parsummary=Width of Type column in pixels.
 
|Parreadonly=False
 
|Paritems=}}
 
 
{{CustomPulse
 
{{CustomPulse
 
|Parname=Editcolumndefinitions
 
|Parname=Editcolumndefinitions

Revision as of 15:21, 13 April 2019

opBrowser

  1. Path
  2. Control buttons
  3. Tree pane
  4. Viewer pane
  5. Parameters pane


Summary
[edit]

The opBrowser Custom Component provides a range of network browsing, viewing, and parameter editing capabilities. It can be used as a standalone browser or embedded into other ui's. All configuration features are controlled by custom parameters and can be made accessible or not in the browser UI.

PythonIcon.pngPalette/opBrowser Ext


Parameters - Browser Page

These parameters are general options for the Browser and Tree

Component Component - The root component to browse.  

Include Component Includecomponent - Show the Component in the browser tree. Otherwise, the top level will be Component's children  

Include Wire Hierarchy Includewirehierarchy - Organize the OP tree using hierarchy created by grey Component wires as well as depth.  

Include Result Parents Includeresultparents - Include the top level OPs in the tree.  

Limit Max Depth Limitmaxdepth - Use maximum depth settings for browser tree.  

Maximum Depth Maxdepth - Maximum component depth in the browser tree. 

Open Window Openwindow - Open browser window  

Close Window Closewindow - Close browser window  

Help Help - Open this help page  

Version Version(Read Only) - Browser version (for internal use)  

Parameters - Filters Page

These filters apply to the browser tree and generally duplicate those in OP Find DAT. Uses TouchDesigner style pattern matching. Lists are space delimited and strings with spaces should be in quotes.

Filter Roots Only Filterrootsonly - Apply filter only to browser tree roots. Otherwise, apply to all roots and branches.  

Object COMPs Objects - Show Object COMPs in browser tree  

Panel COMPs Panels - Show Panel COMPs in browser tree  

Other COMPs Other - Show other COMPs in browser tree  

TOPs Tops - Show TOPs in browser tree  

CHOPs Chops - Show CHOPs in browser tree  

SOPs Sops - Show SOPs in browser tree  

MATs Mats - Show MATs in browser tree  

DATs Dats - Show DATs in browser tree  

Case Sensitive Casesensitive - Filters will be case sensitive.  

Combine Filters Combinefilters- - Defines how the filters on this page are combined

* All all - All filters must be true
  • Any any - Any filter must be true

Name Namefilter - OPs with this name  

Type Typefilter - OPs of this type (use Python class name)  

Tags Tagsfilter - OPs with one or more of these tags  

DAT Text Textfilter - DATs containing this text  

Par Name Parnamefilter - OPs with parameters that have one of these names. Use Python parameter names.  

Par Value Parvaluefilter - OPs with parameters that have one of these values.  

Par Expression Parexpressionfilter - OPs with this string in their expressions  

Par Non-Default Only Parnondefaultonly - Ps with non-default parameters only  

Lambda Filter Key Lambdafilterkey - A Python lambda filter method, whose argument is the OP to be filtered out or not. For example, to get all OPs whose name starts with "A": lambda x: x.name.startswith('A')  

Parameters - Tree Page

These are deeper settings for the browser tree

Right Click Menu Rightclickmenu - Bring up standard network context menu for OPs on RMB  

Multiple Row Select Multiplerowselect - Allow multiple rows to be selected in tree  

Double Click To Set Component Doubleclicktosetcomponent - Double-click a COMP in the tree to make it the new root Component  

Path Column Pathcolumn - Show Path column in tree  

Tags Column Tagscolumn - Show Tags column in tree  

Type Column Typecolumn - Set Type Column to display OP type abbreviations or full OP type name. Turning the column off is also an option.  

Type Column Width Typecolumnwidth - Width of Type column in pixels. 

Viewer Button Viewerbutton - Show Viewer button column in tree  

Parameters Button Parametersbutton - Show Parameters button column in tree  

Network Button Networkbutton - Show Network button column in tree  

Edit Column Definitions Editcolumndefinitions - Open the column definitions table for the browser. See Lister - column definition table for more info.  

Parameters - Panes Page

Pane and layout controls.

Pane Order Paneorder- - Defines the order of panes in the browser.

* Tree Viewer Parameters Tree_Viewer_Parameters -
  • Tree Parameters Viewer Tree_Parameters_Viewer -
  • Viewer Tree Parameters Viewer_Tree_Parameters -
  • Viewer Parameters Tree Viewer_Parameters_Tree -
  • Parameters Tree Viewer Parameters_Tree_Viewer -
  • Parameters Viewer Tree Parameters_Viewer_Tree -

Pane Configuration Paneconfiguration- - Defines the layout of the browser.

* Horizontal Horizontal - Left to right
  • Vertical Vertical - Top to bottom
  • Split Left Split_Left - Top to bottom on left side, last pane on right
  • Split Right Split_Right - First pane on left, then top to bottom on right side
  • Split Bottom Split_Bottom - First pane on top, then left to right on bottom
  • Split Top Split_Top - Left to right on top, then last pane on bottom

Show Header Showheader - Show the header with Path and control buttons  

Show Viewer Showviewer - Show viewer pane  

Show Parameters Showparameters - Show parameter pane  

Show OP Tree Showtree - Show tree pane  

Show Viewer Button Showviewerbutton - Show viewer display button on UI  

Show Parameters Button Showparametersbutton - Show parameter display button on UI  

Show OP Tree Button Showtreebutton - Show tree display button on UI  

Sizeable Main Orientation Sizeablemainorientation - Show handle for sizing primary orientation  

Sizeable Split Orientation Sizeablesplitorientation - Show handle for sizing secondary orientation  

Knob Size Knobsize - Size of sizing handles 

Tree Min Size Treeminsize- -

Tree Min Size Treeminsizew - Minimum width and height of tree pane


Tree Min Size Treeminsizeh -

Viewer Min Size Viewerminsize- -

Viewer Min Size Viewerminsizew - Minimum width and height of viewer pane


Viewer Min Size Viewerminsizeh -

Parameters Min Size Parametersminsize- -

Parameters Min Size Parametersminsizew - Minimum width and height of parameter pane


Parameters Min Size Parametersminsizeh -

Parameters - Options Page

Other options for the browser

Edit Settings Editsettings - Open the edit settings window  

Edit Settings Button Editsettingsbutton - Show edit settings button on UI  

Allow Viewer Interaction Allowviewerinteraction - Allow interaction in the viewer pane  

Viewer Interaction Button Viewerinteractionbutton - Show allow interaction button in viewer UI  

Path Right Click Menu Pathrightclickmenu - Bring up network context menu when you right-click in Path items  

Set Component With Drop Setcomponentwithdrop - Set Component by dropping a COMP onto Path in browser UI  

The location of an operator within the TouchDesigner environment, for example, /geo1/torus1, a node called torus1 in a component called geo1. The path / is called Root. To refer instead to a filesystem folder, directory, disk file or http: address, see Folder.

An Operator Family that contains its own Network inside. There are twelve 3D Object Component and eight 2D Panel Component types. See also Network Path.

The connection of an output of one node to the input of another node in a network. In contrast, see Link.

Strictly refers to a window in Microsoft Windows. User-created windows are made with Panels inside Window Components, aside from the TouchDesigner editor window and its dialogs.

Operators that have 1 or more input, like a Math CHOP, are called filters. See Generator.

The component types that are used to render 3D scenes: Geometry Component contain the 3D shapes to render, plus Camera, Light, Ambient Light, Null, Bone, Handle and other component types.

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.

A text string that contains data (string, float, list, boolean, etc.) and operators (+ * < etc) that are evaluated by the node's language (python or Tscript) and returns a string, float list or boolean, etc. Expressions are used in parameters, DATs and in scripts.

An Operator Family that contains its own Network inside. There are twelve 3D Object Component and eight 2D Panel Component types. See also Network Path.

The viewer of a node can be (1) the interior of a node (the Node Viewer), (2) a floating window (RMB->View... on node), or (3) a Pane that graphically shows the results of an operator.