Customizing the UI of an MCG Tool

You can modify the user interface of an MCG tool by entering standard MAXScript in the Custom UI property of the graph to redefine its rollout.

The default rollout simply lists the graph's parameters in depth-first order, and assigns the default UI control for their data types. By editing the Custom UI property, you can change labels, reorder parameters, modify the default values and ranges, define groups, change UI controls, and so on. For a description of all the possibilities, see the "Scripted Utilities and Rollouts" section of the MAXScript Help.

Every parameter in the graph must be included in the same rollout. However, you can define additional rollouts that are not associated with any parameter block (for example, labels and hyperlinks for information).

You can hide parameters by setting visible:false. Hidden UI controls still take up space in the rollout, but you can minimize this by placing them at the end and using layout parameters to make them as small as possible. Also, note that all graph parameters are always visible in the Track View and Motion panel.

To edit the Custom UI property

  1. Open a tool in the Max Creation Graph editor.
  2. If desired, you can use the default rollout as a starting base (or simply use it for reference). To do this:
    1. If there are unsaved changes in your graph, save and re-evaluate the graph.
    2. Choose Build > View MAXScript.
    3. Locate the rollout definition (typically starting with rollout params "Parameters" or similar).
    4. Select the associated block of code and copy it.
  3. Back in the Max Creation Graph editor, choose Edit > Edit Graph Properties.
  4. Click the Custom UI tab.
  5. If you copied the code for the default rollout, paste it in.
  6. Edit the rollout definition as desired.
  7. Save and re-evaluate the graph to see the effect of your changes in the tool's interface.