Python Editor

(Window > Python Editor)

The Python Editor provides a robust environment for end users to create scripts and tools, and to interact with MotionBuilder through Python.

The Python Editor lets you execute single-line scripts, multi-line scripts, and global scripts. It also enables you to configure MotionBuilder to receive scripts remotely, develop automation scripts, load and save script information as well as create custom MotionBuilder tools.

Some of the functionality supported by the Python Editor include:

• single and multi-line entry
• tabbed work areas
• line numbering
• color coding
• history
• keyboard shortcuts
• script drag & drop
• color coded error messages
• searching

You can execute specific code, like shortcut variables, when the Python Editor is launched by adding them C:\Users\[username]\Documents\MB\[version]-x64\config\Python\pythonidelib_init.py. For example, adding scn = FBSystem().Scene to this file lets you use the shortcut variable scn in the Python Editor each time the editor is launched.

Note: If pythonidelib_init.py does not exist, open the Python Editor and then close MotionBuilder to trigger its creation.

The Python Editor tool consists of the following areas: the toolbar, the interactive console, and the work area.

Python Editor: A. Toolbar B. Interactive console C. Work area

You can resize the Python Editor window by dragging any corner or border of the window, and the Python preferences let you set several other options, including whether tabs in the Work area will display x/Close buttons.

Python Editor toolbar

You can access most Python Editor commands from the Python Editor toolbar.

Python Editor toolbar

The Python Editor toolbar supports the following commands:

• create work area
• load script
• close (active) script
• save (active) script
• execute (active) script
• add (active) script to scene
• access Python Tool Manager
• launch Telnet Python Scripting Console
• trigger Python context Help
• launch Python Logger
• clear interactive console
• clear (active) work area
• search in interactive console
• search in (active) work area
• search in interactive console and in active work area
• trigger Python embedded code and external scripts from action buttons

See also Accessing Python Editor commands.

Python Editor interactive console

The Python Editor interactive console is similar to the Python IDLE. It provides feedback on the code in the Python Editor active work area. Errors, results from executed scripts and other feedback is also displayed in this console.

The Python Editor interactive console supports the following features:

• single or multi-line entry
• command history
• code auto-completion
• error feedback
• feedback on executed scripts
• code colorization
• Python context Help
• logging executed scripts

See also Using the Python Editor interactive console.

Python Editor work area

The Python Editor work area provides a workspace area for writing scripts, dragging and dropping scripts, commenting and uncommenting scripts.

The Python Editor work area supports the following features:

• line numbers
• code auto-completion
• code colorization
• current line highlighting
• smart highlighting, which highlights all instances of a word
• code comment and uncomment
• code indent and dedent
• drag and drop scripts
• add scripts to scenes
• multiple script work areas

See also Using the Python Editor work area.