Script paint

You script paint by selecting a script and painting strokes on the surface with the Paint Scripts Tool.

To script paint

1. Make sure that the script you want to paint with is in your script directory:

   (Windows) Drive:\Documents and Settings\username\My Documents\Maya\<version>\scripts

   (Linux) ~username/Maya/<version>/scripts

   (Mac OS X) /Users/username/Library/Preferences/Autodesk/Maya/<version>/scripts

   Note: Do one of the following to open the Preferences directory using Mac OS X Lion:

   • Select Finder > Go > Go to Folder and type the directory path (/Users/<username>/Library/Preferences).
   • From the Terminal window, navigate to the Preferences directory and type open.

   (Mac OS X) /Applications/Autodesk/Maya<version>/Maya.app/Contents/scripts/paintEffects

   (Windows and Linux) mayapath/scripts/paintEffects

   Note: The sample scripts are in these directories:

   • (Windows) Drive:\Program Files\Autodesk\Maya<version>\scripts\others
   • (Linux) mayapath/scripts/others
   • (Mac OS X) /Applications/Autodesk/Maya<version>/Maya.app/Contents/scripts/others

   You do not need to move the samples to your personal scripts directory, however, any new scripts you create should be stored in your personal directory.

2. Select the surface you want to script paint on.
   Note: If you are going to paint with the geometryPaint or spherePaint sample scripts, you must freeze the transform of the surface before proceeding. For information on freezing transforms, see Reset and freeze transformations.
3. Select the Paint Scripts Tool and set the Paint Scripts Tool Options (Modify > Paint Scripts Tool > ), if required. For details on defining tool settings, see Paint Scripts Tool settings.
4. Go to the Setup section.
5. In the Tool Setup Cmd box, type the name of the MEL script (without the .mel extension), and then press Enter (Windows and Linux) or Return (Mac OS X). This box is case sensitive.

   For example, for the sample scripts type geometryPaint, spherePaint, or emitterPaint.

   A script window may open, depending on the script. Entries may also appear in the boxes in the Setup section. These are MEL procedures and come from the script. You do not need to modify them. For more information on these procedures, see Write MEL Scripts for the Paint Scripts Tool.

6. Change any settings in the script window then drag the brush across the surface. For details on the settings in the sample script windows, see geometryPaint sample script settings and emitterPaint sample script settings.