Window Placement Dialog

See also Perform Mode and Multiple Monitors.

This is being superceded by the Window COMP.

Description

The Window Placement dialog sets how the interface of TouchDesigner starts up. Window options include settings for Designer Mode and Perform Mode.

Designer Mode

This section of the Window Placement dialog controls the display of the main TouchDesigner application window, the editing environment.

Always On Top - ensures that TouchDesigner will remain on at the front of all other windows that may pop-up.

Monitor Spanning Settings

These settings determine how the TouchDesigner application window spans the current Windows Monitor Arrangement.

• Automatic - TouchDesigner starts up based on the default settings using the windows video driver settings. TouchDesigner will fill Window's default monitor using this setting.
• Full Screen - Forces TouchDesigner to fill the current monitor arrangement, spanning across 2 monitors if it is set to Horizontal Span.
• Left Half - Ensures TouchDesigner runs only on the left half of the monitor arrangement. When using a single monitor, this forces TouchDesigner to fill the left half of that monitor. When using Horizontal Span, this will force TouchDesigner to fill the left monitor completely (which is the left half of the entire Horizontal Span).
• Right Half - Ensures TouchDesigner runs only on the right half of the monitor arrangement. When using a single monitor, this forces TouchDesigner to fill the right half of that monitor. When using Horizontal Span, this will force TouchDesigner to fill the right monitor completely (which is the right half of the entire Horizontal Span).
• Custom - This option can be used to force the main window of TouchDesigner to a particular location and size. When this option is selected, the Read Current Window Settings button is activated. Pressing this button will set the Position and Size settings to mimic the current position and size. The next time the application is restarted the custom settings are used.

Position - sets the position of the designer window. The first parameter is pixels from the left edge and the second parameter is pixels from the top edge of the monitor

Size - sets the size of the designer window. The first parameter is size in x, the second is size in y.

Read Current Window Settings - clicking this button will stuff the current position and size of the designer window into the parameters above.

Enable - designates whether the main designer window is refreshed. Disable this option to deactivate the designer window. This may be useful in cases where the fullscreen Secondary Monitor is consuming too much video memory but is still necessary. So by disabling the viewer on the primary display (Primary Monitor), video memory is made free, thereby increasing performance of the secondary output.

Skip Frames - skips this number of frames between refreshing the main designer window.

Perform Mode

This section of the Window Placement dialog controls the display of the panel while in Perform Mode. When Perform Mode is turned on, a window that displays the control panel referenced in the Perform parameter below is opened and all drawing of the TouchDesigner designer interface is stopped. Perform Mode can be cancelled by pressing the Esc key while the cursor is over the Panel.

If a Window COMP is referenced in the Perform parameter above, the Perform Mode settings will be set through the Window Component's parameters. The only option in this dialog when using a Window COMP will be Hide Editor during Perform Mode as shown below. When checked on, this will make the TouchDesigner authoring interface (Designer Mode) disappear when in Perform Mode.

If any other type of operator is referenced in the Perform parameter above, then the Monitor Spanning Settings described below are available.

Monitor Spanning Settings

These settings determine how the Perform Panel window spans the current Windows Monitor Arrangement.

• Always On Top - ensures that the Perform Panel will remain on at the front of all other windows that may pop-up.
• Automatic - Perform Panel starts up based on the default settings using the windows video driver settings. The panel will fill Window's default monitor using this setting.
• Full Screen - Forces the Perform Panel to fill the current monitor arrangement, spanning across 2 monitors if it is set to Horizontal Span.
• Left Half - Ensures the Perform Panel runs only on the left half of the monitor arrangement. When using a single monitor, this forces it to fill the left half of that monitor. When using Horizontal Span, this will force it to fill the left monitor completely (which is the left half of the entire Horizontal Span).
• Right Half - Ensures the Perform Panel runs only on the right half of the monitor arrangement. When using a single monitor, this forces it to fill the right half of that monitor. When using Horizontal Span, this will force it to fill the right monitor completely (which is the right half of the entire Horizontal Span).
• Custom - This option can be used to force the Perform Panel to a particular location and size. When this option is selected, the Read Current Window Settings button is activated. Pressing this button will set the Position and Size settings to mimic the current position and size of the Perform Panel.

Position - sets the position of the Perform Panel. The first parameter is pixels from the left edge and the second parameter is pixels from the top edge of the monitor

Size - sets the size of the Perform Panel. The first parameter is size in x, the second is size in y.

Read Current Window Settings - clicking this button will stuff the current position and size of the Perform Panel into the parameters above.

Borders - opens the Perform Panel with or without window borders.

Exclusive - when exclusive is on, the main designer window (Designer Mode) will not be displayed when the Perform Panel is open.

Perform Panel

• Checkbox - checking this box on will open the Perform Panel.
• Path - path to the operator that contains the viewer to be displayed when in Perform Mode.

Start Mode - this menu determines which display mode will be used when the .toe file is started.

• Designer Mode - starts using Designer Mode, the main TouchDesigner editing window.
• Perform Mode - starts using Perform Mode.
• Perform Mode with Privacy - starts using Perform Mode but is locked such that the user can not use Esc to close the Perform Panel.

Multiple Monitor Settings

To setup multiple monitors, use the Window COMP.