Utility Plug-ins

Color Selection Plug-ins

A color selection plug-in (i.e. color picker) is a utility plug-in that provides the user with a custom color picker that appears whenever a standard 3ds Max color swatch control is clicked. These plug-ins are selected in the General tab of the Preferences dialog. The color picker chosen is saved in the 3DSMAX.INI file in the "ColorPicker" section so that the choice is maintained between sessions. If the DLL for the selected color picker is not available, it always defaults back to the "Default" color picker.

A color selection plug-in derives from ColPick. No sample code is provided with the SDK.

Global Utility Plug-ins (GUPs)

A global utility plug-ins (GUP) has no user interface, and do not show in Utility page of the command panel. A GUP usually derives from the GUP class. GUPs are loaded after 3ds Max initialization, but before the message loop starts, and remain loaded until after other plug-ins are shutdown.

• Plug-in Manager - \samples\gup\plug-inmanager

  This is a global utility that lets the user load and unload plug-ins during runtime.

• Save Verification - \samples\gup\saveverification

  Demonstrates a callback mechanism to validate that scene files are saved correctly.

• Geometry Checker - \samples\gup\geometrycheckers

  Analyzes mesh models, flags various potential problems and errors, and displays the results in the viewports both graphically and as text. Tests include isolated and overlapping vertices, open edges, various UVW statistics, and more.

How-to Samples:

• Layers Test - \howto\gup\layers

  Demonstrates the layers functionality.

Track View Utilities

Track view utility plug-ins are launched using the 'Track View Utility' icon just to the left of the track view name field in the toolbar. Clicking on this button brings up a dialog of all the track view utilities currently installed in the system. These may provide general utility functions that operate on keys, time or function curves in Track View. A track view plug-in will derive from TrackViewUtility.

• Euler Filter - \samples\utilities\filter.cpp

  Corrects for gimbal flipping (anomalous rotation animation) in objects animated using Euler rotation by processing existing animation keys in selected

• Create Out of Range Keys - \samples\utilities\ortkeys.cpp

  Creates keys in the out-of-range time of a track when the out of range type is something other than Constant. It converts the specified out-of-range area to a keyed area that you can edit and adjust.

• Randomize Keys - \samples\utilities\randkeys.cpp

  Applies random offset values to Time or Value of selected keys or selected time.

• Select Keys by Time - \samples\utilities\selkeys.cpp

  Selects keys within a specified start and end range of time. Lets a user select a large range of time when using the mouse might be awkward -- for example, if keys are not visible in the Track View Key window.

Utility Plug-ins

A utility plug-in will normally derive from the UtilityObj class.

• Color Converter Utility - \samples\ColorManagment\ColorConverter

  This utility converts a selected color to a specified rendering colorspace and output colorspace. It illustrates how to use the OpenColorIO-based color management APIs.

• Vertex Color Modifier - \samples\utilities\applyvc

  This modifier is the keeper of vertex colors generated by the "Apply Vertex Colors" Utility plug-in.

• Resource Collector - \samples\utilities\collector

  A resource (bitmaps) collection plug-in

• Fix Ambient - \samples\utilities\fixAmbient

  A utility that locks the ambient and diffuse colors and textures.

• Map Paths Utility - \samples\utilities\MapPath

  Manages bitmap file paths.

• Max File Finder - \samples\utilities\MaxFind

  Searches for Max Files in a system

• Material Editor Utilities - \samples\utilities\meditUtils

• Scene Manager - \samples\utilities\scenemgr

• MaxFind Launcher - \samples\utilities\umaxfind

  A utility to start an external MAXFinder executable.

• UVW Coordinate Remover - \samples\utilities\uvremove

• Various Utilities - \samples\utilities\utility.vcproj

How-to Samples

• Curve Control - \howto\utilities\Ccutil

  Demonstrates the use of a curve control.

• Custom Attribute Example - \howto\utilities\CustomAttribute

  Adds a custom attribute to an object, modifier and material

• Mesh Split - \howto\utilities\MeshSplit

  This plug-in splits editable meshes into separate nodes based on materials

• Reference Check - \howto\utilities\ReferenceCheck

  This utility shows the messages that get passed to reference makers from a reference targets.

• Transform Visualizer - \howto\utilities\TransformMatrixViz

  Allows the user to visualize the way transformation matrices are constructed in 3ds Max.

• XRef Demonstration - \howto\utilities\xref

  A simple utility that shows how to work with XRefs.