Viewer Active

From TouchDesigner Documentation
Jump to: navigation, search

A node's Viewer Active state lets you operate a Node Viewer interactively.

Normally when you click/drag on a node, you move it. When the node's viewer is a three-letter icon, it will always move when clicked-dragged. Click the top-left flag on a node to toggle the viewer on. The viewer is visible, but it's not yet active. Then

  • while Alt+a is held down, all node viewers are temporarily in the Viewer Active state.
  • Shift+a toggles the global Viewers Always Active state. It makes all viewers in all networks session Active.
  • Viewers Always Active is also on the RMB network menu.
  • The shortcut key "a" will set/unset the Viewer Active Flag of all selected nodes (those with yellow borders).
  • All nodes have their own Viewer Active Flag on the bottom right corner of the node. Setting the Viewer Active Flag keeps the node viewer in an state where the viewer can always be operated.

The viewer active cursor is ^. The Viewers Always Active state is saved in the .toe.


left: node with 3-letter icon. middle: node with viewer (top-left flag of node). right: node with viewer active (bottom right flag).

When a viewer is active, you will only see a viewer and the name below it. You can manipulate, tumble, pan, zoom and operate the contents of the node viewer. Control panels can be fully-operated. You can also drag the name field of a node to move it around in a network.

Viewer Active is temporarily switched on for all nodes by holding down Alt in Network Editor, or pressing Alt-a to sustain it. Pressing Alt-a again turns Viewer Active off for all nodes except nodes that have their own Viewer Active flag on.

When not in Viewer Active, the node viewer area is disabled and acts like the rest of the node. This allows you to click anywhere to select and move the node, or right-click anywhere to access the node's menu.


A state of a node where you can operate the contents of its viewer, like operate the gadgets of a panel in a node viewer, or 3D data in the viewer of a Geometry component. With Viewer Active off you can select, move and delete nodes by clicking/dragging on them, even if the viewer is visible.

(1) Indicator of certain states of an operator (bypass, display, lock), or (2) option of a Tscript command.

TOuch Environment file, the file type used by TouchDesigner to save your project.