MAXScript SDK

MAXScript SDK

See Also: Must Read Sections for All Developers.

The MAXScript SDK is a set of Visual C++ headers and import libraries that C++ programmers can use to extend MAXScript. These extensions can be in the form of new built-in functions, new system globals or descriptors for new MAX plug-in class properties. This is useful for 3rd-party plug-in developers to write custom scripting interfaces for their plug-ins, and for programmers to do custom C++ performance code and drive it with scripts for hybrid tools.

The scripter SDK allows extensions to be added either incrementally through a MAXScript-specific DLL file type that is loaded by MAXScript or by runtime calls directly to MAXScript from within an existing plug-in.

The following topics describe the SDK:

DLL Setup

Libraries

Build Configurations

MAXScript Value Constructors

Distinguished Values

Coercion to C++ Types

Protecting Newly Created Values from the Collector

Collector-Safe Value Local Macros

Value Local Arrays

Marking Values as Permanent or Collectable

Scripter-Callable Functions

Working with MAX Objects in the SDK

Constructing Wrappers

Retrieving Wrapped Objects

Handling Deleted Objects

MAX ClassIDs and Superclass IDs

The MAXClass Constructor

classOf() and superClassOf() Methods for MAX Objects

Collection Mapping

Array Access and Construction

Stream I/O

Access to the Compiler and Interpreter

Calling Scripted Functions

MAXScript Header Files

Defining New System Globals

Core Names