The MAXScript Listener Window

The Listener

The MAXScript Listener window is an interactive interpreter for the MAXScript language and works similar to a DOS command prompt window.

MAXScript commands entered in this window are executed immediately when you press the ENTER key in the numeric pad.

The Listener window is appropriate for performing interactive work and developing small code fragments.

Extended blocks of code should be developed in a Script Editor Window.

Each command you execute in Listener is actually an expression with a result which Listener prints out after each execution.

All commands in MAXScript are expressions or function calls that can look like commands in other languages.

The terms command and expression are synonymous in MAXScript.

You can enter any MAXScript expression or sub-expression in Listener for evaluation, and Listener prints out its result.

You can open only one instance of the MAXScript Listener window at a time.

To open the MAXScript Listener, you can perform one of the following actions:

• Choose the MAXScript utility on the Utilities panel and click Open Listener;

• Choose the MAXScript menu item in the Main Menu and select 'MAXScript Listener...' in the pull-down menu.

• Right-click the Mini Listener and select 'Open Listener Window' from the context menu.

• Press the F11 key.

The Listener window is a resizable, modeless window. You can switch between it and 3ds Max as you work.

If you close the Listener window and then reopen it, the text in the window before it was closed reappears.

If Auto Open Listener on Output is checked in Customize > Preferences > MAXScript, the Listener window opens automatically when a script outputs to it.

The Listener is divided into two panes: the top (pink) pane is the Macro Recorder pane, and the bottom (white) pane is the output pane.

When the Macro Recorder is enabled, everything recorded is displayed in the Macro Recorder pane.

The output of results from scripts are displayed in the output pane.

The output of code executed in the Macro Recorder pane is always directed to the output pane so as not to clutter the recordings.

Both panes allow you to cut-and-paste, drag-and-drop, edit, select, and execute code.

You can resize the panes by dragging on the split bar between them.

To install the Listener into a viewport:

1. Click or Right-Click the viewport type label.

2. Choose Extended Viewports.

3. Choose MAXScript Listener.

To remove the Listener from the viewport:

1. Right-click the menu bar on top of the viewport.

2. Choose any Viewport View mode like Front, Top, Perspective etc.

editorFont editorFontSize inputTextColor messageTextColor outputTextColor

The Mini-Listener

A resizable Mini Listener is located on the left side of the 3ds Max status panel.

If the Mini Listener is not visible, drag on the vertical split bar at the left edge of the status panel to reveal the Mini Listener.

The Mini Listener panes act as single-line sliding windows for the current line in the corresponding Listener panes.

The Mini Listener panes always show what you are typing or where the edit cursor is placed in the Listener panes.

Conversely, anything you type into a Mini Listener pane is entered into the corresponding Listener pane at the current edit cursor position.

You can right-click the Mini-Listener window to access a context menu which provides you with the option to open the MAXScript Listener window and the Editor window.

In addition, if there are existing commands already present in the respective pane of the Listener, the menu will also contain a list of these commands. You can select a command from the menu to reevaluate it in the Listener. The command will be evaluated immediately.

The color and font customizations applied to the MAXScript Listener also affect the Mini Listener.

See the topic MAXScript System Globals for examples.