Difference between revisions of "NetworkEditor Class"

From TouchDesigner Documentation
Jump to: navigation, search
Line 134: Line 134:
 
}}}}
 
}}}}
 
<section end=HELPBODY />
 
<section end=HELPBODY />
 +
{{ClassInheritance|class=Pane}}
 
{{History}}
 
{{History}}
 
{{#invoke:Category|list|Python Reference}}
 
{{#invoke:Category|list|Python Reference}}

Revision as of 17:41, 29 September 2017

The NetworkEditor class describes an instance of a Network Editor. They are subclasses of the Pane Class, which can be accessed from the ui object.


Members[edit]

showBackdropCHOPsbool :

Enable or disable CHOP viewers as backdrops.

showBackdropGeometrybool :

Enable or disable SOP and Geometry object viewers as backdrops.

showBackdropTOPsbool :

Enable or disable TOP viewers as backdrops.

showColorPalettebool :

Enable or disable display of the operator color palette selector.

showDataLinksbool :

Enable or disable disable of operator data links.

showListbool :

Control display of operators as a list, or connected nodes.

showNetworkOverviewbool :

Enable or disable display of the network overview.

showParametersbool :

Enable or disable display of the currently selected operator parameters.

straightLinksbool :

Control display of operator links as straight or curved.

xfloat :

Get or set the x coordinate of the network editor area, where 1 unit = 1 pixel when zoom = 1.

yfloat :

Get or set the y coordinate of the network editor area, where 1 unit = 1 pixel when zoom = 1.

zoomfloat :

Get or set the zoom factor of the network editor area, where a zoom factor of 1 draws each node at its unscaled resolution.

Methods[edit]

fitHeight(height)None:

Fit the network area to specified height, specified in node units. This affects the zoom factor.

  • height - The height to fit to.

home(zoom=True, op=None)None:

Home all operators in the network.

  • zoom - (Keyword, Optional) When true, the view will be scaled accordingly, otherwise the nodes will only be re-centered.
  • op - (Keyword, Optional) If an operator is specified, the network will be homed around its location.
p = ui.panes['pane1']
n = op('/project1')
p.home(op=n)
p = ui.panes[2]
p.home(zoom=True)

fitWidth(width)None:

Fit the network area to specified width, specified in node units. This affects the zoom factor.

  • width - The width to fit to.

homeSelected(zoom=True)None:

Home all selected operators in the network.

  • zoom - (Keyword, Optional) When true, the view will be scaled accordingly, otherwise the nodes will only be re-centered.

Pane Class[edit]

Members[edit]

ownerCOMP :

Get or set the component this pane points to.

idint (Read Only):

A unique numeric identifier.

linkint :

Get or set the numeric link index.

enablebool :

Get or set mouse and keyboard interactivity on the pane.

maximizebool :

Enable or disable the pane maximize state.

namestr :

Get or set the pane name.

ratiofloat :

Get or set the split proportion of the pane, if the pane was previously split.

bottomLefttuple(x,y,u,v) (Read Only):

The coordinates of the bottom left corner, expressed in both pixels and uv offsets, in a named tuple.

topRighttuple(x,y,u,v) (Read Only):

The coordinates of the top right corner, expressed in both pixels and uv offsets, in a named tuple.

typePaneType (Read Only):

The enumerated type of the pane. Example: NetworkEditor.

The enumeration is called PaneType and consists of:

  • PaneType.NETWORKEDITOR
  • PaneType.PANEL
  • PaneType.GEOMETRYVIEWER
  • PaneType.TOPVIEWER
  • PaneType.CHOPVIEWER
  • PaneType.ANIMATIONEDITOR
  • PaneType.PARAMETERS
  • PaneType.TEXTPORT

Methods[edit]

changeType(paneType)td.Pane:

Change the pane to the specified type. Will return a new Pane object that represents the Pane. After being called, the current Pane instance will no longer be valid.

  • paneType - The type of pane to change this pane to.
p = ui.panes[0]
p = p.changeType(PaneType.TOPVIEWER)  # note: must re-assign p to new object.

close()None:

Close the pane.

floatingCopy()td.Pane:

Return a floating copy of the pane.

splitBottom()td.Pane:

Split the bottom portion of the pane into a new pane.

splitLeft()td.Pane:

Split the left portion of the pane into a new pane.

splitRight()td.Pane:

Split the right portion of the pane into a new pane.

splitTop()td.Pane:

Split the top portion of the pane into a new pane.

tearAway()bool:

Detach the pane into a floating window. Returns True if successful.

TouchDesigner Build:

A pane type where networks of operators can be created and edited.

An Operator Family which operate on Channels (a series of numbers) which are used for animation, audio, mathematics, simulation, logic, UI construction, and many other applications.

An Operator Family that reads, creates and modifies 3D polygons, curves, NURBS surfaces, spheres, meatballs and other 3D surface data.

An Operator Family that creates, composites and modifies images, and reads/writes images and movies to/from files and the network. TOPs run on the graphics card's GPU.

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.

A work area in TouchDesigner's layout that includes the Network Editor and 7 other pane types used for different tasks. The TouchDesigner interface can consist of a single pane, or be split into multiple panes.