API Guide > Example Plug-ins >

# Example C++ plug-in descriptions

Below are brief descriptions and usage instructions for the C++ plug-ins provided.

## affectsNode

This plug-in creates a node called "affects". Add two dynamic attributes called "A" and "B". When you change the value on A, note that B will recompute.

The following sequence of commands will demonstrate how to use this plug-in:

    // Create an "affects" node by typing the MEL command:
    createNode affects;
    // Add two integer dynamic attributes to the newly created affects node by typing the MEL command:
    addAttr -ln A -at long affects1;
    addAttr -ln B -at long affects1;
    // Change the value of "A" to 10 by typing the MEL command:
    setAttr affects1.A 10;
    // At this point, the affectsNode::setDependentsDirty() method gets called which causes "B" to be marked dirty.
    // Compute the value on "B" by doing a getAttr:
    getAttr affects1.B;
    // The affectsNode::compute() method is entered which copies the value from "A" (i.e. 10) to "B".

## arcLenNode

Produces dependency graph node arcLen

This node is a simple example of how to take geometry as an input to a dependency node. This node takes a NURBS curve as an input and outputs its arc length, using the MFnNurbsCurve function to perform the calculation.

The input for this node is a NURBS curve attribute called "inputCurve". NURBS curve shapes nodes have two compatible output attributes that you can use as inputs for the arcLen node - "local" and "worldSpace".

The output attribute of the arcLen node is just called "output". It is a double value that represents the total length of the curve with an epsilon value of 0.001.

The following MEL code shows how to hook up the node to a curve.

    createNode -n arcLen1 arcLen;
    connectAttr curveShape1.local arcLen1.inputCurve;

From here, you can connect the "output" attribute to whatever you wish to drive, or just read it using the following command:

    getAttr arcLen1.output;

This node is provided as an example of how to take geometry as an input. It should be noted that there is already a node in Maya that performs the same service called "curveInfo".

## animCubeNode

Produces dependency graph node animCube

This plug-in demonstrates how to take time as an input, and create polygonal geometry for output. The compute method of the node constructs a polygonal cube whose size depends on the current frame number. The resulting mesh is passed to an internal Maya node which displays it and allows it to be positioned.

To use this node, execute the MEL command "animCubeNode.mel" that contains the following commands:

    createNode transform -n animCube1;
    createNode mesh -n animCubeShape1 -p animCube1;
    createNode animCube -n animCubeNode1;
    connectAttr time1.outTime animCubeNode1.time;
    connectAttr animCubeNode1.outputMesh animCubeShape1.inMesh;

This creates a mesh node under a transform node which is hooked into the world for display. It then creates an animCube node, and connects its input to the time node, and its output to the mesh node.

A cube will now appear on the screen. If the play button on the time slider is pressed, the displayed cube will grow and shrink as the frame number changes.

## apiMeshShape

Produces shape node apiMesh, dependency graph node apiMeshCreator, and data type apiMeshData

This plug-in demonstrates how to create a polygonal mesh shape which has vertices that can be selected, moved, animated, and deformed. This shape also supports OpenGL display of materials.

This plug-in also registers a new kind of geometry data, apiMeshData, and demonstrates how to pass this data between nodes.

The apiMeshCreator node can create two types of apiMeshData, a cube and a sphere. The "shapeType" attribute is used to specify the type of shape to create. This node also takes normal mesh data as an input and converts it to apiMeshData. If there is no input mesh then the output is based on the shapeType attribute.

To create an apiMesh shape, you must first create the apiMesh node, then create an apiMeshCreator node and connect the two nodes as follows:

    createNode apiMesh -n m1;
    createNode apiMeshCreator -n c1;
    connectAttr c1.outputSurface m1.inputSurface;

## apiSimpleShape

Produces shape node apiSimpleShape.

This plug-in demonstrates how to create a surface shape with components using the MPxComponentShape class. Use the following MEL to create the node once the plug-in is loaded.

    string $node = `createNode apiSimpleShape`;
    // Add some CVs
    string $attr = $node + ".controlPoints[0]";
    int $idx = 0;
    for ( $i=0; $i<100; $i++)
    {
        for ( $j=0; $j<100; $j++)
        {
            string $attr = $node + ".controlPoints[ " + $idx + "]";
            setAttr $attr $i $j 3;
            $idx++;
        }
    }

## blindComplexDataCmd

Produces MEL command blindComplexData and user defined data type blindComplexData

This plug-in demonstrates how to create blind data (dynamic attributes) based on user defined data types. The plug-in uses an array of structures in which each element contains both a double and an int as the user data type.

The use of the MPlug class to set and retrieve the value of the attribute is demonstrated, as are read and write routines that implement the storage and retrieval of the data in both Maya ASCII and Maya Binary file formats.

To use this plug-in, select a dependency node, and then issue the command blindComplexData. A dynamic attribute containing a five element array will be attached to each selected dependency node. If the scene is saved in Maya ASCII format, you will be able to see the MEL commands that save the value of the dynamic attribute. If the scene is reloaded, the dynamic attribute will be reattached to the applicable nodes.

## blindDataMesh

Produces two dependency graph nodes: blindDataShader and blindDataMesh

This plug-in demonstrates the use of blind data to provide color information to a hardware shading node. It contains two parts, blindDataMesh and blindDataShader.

The blindDataMesh node builds a mesh and populates its blind data with color information. The blindDataShader node is a hardware shader which picks up the color information for drawing. The shader part of the plug-in picks uses the vertex IDs of the MPxHwShaderNode::geometry() method to acquire the blind data color information.

To use this plug-in: Open the blindDataShader.mel file and execute its contents. The results can be viewed by using the shading menu to smooth shade and then turn on hardware texturing.

## blindDoubleDataCmd

Produces MEL command blindDoubleData and user defined data type blindDoubleData

This plug-in demonstrates how to create blind data (dynamic attributes) based on user defined data types. The plug-in uses a simple double value as the user data type. The use of the MPlug class to set and retrieve the value of the attribute is demonstrated, as are read and write routines that implement the storage and retrieval of the data in both Maya ASCII and Maya Binary file formats.

To use this plug-in, select a dependency node, and then issue the command blindDoubleData. A dynamic attribute containing the double value, 3.2, will be attached to each selected dependency node. If the scene is saved in Maya ASCII format, you will be able to see the MEL commands that save the value of the dynamic attribute. If the scene is reloaded, the dynamic attribute will be reattached to the applicable nodes.

## blindShortDataCmd

Produces MEL command blindShortData

This example adds a dynamic attribute to the dependency nodes of each of the currently selected items. The attribute is a short and its default value is set to 99. To use this plug-in, select an object, bring up the Attribute Editor (select Window > Attribute Editor), and then click on the "Extras" tab. The attribute editor should display no extra attributes. Then execute blindShortData in the command window. An attribute will appear in the editor set to the value of 99. The value can be modified in the editor, or with the MEL commands setAttr and getAttr. When the scene is saved the new attribute and value for each selected item are also saved. This example demonstrates how simple blind data can be attached to an object.

## buildRotationNode

Produces dependency graph node buildRotation

This example demonstrates performing a linear algebra calculation based on inputs and outputting the result.

The node takes an up vector and a forward vector as inputs and outputs the rotation that takes the y-axis and the z-axis and rotates them to be the up and forward vectors respectively.

A sample use of this node is to align an object to another surface based on a normal and a tangent vector. This example uses the pointOnSurfaceNode which is a standard node provided with Maya.

    sphere -radius 4;
    cone -ax 0 1 0;
    createNode pointOnSurfaceInfo;
    connectAttr nurbsSphereShape1.worldSpace pointOnSurfaceInfo1.inputSurface;
    connectAttr pointOnSurfaceInfo1.position nurbsCone1.translate;
    setAttr pointOnSurfaceInfo1.u 0.01;
    setAttr pointOnSurfaceInfo1.v 0.01;

At this point, the cone will be constrained to a point on the surface of the sphere. As the u and v attributes of the pointOnSurfaceNode are changed, the cone will move around the surface. The next step is to align the cone so that the tip points in the direction of the normal. The buildRotation node will be used to do this.

    createNode buildRotation;
    connectAttr pointOnSurfaceInfo1.normal buildRotation1.up;
    connectAttr pointOnSurfaceInfo1.tangentU buildRotation1.forward;
    connectAttr buildRotation1.rotate nurbsCone1.rotate;

Now the cone will be constrained to the surface of the sphere and will also be aligned with the normal of the sphere at the point of constraint.

## CgFx Shader

Windows-only.

The plug-in is named cgfxShader.mll. It defines one node, named cgfxShader, and one command, also named cgfxShader. The command is used to manipulate the node. This is very similar to the expression command and node.

The cgfxShader node is a hardware shader (derived from MPxHwShaderNode).

By itself, the shader or s attribute is the only thing visible on a cgfxShader node. You set this attribute to the name of a .fx file and many interesting effects can occur. A .fx file holds CgFX effect definitions. This effect completely controls how the drawing is done. Therefore, if you load a different .fx file, you get a completely different effect on the screen. In theory, the cgfxShader node could do anything that any other hardware shader node could do.

Along with the effect, the CgFX file provides a set of parameters that can be modified to change the effect in controlled ways. For example, a glow effect may allow you to set the color, intensity, and size of the glow. A bumpy, shiny effect may allow you to change the bump texture map. All of these parameters are exposed as dynamic attributes on the shader node. If the effect has a glowColor parameter, the cgfxShader node would have a dynamic color attribute named glowColor. Changes to the attribute affect the parameter.

You specify the .fx file via the Attribute Editor or via the cgfxShader command. All the dynamic attributes that no longer apply are removed and all the attributes that are needed by the new effect are added. You can see all the changes in the Attribute Editor.

The syntax of the command is:

    cgfxShader [-e] [-fx fileName] [-n name] [nodeName]

-e

  Edit an existing shader. If -e is not specified, a new cgfxShader node is created.

-fx filename

  Set the .fx file for the cgfxShader node.

-n name

  Sets the name of the shader node to create. (Create only).

nodeName

  The name of the node to edit. You do not need to type this if the shader node is currently selected.

The easiest way to use the shaders is via the Hypershade window. Load the plug-in before opening the HyperShade window and then simply invoke Create > Material > Cgfx Shader. You can then simply drag the material onto a shape to assign it.

## circleNode

Produces dependency graph node circle

This plug-in is an example of a user-defined dependency graph node. It takes a number as input (such as time) and generates two output numbers one which describes a sine curve as the input varies and one that generates a cosine curve. If these two are hooked up to the x and z translation attributes of an object the object will describe move through a circle in the xz plane as time is changed.

Executing the command "source circleNode" will create a new "Circle" menu with a single item. Selecting this will build a simple model (a sphere which follows a circular path) which can be played back, by clicking on the "play" icon on the time slider.

The node has two additional attributes which can be changed to affect the animation, "scale" which defines the size of the circular path, and "frames" which defines the number of frames required for a complete circuit of the path. Either of these can be hooked up to other nodes, or can be simply set via the MEL command "setAttr" operating on the circle node "circleNode1" created by the MEL script. For example, "setAttr circleNode1.scale #" will change the size of the circle and "setAttr circleNode1.frames #" will cause objects to complete a circle in indicated number of frames.

## closestPointCmd

Produces MEL command closestPointCmd

This examples demonstrates how to use the MMeshIntersector class to find the closest point between a point light and a mesh. To use this plug-in, first load it and then execute:

    file -f -new;
    defaultPointLight(1, 1,1,1, 0, 0, 0,0,0, 1);
    move -r 0 5 0 ;
    polyPlane -w 1 -h 1 -sx 10 -sy 10 -ax 0 1 0 -cuv 2 -ch 1;
    scale -r 10 10 10 ;
    closestPointCmd pointLight1 pPlane1;

## closestPointOnCurve

Computes closestPointOnCurve (NURBS curve) from the input position

This plug-in defines both a MEL command and a DG node which takes in as input, a NURBS curve and a worldspace position, then computes the closest point on the input curve from the input position.

In addition to the worldspace "position" at the closest point on the curve, also returned are the "normal", "tangent", "U-parameter" and "closest distance from the input position", at the closest point on the curve.

## clusterWeightFunction

Produces Mel command clusterWeightFunction

This example demonstrates how to use the MFnWeightGeometryFilter::setWeight() method to set the weights of the CVs of a cluster according to a mathematical function.

Note

A call to MFnWeightGeometryFilter::setWeight() cannot be made inside the geometry iterator as this would result in a fatal error.

To use this plug-in, select the cluster and a geometry affected by the cluster.

For example:

    select cluster1 nurbsSphereShape1;

Then execute the MEL command clusterWeightFunction with the flag to specify which mathematical function to use:

For example:

    clusterWeightFunction -sine;

## componentScaleManip

The componentScaleManip is a manipulator plug-in that demonstrates how components can be manipulated using a scale manipulator using the manipulator API. This example produces the MEL command componentScaleContext to create the tool context for the component scale manipulator.

To create the tool button for the plug-in, create a new shelf named "Shelf1" and execute the following MEL commands to create the tool button in this shelf:

    componentScaleContext;
    setParent Shelf1;
    toolButton -cl toolCluster -t componentScaleContext1 -i1 "moveManip.xpm";

To use the manipulator, create a nurbs surface and select some CVs. Then click on the tool button created above to activate the plug-in context. The tool should work much like the built-in scale tool, except that the plug-in will only operate on NURBS CVs.

## conditionTest

Registers conditions callbacks

The conditionTest plug-in is a simple plug-in that displays which "conditions" are being changed inside Maya. A condition in Maya is something of interest to the Maya internals or plug-ins that has a true or false value. For example, "SomethingSelected" and "playingBack" are two available conditions. These conditions can be tracked at the MEL level with the -conditionTrue, -conditionFalse, or -conditionChanged flags to the scriptJob command.

The plug-in adds a "conditionTest" command that lets you see which conditions are available, track specific conditions, and to see which conditions are being tracked. The basic command syntax is:

    conditionTest [-m on|off] [conditionName ...]

The conditionName arguments should be the names of conditions. If no names are specified, the command will operate on all available conditions.

If you use the -m flag, you can specify whether the plug-in should track messages for the specified conditions or not. If you specify the -m flag without any condition names, it will turn on or off tracking for all conditions.

Example:

    mel: conditionTest -m 1 SomethingSelected
    Condition Name State Msgs On
    -------------------- ----- -------
    SomethingSelected false yes

After this example, the plug-in will display the line:

    condition SomethingSelected changed to true

or

    condition SomethingSelected changed to false

every time the selection list becomes empty or not empty. You can disable all condition tracking with the command: conditionTest -m off;

## convertBumpCmd

Produces MEL command convertBump

This plug-in command can be used to convert a bump file texture from a grey-scale height field format (used by Maya) to a normal map format that is typically used for real-time, hardware-based rendering.

This code also demonstrates how to use the MImage class to load, manipulate and save image files on disk.

Note

The MImage class is new as of Maya 4.0.1, but that the saving and filtering capability was only introduced in Maya 4.5.

To test this plug-in, first compile and load it using the plug-in manager, then type the following in the script editor:

    convertBump "C:/bump.tga" "C:/bump_norm.tga" "tga" 1.0

This would convert the input texture (c:/bump.tga) into an output normal map (c:/bump_norm.tga) using the default bumpScale ratio. The bumpScale parameter can be used to increase or decrease the bumpiness of the resulting normal map.

See the documentation of MImage::saveToFile() for a complete list of the available file formats supported.

## convertEdgesToContainedFacesCmd

Produces MEL command convertEdgesToContainedFaces

This plug-in creates a MEL command that converts a selection of edges into a selection of faces that interconnect the original edges (that is, only faces whose composite edges are contained in the original edge selection).

The command's return value is a string array that contains the names of all of the new contained faces. This MEL command has no flags, returns a string array, and operates on selected edges.

Example MEL usage:

    select -r pCube1.e[1:2] pCube1.e[6:7];
    string $convertedFaces[] = `convertEdgesToContainedFaces`;
    // Result: pCube1.f[1] //

## convertVerticesToContainedEdgesCmd

Produces MEL command convertVerticesToContainedEdges

This plug-in creates a MEL command that converts a selection of vertices into a selection of edges that interconnect the original vertices (that is, only edges whose composite vertices are contained in the original vertex selection). The command’s return value is a string array that contains the names of all of the new contained edges.

This MEL command has no flags, returns a string array, and operates on selected vertices.

Example MEL usage:

    select -r pCube1.vtx[2:5];
    string $convertedEdges[] = `convertVerticesToContainedEdges`;
    // Result: pCube1.e[1:2] pCube1.e[6:7] //

## convertVerticesToContainedFacesCmd

Produces MEL command convertVerticesToContainedFaces

This plug-in creates a MEL command that converts a selection of vertices into a selection of faces that interconnect the original vertices (that is, only faces whose composite vertices are contained in the original vertex selection). The command’s return value is a string array that contains the names of all of the new contained faces.

This MEL command has no flags, returns a string array, and operates on selected vertices.

Example MEL usage:

    select -r pCube1.vtx[0:5];
    string $convertedFaces[] = `convertVerticesToContainedFaces`;
    // Result: pCube1.f[0:1] //

## createClipCmd

Produces MEL command createClip

This example demonstrates the steps used to create a nonlinear animation clip using the API. The clip will be created either on the selected items, or on a character set node that is supplied using the -c/-char flag. The plug-in creates the animation curves that make up the clip, places them in a source clip, then instances the source clip twice.

To use this plug-in, create a sphere and select it. Then execute the command:

    createClip

Open the Maya® Trax™ Editor to see the clips in place on the timeline.

## curveArrowNode

Produces dependency node curvedArrows.

A simple locator node that demonstrates the transparency flag on locator nodes. Transparent objects must be drawn in a special draw pass by Maya because the rendered output is dependent on the draw order of objects. The isTransparent() method tells the API that this locator should be placed in this special transparency queue for rendering.

API programmers can see the effect of this draw operation by toggling the 'transparencySort' attribute on this node. When the attribute is set to true, the locator will be drawn in sorted order with all transparent objects in the scene. When it is set to false it will be drawn with all opaque objects in the scene.

This also demonstrates the related drawLast() flag. This flag allows a locator to be specified as the last object to be drawn in a given refresh pass. This flag serves a very specialized purpose, but it can also be important when using the isTransparent flag in crucial situations.

## customImagePlane

Produces dependency node customImagePlane.

Demonstrates how to create your own custom image plane based on Maya's internal image plane classes. This allows API users to override the default Maya image plane behavior. This class is similar to typical API nodes in that it can have a compute method and can contain static attributes added by the API user. This example class overrides the default image plane behavior and allows users to add transparency to an image plane using the transparency attribute on the node. Note, this code also illustrates how to use MImage to control the floating point depth buffer. When useDepthMap is set to true, depth is added to the image such that half of the image is at the near clip plane and the remaining half is at the far clip plane.

Once the image plane node has been created, you must attach it to the camera shape that is displaying the node. Image planes are attached to cameras via the imagePlane message attribute on the camera shape. To attach this example image plane you should connect the image plane's message attribute to the cameraShapes imagePlane attribute. The imagePlane attribute is a multi attribute and can hold references to multiple image planes.

For example:

    string $imageP = `createNode customImagePlane`;
    connectAttr -f ($imageP + ".message") "perspShape.imagePlane[0]"

## customAttrManip

This plug-in demonstrates how to create user-defined manipulators from a user-defined context.

This is the script for running this plug-in:

    source "customAttrManip.mel";
    sphere;
    move 5 0 0;
    cone;
    move -5 0 0;
    select -cl;

Now click on the customAttrManip on Shelf1!

## cvColorNode

Produces dependency graph node cvColor

This example provides an example of how to color the CVs of a NURBS surface by drawing OpenGL points on top of them. This node implements a locator that is intended to be made a sibling of a NURBS surface shape, and sit under the same transform. If the "local" space output attribute of the shape is connected to the "inputSurface" attributed of the locator node, then the later will draw colored points at each CV location. The current algorithm in the node will color the CVs in one of four different colors based on their XY location:

    x < 0 && y < 0: Red x < 0 && y >= 0: Cyan x >= 0 && y < 0: Blue x >= 0 && y >= 0: Yellow

To use this plug-in, first load it then execute the command "source cvColorNode" to define the MEL command attachColorNode. This command iterates across selected objects, and attaches a cvColor node, as described above, to each NURBS surface it encounters. Moving the objects, or its CVs, after the node is attached will cause the colors of the CVs to change. The pointSize attribute of the node controls the size of the point that is drawn. The drawingEnabled attribute, if set to false, will disable the display of the colored points.

## cvColorShader

Produces dependency graph node cvColorShader

This plug-in creates a node that allows vertex color(CPV) to be software rendered. Once the plug-in is loaded, the node will appear as a Color Utility in the Hypershade window. Connect this node to a shader's Color or Incandescence attribute.

## cvExpandCmd

Produces MEL command cvExpand

This example demonstrates how to handle selection lists and return the contents in a string form that the scripting language will understand. The cvExpand command goes through the current selection list and splits ranges of CVs that are selected into individual strings for each CV, so if the selection list looked like this:

    ls -selection;
    // Result: curveShape1.cv[1:3] //

Then the cvExpand command will return this instead:

    cvExpand;
    // Result: curveShape1.cv[1] curveShape1.cv[2] curveShape1.cv[3] //

## cvPosCmd

Produces MEL command cvPos

This example demonstrates how to obtain the world or local space position of a NURBS CV or a polygonal vertex.

The command accepts the flags -l/-local or -w/-world, where world is the default, to indicate whether a local or world space location of the CV is required. The command can handle at most 1 CV per invocation since it returns the coordinate as 3 element a MEL float array. If no arguments are provided to the command, it checks the active selection list. If exactly one CV or vertex is present in that list, it returns its location. If more than one is selected, an error is produced. Alternatively, a single component can be specified on the command line using MEL syntax. For example:

    cvPos nurbsSphereShape1.cv[0][0];

will return the world space position of the specified CV.

## D3DViewportRenderer (Windows only)

This plug-in demonstrates how to use Direct3D as the renderer of the scene view. It is a simple example that renders a bounding box for each polygonal surface in the Maya scene.

## dagPoseInfoCmd

Produces MEL command dagPoseInfo

This example demonstrates how to extract DAG pose info for a skeleton’s bind pose, or for other poses created using the "dagPose" command. It demonstrates using an MItSelectionList iterator to determine the selected joints, and using the MPlug class to traverse plug connections and get matrix data from the graph.

To use this plug-in, build a skeleton and bind geometry using either the "Smooth" or "Rigid" Bind feature. Then select the joints for which you want to find the bindPose, and execute the command:

    dagPoseInfo -f filename;

Please refer to the example code that describes the output format.

## ddsFloatReader

Demonstrates how to write a .dds float file reader using the API. In Maya’s image reading menu dialogs, a user can select *.* to see all images and then retrieve a dds extension file item in order to load the .dds file into Maya.

## deletedMsgCmd

This plug-in demonstrates each of the node deletion callbacks available in Maya API. This plug-in can be used to distinguish when each type of callback should be used. Callbacks are added to nodes by invoking the command:

    deletedMessage <node 1> [<node 2> ...]

This command will register 3 callbacks on the nodes.

1) MNodeMessage::addNodeAboutToDeleteCallback() is used to register an about to delete callback on the nodes.

2) MNodeMessage::addNodePreRemovalCallback() is used to register a pre-removal callback on the nodes.

3) MDGMessage::addNodeRemovedCallback() is used to register a callback that called when the node is removed.

For example, to register the callbacks for a nurbs sphere:

    sphere;
    deletedMessage nurbsSphere1;

Now delete the sphere:

    delete nurbsSphere1;
    // Removal callback node: makeNurbSphere1
    // Removal callback node: nurbsSphereShape1
    // About to delete callback for node: nurbsSphere1
    // Pre-removal callback for node: nurbsSphere1
    // Removal callback node: nurbsSphere1

## dynExprFieldTest

This plug-in implements a dynExprField node for a uniform field. This allows the per particle attributes to drive the field's attributes.

To run the plug-in, do the following:

    source dynExprFieldTest.mel
    dynExprFieldTest;

## eventTest

Produces MEL command eventTest

The eventTest plug-in is a simple plug-in that displays which "events" are occurring inside Maya. An event in Maya is something of interest to the Maya internals or plug-ins that occurs at a specific point in time. For example, "SelectionChanged" and "timeChanged" are two available events. These events can be tracked at the MEL level with the -event flag to the scriptJob command.

The plug-in adds an "eventTest" command that lets you see which events are available, track specific events, and to see which events are being tracked. The basic command syntax is:

    eventTest [-m on|off] [eventName ...]

The eventName arguments should be the names of events. If no names are specified, the command will operate on all available events.

If you use the -m flag, you can specify whether the plug-in should track messages for the specified events or not. If you specify the -m flag without any event names, it will turn on or off tracking for all events.

Example:

    mel: eventTest -m 1 timeChanged
    Event Name Msgs On
    -------------------- -------
    timeChanged yes

After this example, the plug-in will display the line:

    event timeChanged occurred

every time the current time changes. You can disable all event tracking with the command: eventTest -m off;

## exampleMRampAttribute

Produces a dependency graph node exampleRampAttrNode.

This plug-in demonstrates how to create curve and color ramps on a custom node. In addition, required coding for the AE template is included in the example.

MEL usage:

    loadPlugin exampleRampAttribute;
    createNode exampleRampAttrNode;

## exportJointClusterDataCmd

Produces MEL command exportJointClusterData

This example demonstrates how to find all joint cluster nodes and uses the MFnWeightGeometryFilter function set and MItGeometry iterator to export weights per CV for each geometry deformed by each joint cluster.

To use this plug-in, build a skeleton and bind geometry using the "Rigid Bind" feature. Then type the command:

    exportJointClusterData -f filename;

For example:

    exportJointClusterData -f "C:/temp/skinData"

The output format used is:

    jointName <skinCount>
     skin_1 <weightCount>
     <skin_1_component_index1> <skin_1_wt1>
     <skin_1_component_index2> <skin_1_wt2>
     <skin_1_component_index3> <skin_1_wt3>
     ...
     skin_2 <weightCount>
     <skin_2_component_index1> <skin_2_wt1>
     <skin_2_component_index2> <skin_2_wt2>
     <skin_2_component_index3> <skin_2_wt3>
     ...

## exportSkinClusterDataCmd

Produces MEL command exportSkinClusterData

This example demonstrates how to find all skin cluster nodes and uses the MFnSkinCluster function set and MItGeometry iterator to export weights per CV for all geometry that are bound as a skin to a skeleton.

To use this plug-in, build a skeleton and bind geometry using the "Smooth Bind" feature and execute the command:

    exportSkinClusterData -f filename;

Please refer to the example code that describes the output format.

## filterAsciiFile

Produces MEL command customSourceFile

This plug-in is an example of a user-defined MPxMayaAsciiFilter. It allows users to segment scenes into files containing various types of nodes. Users can specify which node types are exported by using the "includeType" and "excludeType" options in the file command. For example, the following would save only renderLayer nodes:

mel: file -rename "myLayerData";

mel: file -type "filteredAsciiFile";

mel: file -save -options ";includeType kRenderLayer;";

In addition, the type of connectAttrs written in the ASCII file are determined by the node types that are exported. If the source node in the connectAttr is to be output, then the connectAttr is written. In addition to allowing scenes to be segmented, this plug-in also allows ASCII files to write a line which will source other ASCII files. Use this plug-in to allow a single master file source in all of the different files containing scene segments. This is also controlled via the file command's options. The following commands illustrate how to source in the render layer segment saved in the above example:

mel: file -rename "myMasterFile";

mel: file -save -options ";excludeType kRenderLayer; sourceFile myLayerData.faf"

In the case above, the excludeType argument is used to ensure that no render layer information is output in myMasterFile. The sourceFile option outputs the following line in myMasterFile.faf:

customSourceFile -fileName "myLayerData.faf";

When this line is parsed as myMasterFile.faf is loaded, the customSourceFile command, which this plug-in also contains, is executed. It simply sources myLayerData.faf, first prepending the myMasterFile.faf's path.

## findFileTexturesCmd

Produces MEL command findFileTextures

This example demonstrates how to navigate the dependency graph both manually and using the DG iterator. The command searches the dependency graph looking for file texture nodes that are attached to the shading engine. This example also illustrates the use of filters when navigating the DG. As file texture nodes are found, information about their attributes is extracted and printed on standard error. More extensive documentation is in the source code.

To use this plug-in, load a scene that contains some texture information, and find a node (or nodes) that are being shaded by a file texture. Then execute "findFileTextures nodeName1 nodeName2 ..." to find the file textures.

## findTexturesPerPolygonCmd

Produces MEL command findTexturesPerPolygon

This example is a variation of the findFileTexturesCmd example. When a file texture node is connected to the color attribute of a shader, the file name will be extracted and printed along with the polygonal index. More extensive documentation is in the source code.

To use this plug-in, apply a shader that has a file texture node applied to the color attribute on a selected object and execute the command "findTexturesPerPolygon".

## flipUVCmd

Produces a command: flipUV

This is a simple plug-in for demonstration the use of the new MPxPolyTweakUVCommand class to manipulate UVs.

The syntax of the command is:

    flipUV [-es on|off] [-fg on|off] [-h on|off]

Flags:

-es -extendToShell on|off

-fg -flipGlobal on|off

-h -horizontal on|off

To use this plug-in:

- Select UVs from a mesh
- Invoke the flipUV command

Depending on the type of texture used, results may not show up in the modelling windows. To see the result, use the UV Editor.

## footPrintManip

Produces dependency graph node footPrintLocator and footPrintLocatorManip

This example demonstrates how to use the Show Manip Tool with a user-defined manipulator. The user-defined manipulator corresponds to the foot print locator.

To use this plug-in, just type "createNode footPrintLocator" to create a foot print locator, select the foot print, and then click on the Show Manip Tool.

## footPrintNode

Produces dependency graph node footPrint

This example demonstrates how to create a user-defined locator. A locator is a dag object that is drawn in the 3D views but that does not render. This example plug-in defines a new locator node that draws a foot print. The foot print can be selected and moved using the regular manipulators.

To use this plug-in, just type "createNode footPrint" to create a foot print locator.

## fullLoftNode

Produces dependency graph node fullLoft

This plug-in demonstrates how to take an array of NURBS curves as input and produce a NURBS surface as output. The input curves must have the same number of knots, and both form and degree are ignored.

To use this command, draw two or more curves. Select the curves and execute the MEL command "source fullLoftNode.mel". This creates the fullLoft node and an output surface, as well as several rebuildCurve nodes to provide a uniform number of CVs for the fullLoft node.

Note

This is a simplified version of the internal Maya loft node.

## getAttrAffectsCmd

Produces MEL command getAttrAffects

This command takes the name of a node as an argument. It then iterates over each attribute of the node and prints a list of the attributes that it affects and the ones that affect it. To use it issue the command "getAttrAffects nodeName", where nodeName is the name of the node whose attributes you want to display. If invoked with no arguments, getAttrAffects will display the attribute info regarding all selected nodes.

## genericAttributeNode

Produces dependency node genericAttributeNode.

This plug-in demonstrates how to create a MPxNode that contains generic attributes. Several generic attributes are added to the node and the compute() method sets its result based on a controlling type attribute.

## geometryCacheConverter

Produces MEL command convertGeometryCache

This example converts geometry cache files into an ASCII format through the IFF file API.

This plug-in only covers one aspect of parsing geometry cache data. Please see the cacheFileExample.py for a more comprehensive example. This Python script shows how to parse and interpret Maya caches (.mc). This example avoids the use of specialized IFF code so that any standalone application can learn to parse Maya cache files.

## geometrySurfaceConstraint

Produces MPxConstraint node geometrySurfaceConstraint and MEL command geometrySurfaceConstraint.

This example demonstrates how to use the MPxConstraint and MPxConstraintCommand classes to create a geometry constraint. This type of constraint will keep the constrained object attached to the target as the target is moved. The constrained object can be constrained to one of multiple targets. You can choose to constrain to the target of the highest or lowest weight. To use this plug-in, first load it and then execute:

    file -f -new;
    polyPlane -w 1 -h 1 -sx 10 -sy 10 -ax 0 1 0 -cuv 2 -ch 1;
    scale -r 15 15 15;
    polyCylinder -r 1 -h 2 -sx 20 -sy 1 -sz 1 -ax 0 1 0 -rcp 0 -cuv 3 -ch 1;
    select -cl;
    select -r pPlane1 pCylinder1;
    geometrySurfaceConstraint -weight 1;

## hairCollisionSolver

This plug-in implements a custom collision solver for Maya's dynamic hair system. It allows users to override the following aspects of Maya's dynamic hair systems:

- Override the Maya dynamic hair system's object-to-hair collision algorithm with a user-defined algorithm.
- Optionally perform global filtering on hair, such as freeze, smoothing, and so forth.

It should be noted that Maya's dynamic hair system involves four areas of collision detection, and this plug-in is specific only to the Hair-to-Object aspect.

## helixCmd

Produces MEL command helix

This is the helixCmd example from the documentation. It is a demonstration of building a simple command which does not have undo. The command accepts two arguments, "-r" to set the radius of the helix, and "-p" to set the pitch of the helix. So, to create a helix, execute the command "helix [ -r #] [ -p #]" in the command window.

A MEL script is also provided with this example which can be run by executing the command "source helixCmd".

This script creates a new "Plug-ins" menu under which the "helix" command can be found. Selecting this menu item will bring up a window that allows you to set the radius and pitch for the new helix. This is a good example of hooking up a command to the UI.

## helix2Cmd

Produces MEL command helix2

This example takes a selected curve and turns it into a helix. That in and of itself isn’t very interesting, but the plug-in implements undo and redo functions so that the change can be undone and then redone. This plug-in is then a simple example of implementing a command which supports do, undo, and redo. To use it, create a curve, then execute "helix2" in the command window. The curve will change into a helix. Select "Undo" from the "Edit" menu, and the change will be undone. Select "Redo" and it will be redone.

## helixMotifCmd

Produces MEL command helixMotif

This plug-in is only available on Linux.

This example demonstrates how to create a separate Motif window that uses the same application shell as Maya.

The new window contains a single Motif button widget labelled Create Helix that when pressed creates a helix exactly as is done in the getProjectedFacesCmd example. Maya still controls the X event loop, but arbitrary X widgets and callbacks can be registered, and they will be dispatched by Maya when their event occurs.

## helixTool

Produces MEL commands helixToolCmd and helixToolContext

This example takes the helix example one large step forward by wrapping the command in a context. This allows you to drag out the region in which you want the helix drawn. To use it, you should first execute the command "source helixTool". This will create a new entry in the "Shelf1" tab of the tool shelf called "Helix Tool". Click on the new icon, then move the cursor into the perspective window and drag out a cylinder which defines the volume in which the helix will be generated. This plug-in is an excellent example of building a context around a command.

## helloCmd

Produces MEL command hello

This is the "hello" example from the documentation. You simply type a "hello" in the command window and "Hello" will be output to the window from which you started Maya.

## helloWorldCmd

Produces MEL command helloWorld

This is the first example from the documentation. When "helloWorld" is typed into the command window "Hello World" is output to the window from which you started Maya.

## hwManagedTexture

Produces dependency node hwManagedTextureShader

Demonstrates how to use texture caching in a hardware shader efficiently. The supportsBatching() method is used in this example.

## idleTest

Produces MEL command idleTest

The idleTest plug-in shows an example of using both the idle messages and UI deleted messages in a simple plug-in. These messages correspond to the -idleEvent and -uiDeleted flags for the scriptJob command.

When you load the plug-in, it adds the command "idleTest". To run it, type "idleTest n" where n is some positive number. Idle test will then create a window and start filling it with a list of prime numbers. The test will compute one new prime number for each idle message that it receives. You will notice that idle messages stop during playback or while dragging an object.

If you type a large enough number for n, you will also notice that the idle messages will use up *all* available CPU cycles. For this reason, plug-ins should generally cancel their requests for idle messages once they are no longer needed.

When you delete the window that idleTest has created, the plug-in will receive a "UI deleted" message and cancel any outstanding idle message callbacks.

## iffInfoCmd

Produces MEL command iffInfo

This command takes as an argument the name of an IFF file. The file is opened and read and general information about the file is returned as a result. For example: "iffInfo sphere.iff"

## iffPixelCmd

Produces MEL command iffPixel

This command takes as arguments the name of an IFF file and the x and y co-ordinates of a pixel in the image. It returns the r/g/b/a values at that pixel. For example: "iffPixel sphere.iff 100 210"

## iffPpmCmd

Produces MEL command iffPpm

This command takes as arguments the names of an existing IFF file and the name of a PPM (portable pixmap) file that it should create. The IFF image is read and written out in PPM format to the second file.

For example: "iffPpm sphere.iff sphere.ppm".

## instanceCallbackCmd

This plug-in demonstrates the functionality of the MDagMessage class which allows the listening of instance related messages. The messages support listening to:

1) Instance Added for a specified node (and its instances)

2) Instance Removed for a specified node (and its instances)

3) Instance Added for any node

4) Instance Removed for any node

This plug-in works in the following manner:

i. Draws a circle,

ii. Gets its dagPath using an iterator

iii. Adds callback for instance added and removed for this circle.

The callback functions just displays a message indicating the invocation of the registered callback function.

To execute this plug-in, do the following:

    instCallbackCmd;

## instancerListCmd

Produces MEL command listParticleInstances.

This plug-in demonstrates how to use the MFnInstancer class and the MItInstancer class to enumerate particle instances in a scene. If one or more instancer nodes are selected when the command is invoked, MFnInstancer will be used to enumerate each instancer's instances, exercising both the instancesForParticle() and allInstances() methods. If no instancers are selected, then MItInstancer is used to iterate through all the particle instances in the scene.

## intersectCmd

Produces a proxy command intersectCmd.

This plug-in finds the intersection point between a mesh and a spotlight using the accelerations intersection methods of MFnMesh.

First load the plug-in and then create a spotLight and polyPlane. Execute the following:

    global proc intersectExample()
    {
    	// Make sure light and poly plane names are the same
    	intersectCmd spotLight1 pPlane1;
    	select -r spotLight1;
    }
    scriptJob -ac "spotLight1.tx" intersectExample;
    scriptJob -ac "spotLight1.ty" intersectExample;
    scriptJob -ac "spotLight1.tz" intersectExample;
    scriptJob -ac "spotLight1.rx" intersectExample;
    scriptJob -ac "spotLight1.ry" intersectExample;
    scriptJob -ac "spotLight1.rz" intersectExample;

## jitterNode

Produces dependency graph node jitter

This plug-in is an example of a user-defined procedural dependency graph node. It is primarily oriented toward animation, but can be used to add noise in any connection between two float attributes. It takes a float value as input, adds a pseudo-random value to the input and outputs the noisy float value. For example, if the output of a parameter curve node is connected to the input of the jitter node and the output of the jitter node is connected to the translateX attribute of a surface, the motion of the surface will "jitter" parallel to the X axis.

The node has one other input, "time". The output of the time slider node, "time1.outTime", should be connected to the time attribute on the jitter node if the "jittered" animation is to be repeatable. The attribute "scale" can be used to increase or decrease the magnitude of the random offset applied to the input of the jitter node.

Once the plug-in is loaded, the MEL command:

    jitter "jitter1" "someNode1.outFloat" "someNode2.inFloat";

will create the jitter node, jitter1, attach the attribute someNode1.outFloat to jitter1.input and attach jitter1.output to someNode2.inFloat. It also attaches the time slider output, time1.outTime to jitter1.time and jitter2.time.

Additionally, it creates two windows with sliders for adjusting the scale.

The jitter node can be easily demonstrated in conjunction with the circleNode plug-in. Load the circleNode and jitterNode plug-ins. Then execute the following commands:

    source circleNode
    source jitterNode
    createSphereAndAttachCircleNode;
    jitter "jitter1" "circleNode1.sineOutput" "sphere1.translateX";
    jitter "jitter2" "circleNode1.cosineOutput" "sphere1.translateZ";

Clicking the "play" icon on the time slider will cause the sphere to move along a "jittered" circle. The amount of jitter can be varied by adjusting the scale sliders in the windows "jitter1 Scale Editor" and "jitter2 Scale Editor".

## jlcVcrDevice

Registers new midi input device jlcVcrDevice

This plug-in is only available on Linux.

Loading this plug-in will register the JL-Cooper midi VCR input device with Maya as type jlcVcrDevice.

To use the device, execute the MEL script "jlcVcrDevice.mel". This will attach the buttons on the midi device to the animation playback commands in Maya as follows:

- The play button will start animation playback.
- The stop button will stop animation playback.
- The rewind button sets the current time to the start time in the range control.
- The forward button sets the current time to the end time in the range control.
- The rec button executes the setKeyframe command.
- The scrub wheel moves the time forward and back.

To get a list of all input devices currently registered in Maya, use the command listInputDevices.

## latticeNoise

Produces dependency graph node latticeNoise and MEL command latticeNoise

This plug-in is an example of the following:

- how to have node attributes input and output geometry
- how to modify dependency graph connections using the API
- how to take Maya objects as arguments to a user defined MEL command

The latticeNoise command creates a new lattice deformer around the currently selected geometry, or around the objects specified on the command line. The command also inserts a latticeNoise node in between the lattice shape in the DAG and the node that performs the deformation.

The end effect of the latticeNoise command is that the objects inside the lattice deform with respect to the lattice, but they also wobble about randomly as noise is applied to the lattice points. The latticeNoise node has attributes for amplitude and frequency that control the amount of noise applied.

An example of using the command is:

    latticeNoise nurbsSphereShape1 nurbsConeShape1;

## lensDistortionCallback

Produces a command lensDistortionCallback.

This plug-in demonstrates how to enable multiple draw-passes with the M3dView class and add the pre and post rendering callbacks to each pass by the MUiMessage class.

A distortion effect is added to the model view for previewing lens distortion that uses decomposed radial and tangential distortion coefficient.

Some essential attributes must first be added to the camera node. The following is a sample MEL script that adds essential attributes to a perspective camera and sets example values to attributes that affect the lens distortion result.

    select perspShape;
    // Add extra attributes
    addAttr -at bool -ln "previewLensDistortion" -sn "pld" -dv 1;
    addAttr -at long -ln "previewResolutionX" -sn "prx" -dv 40 -min 1 ;
    addAttr -at long -ln "previewResolutionY" -sn "pry" -dv 30 -min 1 ;
    addAttr -at long -ln "renderResolutionX" -sn "rrx" -dv 1920 -min 1 ;
    addAttr -at long -ln "renderResolutionY" -sn "rry" -dv 1080 -min 1 ;
    addAttr -at double -ln "principalPointX" -sn "ppx" -dv 963.893;
    addAttr -at double -ln "principalPointY" -sn "ppy" -dv 541.666;
    addAttr -at double -ln "radialDistortionCoef1" -sn "rdc1" -dv 0.00677651;
    addAttr -at double -ln "radialDistortionCoef2" -sn "rdc2" -dv -0.000162221;
    addAttr -at double -ln "tangentialDistortionCoef1" -sn "tdc1" -dv -0.0005091;
    addAttr -at double -ln "tangentialDistortionCoef2" -sn "tdc2" -dv -5.55102e-005;
    addAttr -at double -ln "scaleFactor" -sn "sf" -dv 1.0;
    addAttr -at bool -ln "drawWireframe" -sn "sdw" -dv 1;
    // Setup camera focal/film attributes.
    setAttr .focalLength 4.674975;
    setAttr .horizontalFilmAperture 0.3774;
    setAttr .verticalFilmAperture 0.2122;
    setAttr .horizontalFilmOffset -0.00132157;
    setAttr .verticalFilmOffset 0.000327253;
    setAttr .filmFit 2;
    // Setup camera display attributes.(Additional)
    setAttr .displayResolution 1;
    setAttr .overscan 1.5;
    // Setup rendering resolution.
    setAttr defaultResolution.width 1920;
    setAttr defaultResolution.height 1080;
    setAttr defaultResolution.deviceAspectRatio 1.777778;

The following is a sample MEL command for using this plug-in once it is loaded:

    lensDistortionCallback `getPanel -withFocus`;

Note

The screen does not refresh right after the plug-in executes. You must refresh the screen with a tumbling camera.

## lepTranslator

Adds the new file format Lep to the file manipulation dialogs

As soon as this plug-in is loaded, the new file format will be available in the "Open", "Import, and "Export" dialogs.

The icon that is displayed in the file selection boxes is the one that is contained in the file lepTranslator.rgb that is also located in the example plug-in directory. Maya will find this icon as long as the path to the directory that contains it is included in FILE_ICON_PATH environment variable.

An "Lep" file is an ASCII file with a first line of "<LEP>". The remainder of the file contains MEL commands that create one of the primitives: nurbsSphere, nurbsCone and nurbsCylinder, as well as move commands to position them.

When writing the file, only primitives of these three types will be created along with their positions in 3D space. The reader routine will actually handle more MEL commands than these, but only this limited set of types will be written.

As well, this example demonstrates how to utilize file options. When saving a file, if you click on the option box beside the File > Export All menu item, a dialog will pop up that contains two radio boxes asking whether to "Write Positions". The default is true, and if false is selected, then the move commands for primitives will not be written to the output file. This dialog is implemented by the MEL script, lepTranslatorOpts.mel which is also located in the plug-in directory.

An sample input file is supplied in the example plug-in directory as lepTranslator.lep.

## listLightLinksCmd

Produces MEL command listLightLinks.

This example demonstrates how to use the MLightLinks class to query Maya's light linking information. The command takes no arguments.If the currently selected object is a light, then the command will select all objects illuminated by that light. If the currently selected object is a piece of geometry, then the command will select all the lights that illuminate that geometry.

## listPolyHolesCmd

Produces MEL command listPolyHoles.

This example demonstrates how to use the MFnMesh::getPolyHoles() function to describe all the holes in a polygon mesh. The command takes no arguments. When invoked, the command outputs a description of any holes in the currently selected mesh to the Output Window (on Windows), or to the console (on the Linux platform).

## lockEvent

Produces MEL command lockEvent

This plug-in demonstrates the API callbacks for node and plug locking. These callbacks allow you to receive notification when the locked status of a plug or node is queried internally. The API programmer has the option, upon receipt of the callback, to override/(-o) the lock state of node or plug. This override is controlled via a decision variable passed into the callback function. The variable can hold two values

1. decision = true --> You want to accept the lock state and do whatever the internal default behavior is.

2. decision = false --> You want to deny the lock state and do the opposite of what Maya would usually do.

The flow of execution would be as follows:

1. Received a callback from Maya.

2. What kind of event is this?

3. Do I want to allow this event?

4. Yes, I do not want to OVERRIDE this event. decision = true.

4. No, I want to OVERRIDE this event. decision = false.

5. Return from callback.

Example usage:

     sphere ;
     // Watch the translateX plug on the sphere we just created
     lockEvent -a 3 nurbsSphere1.translateX;
     // Do not allow any changes to the plug.
     lockEvent -o true;
     // Now you can try changes nurbsSphere1.translateX 's value
     // but you will not be allowed to do so.
     //
     setAttr "nurbsSphere1.translateX" 22;

## maTranslator

Produces file translator Maya ASCII (via plug-in)

This plug-in is an example of a file translator. Although this is not the actual code used by Maya when it creates files in MayaAscii format, it nonetheless produces a very close approximation of the same format. Close enough that Maya can load the resulting files as if they were MayaAscii.

Currently, the plug-in does not support the following:

- Export Selection. The plug-in will only export entire scenes.
- Referencing files into the default namespace, or using a renaming prefix. It only supports referencing files into a separate namespace.
- MEL reference files.
- Size hints for multi plugs.

To use this plug-in, load it and then invoke it through the Export All menu item.

## marqueeTool

Produces MEL command marqueeToolContext

This is another context example, except that this example does not have an associated command. To use it, you must execute the command "source marqueeTool" in the command window. This will create a new entry in the "Shelf1" tab of the tool shelf called "Marquee Tool". When this tool is active, you can select objects in the 3D windows in the same way that you would with the selection tool, that is it can be used for either click selection, drag selection. Both will also work with the shift key held down in the same manner as the selection tool.

## meshOpCmd

Produces command meshOp. Produces dependency node meshOpNode.

Demonstrates the use of the new high level polygon API methods that have been added to MFnMesh.

Syntax: meshOp $operationType

$operationType is one of:

0 - Subdivide edge(s).

1 - Subdivide face(s).

2 - Extrude edge(s).

3 - Extrude face(s).

4 - Collapse edge(s).

5 - Collapse face(s).

6 - Duplicate face(s).

7 - Extract face(s).

8 - Split face(s).

Example usage:

- Select the appropriate component (edge, face)
- meshOp 2;

Note: this plug-in re-uses the following files from the splitUVCmd

- polyModifierNode.cpp
- polyModifierCmd.cpp
- polyModifierFty.cpp

## motionPathCmd

Produces MEL command motionPath

This plug-in assigns a curve as a motion path to an object. To use it, create an object and draw a curve. Clear all selected items, then pick the object followed by the curve (order is important). Once both are selected, execute "motionPath" in the command window, then click the play button. The object will move along the curve. This is a simple example of how to use the motion path function set.

## motionTraceCmd

Produces MEL command motionTrace

In order to use this plug-in you must first create an object and animate it by setting keyframes. An easy way to do this is to just create a primitive, then set a bunch of keyframes for it with the spiralAnimCurveCmd plug-in.

Once this is done, select the animated object and invoke "motionTrace". The object will move along its animated path under control of the plug-in and when the animation is complete, the plug-in will draw a curve into the scene that represents the motion path of the object.

The plug-in accepts -s, -e, and -b parameters to control the startFrame, endFrame and byFrame values that it uses in running the animation.

## moveCurveCVsCmd

Produces MEL command moveCurveCVs

This is a simple little plug-in which takes the selected CVs of a NURBS curves and moves them to the origin. Of itself it’s not a very practical plug-in, but it demonstrates retrieving CVs from a selection list and the use of the Curve CV iterator.

To use it, you must draw a curve, switch Maya from Object selection mode to Component selection mode, the pick some or all of the CVs of the curve. Then, type the command "moveCurveCVs" in the command window to move the CVs.

## moveManip

Produces MEL command moveManipContext to create the example context.

To use this plug-in, execute the command "source moveManip". This creates a new entry in the "Shelf1" tab of the tool shelf, called "moveManip". Create a sphere and click on the moveManip icon on the shelf. A free point triad manipulator will appear when the object is selected.

## moveNumericTool

Produces MEL commands moveNumericToolCmd and moveNumericToolContext

This is an example of a selection-action tool that allows the user to type in precise translation values to while in the move tool. Once an object is selected, the tool turns into a translation tool. In this mode, the user can type in numeric values in the numeric input field to translate the object.

This tool only supports the translation of transforms, and will only perform translation in orthographic views. Undo, redo, and journaling are supported by this tool.

To use this plug-in, execute the command "source moveNumericTool". This creates a new entry in the "Shelf1" tab of the tool shelf, called "moveNumericTool". Click on the new icon, then select an object and drag it around in an orthographic view. With the object still selected, type in the numeric input field to enter a specific translation. You can specify whether you want absolute or relative translation values by clicking on the button to the left of the numeric input field.

## moveTool

Produces MEL commands moveToolCmd and moveToolContext

This is an example of a selection-action tool. When nothing is selected, this tool behaves in exactly the same way as Maya’s selection tool. Once an object is selected, the tool turns into a translation tool.

Note that at this time, the plug-in can translate:

- transforms
- NURBS curve CVs
- NURBS surface CVs
- polygonal vertices

This plug-in will only perform translation in orthographic views. Undo, redo, and journaling are supported by this tool.

To use this plug-in, execute the command "source moveTool". This creates a new entry in the "Shelf1" tab of the tool shelf, called "moveTool". Click on the new icon, then select an object and drag it around in an orthographic view. The left mouse button allows movement in two directions, while the middle mouse button constrains the movement to a single direction.

## moveManip

Produces MEL command moveManipContext to create the example context.

To use this plug-in, execute the command "source moveManip". This creates a new entry in the "Shelf1" tab of the tool shelf, called "moveManip". Create a sphere and click on the moveManip icon on the shelf. A free point triad manipulator will appear when the object is selected.

## multiCurveNode

Produces dependency graph node multiCurve

This plug-in demonstrates how to use the MArrayDataBuilder class to create an array attribute in a compute function, the number of elements of which change on each compute cycle.

The node accepts a nurbsCurve as input, and outputs an array of nurbsCurves as outputs. The number of curves is controlled by the attribute numCurves and the spacing between each of the output curves is controlled by the attribute curveOffset. Both numCurves and curveOffset are keyable.

To use this plug-in, load it then execute the MEL command "source multiCurveNode.mel". This will create a curve, hook it up to an instance of a multiCurve node, keyframe the numCurves and curveOffset attributes, and then hook the output of the multiCurve node to a curveVarGroup node which will display all the output curves. Once this script has been run, push play and as the animation progresses, new curves will be created and the spacing between them will increase.

## nodeInfoCmd

Produces MEL command nodeInfo

This plug-in demonstrates how to query a dependency node for its type and for the plugs connected to it. It iterates over the selected items and for each item it prints the following:

- the type of the current selection item’s dependency node
- the number of plugs connected to the node
- name/attribute information for each connected plug
- the node type(s) that each connected plug is a destination of

To use it, select some objects, then execute "nodeInfo" in the command window. The node information will be printed in the window from which you started Maya.

## nodeMessageCmd

Produces MEL command nodeMessage

This plug-in that demonstrates how to register/de-register a callback with the MNodeMessage class. This plug-in will register a new command in Maya called "nodeMessage" which adds a callback for the all nodes on the active selection list. A message is printed to stdout whenever a connection is made or broken for those nodes.

## NodeMonitor

This class monitors a given node.

## offsetNode

Produces dependency graph node offsetNode

This plug-in demonstrates how to create a user-defined weighted deformer with an associated shape. A deformer is a node which takes any number of input geometries, deforms them, and places the output into the output geometry attribute. This example plug-in defines a new deformer node that offsets vertices according to their CV’s weights.

To use this node:

- create a plane or some other object
- type: "deformer -type offset"
- a locator is created by the command, and you can use this locator to control the direction of the offset. The object’s CV’s will be offset by the value of the weights of the CV’s (the default will be the weight * some constant) in the direction of the y-vector of the locator
- you can edit the weights using either the component editor or by using the percent command (eg. percent -v .5 offset1;)

## ownerEmitter

Produces dependency graph node ownerEmitter

This node is an example of a particle emitter that emits in a direction from multiple points defined by a particle shape.

There is an example MEL script "ownerEmitter.mel" that shows how to create the node and appropriate connections to correctly establish a user defined particle emitter.

## OpenGLViewportRenderer

This plug-in demonstrates how to use a user defined scene view renderer for the OpenGL API.

## particleAttrNode

Produces dependency node particleAttr.

The particleAttrNode is an example node that extends the MPxParticleAttributeMapperNode type. These nodes allow us to define custom nodes to map per-particle attribute data to a particle shape.

In this particular example, we have defined two operations:

- compute2DTexture()
- computeMesh()

The compute2DTexture() replicates the internal behavior of Maya's internal 'arrayMapper' node at the API level. Given an input texture node and a U/V coordinate per particle input, this node will evaluate the texture at the given coordinates and map the result back to the outColorPP or outValuePP attributes. See the method description for compute2DTexture() for details on how to setup a proper attribute mapping graph.

The computeMesh() is a user-defined operation. It is called when the 'computeNode' attribute is connected to a polygonal mesh. Given a particle count, it then maps the object space vertex positions of the mesh to a user-defined 'outPositions' vector attribute. This 'outPositions' attribute can then be connected to drive one of the shape’s vector typed, per-particle attribute. In the given example, the particle shape's 'rampPosition' attribute is being driven. For further details, see the computeMesh() method description for information on how to setup this example.

## particlePathsCmd

This example plug-in produces the MEL command "particlePaths" that demonstrates how particle ID information can be used to trace out curves from particle positions over time.

The following sequence of commands will create a set of curves for a particle explosion:

    emitter -type omni -r 15 -sro 0 -nuv 0 -cye none -cyi 1 -spd 1 -srn 0 -nsp 1 -tsp 0 -mxd 0 -mnd 0 -dx 1 -dy 0 -dz 0 -sp 0;
    particle ;
    connectDynamic -em emitter1 particle1;
    select -r particleShape1;
    gravity -pos 0 0 0 -m 0.5 -att 0 -dx 0 -dy -1 -dz 0 -mxd -1 -vsh none -vex 0 -vof 0 0 0 -vsw 360 -tsr 0.5;
    connectDynamic -f gravityField1 particle1;
    particlePaths -s 0 -f 4 -i 0.5 particleShape1;

The command uses the function set MFnParticleSystem to sample particle positions and identifiers at discrete points in time.

The command supports the options –s (start time), -f (finish time), and –i (increment period). The particle positions will be sampled starting from the start time through to the finish time in increments of the increment time. The accumulated particle positions will be passed to the MFnNurbsCurve function set to create curves from the accumulated data.

## particleSystemInfoCmd

Produces command particleSystemInfo

Demonstrates the use of the new MFnParticleSystem class for retrieving particle information. The number of particle positions followed by the positions are printed to the script editor.

Syntax:

    particleSystemInfo $particleNodeName;

Example:

    particleSystemInfo particleShape2;

## pfxInfoCmd

Produces a command pfxInfo.

This plug-in demonstrates how to extract paint effects render line information from a Maya scene. Load the plug-in and a Maya scene that contains paint effects information, then execute the following:

    // Get all data
    pfxInfo strokeShape2;
    // Or
    pfxInfo strokeShape2 "all";
    // Only line and width
    pfxInfo pfxHairShape2 "lineAndWidth";
    // Just line
    pfxInfo strokeShape1 "line";

The render line information will be written to the MEL editor.

## pickCmd

Produces MEL command pick

This simple plug-in demonstrates the pick-by-name functionality. Simply execute "pick <object_name>" in the command window. Also some pattern matching is possible, i.e. "pick surface*" which will pick all objects whose name begins with "surface".

## pnTrianglesNode

This plug-in is ATI Radeon specific. It is a hardware shader plug-in to perform:

- ATI PN triangle tessellation on geometry, if the extension ATI_pn_triangles is supported in hardware.
- A simple vertex program using EXT_vertex_program, if the extension is supported.
- A simple fragment program using AT_fragment_program, if the extension is supported.

This is an excerpt from the PN triangle extension specification:

"When PN Triangle generation is enabled, each triangle-based geometric primitive is replaced with a new curved surface using the primitive vertices as control points. The intent of PN Triangles are to take a set of triangle-based geometry and algorithmically tessellate it into a more organic shape with a smoother silhouette. The new surface can either linearly or quadratically interpolate the normals across the patch. The vertices can be either linearly or cubically interpolated across the patch. Linear interpolation of the points would be useful for getting more sample points for lighting on the same geometric shape. All other vertex information (colors, texture coordinates, fog coordinates, and vertex weights) are interpolated linearly across the patch."

## pointOnMeshInfo

This plug-in defines both a MEL command and a DG node which computes the worldspace position and normal on a poly mesh given a face index, a U-parameter and a V-parameter as input.

The concept of this plug-in is based on the pointOnSurface MEL command and pointOnSurfaceInfo node. The pointOnSubdNode.cpp plug-in example from the Maya API Devkit was also used for reference.

The MEL script AEpointOnSurfaceInfoTemplate.mel was referred to for the AE template MEL script that accompanies the pointOnMeshInfo node.

## pointOnSubdNode

Produces dependency graph command pointOnSubd

This node is a simple example of how to query a subdivision surface as an input to a dependency node. This node takes a subdivision surface and a parameter point on subdivision surface and outputs the position and the normal of the surface at that point. The MEL script "connectObjectToPointOnSubd.mel" that accompanies this plug-in contains detailed documentation on how to use the node and itself provides a demonstration of that use.

## polyMessageCmd

This plug-in demonstrates how to register/de-register a callback with the MPolyMessage class.

This plug-in will register a new command in Maya called "polyMessage" which adds a callback for the all nodes on the active selection list. A message is printed to stdout whenever component ids for those nodes are changed.

To run this plug-in, do the following:

    // create a poly plane
    // open the outliner and select the poly shape
    // Run the plug-in
    polyMessage
    // select some vertices of the poly shape
    // hit the delete key to see the remapped ids of the edges, vertices and faces written out

## polyPrimitiveCmd

Produces MEL command polyPrimitive

This plug-in creates several types of polygon primitives and demonstrates the creation of polygonal data. Once it is loaded, executing "polyPrimitive #", where "#" is an integer between 1 and 7, in the command window will cause a polygon to be created at the origin.

If you execute the command "source polyPrimitiveCmd", the script polyPrimitiveCmd.mel will be run. After this, if the command "polyPrimitiveMenu" is executed, it will bring up a window which allows you to create these objects simply by clicking a button.

## polyTrgNode

This plug-in demonstrates how to add user defined triangulation for meshes using the new poly API class, MPxPolyTrg.

The node registers a user defined face triangulation function. After the function is registered it can be used by any mesh in the scene to do the triangulation (replace the mesh native triangulation). In order for the mesh to use this function, an attribute on the mesh ‘userTrg’ has to be set to the name of the function.

Different meshes may use different functions. Each of them needs to be registered. The same node can provide more than one function.

Example:

    createNode polyTrgNode -n ptrg;
    polyPlane -w 1 -h 1 -sx 10 -sy 10 -ax 0 1 0 -tx 0 -ch 1 -n pp1;
    select -r pp1Shape;
    setAttr pp1Shape.userTrg -type "string" "triangulate";

## progressWindowCmd

This plug-in demonstrates how to use the MProgressWindow class. The command "progressWindowPlugin" displays a simple progress window which updates every second. The progress window can be terminated by hitting escape.

To run this plug-in, do the following:

    progressWindowCmd;

A progress window will be displayed. It should be noted that Maya can only display one progress window at a time. MEL also supports creating a progress window. Program errors may occur if the progress windows of MEL and the API are being called at the same time.

## quadricShape

Produces shape node quadricShape

This plug-in registers a new type of shape with Maya called "quadricShape". This shape will display spheres, cylinders, disks, and partial disks using the OpenGL gluQuadric functions.

For example, to create a sphere:

createNode quadricShape -n qSphere;

setAttr qSphere.shapeType 3;

It should be noted that there are no output attributes for this shape.

The following input attributes define the type of shape to draw.

- shapeType : 0=cylinder, 1=disk, 2=partialdisk, 3=sphere
- radius1 : cylinder base radius, disk inner radius, sphere radius
- radius2 : cylinder top radius, disk outer radius
- height : cylinder height
- startAngle : partial disk start angle
- sweepAngle : partial disk sweep angle
- slices : cylinder, disk, sphere slices
- loops : disk loops
- stacks : cylinder, sphere stacks

## referenceQueryCmd

Produces MEL command referenceQuery

This example provides useful information about referenced files in the main scene. For each referenced file, the output format is as follows:

    Referenced File: filename1
     Connections Made
     sourceAttribute -> destinationAttribute
     ...
    Connections Broken
     sourceAttribute -> destinationAttribute
     ...
    Attributes Changed Since File Referenced
     attribute1
     attribute2
     ...

To use the plug-in, open a scene file that contains file references. Execute the MEL command "referenceQuery". The reference information is written to standard output

## renderAccessNode

Produces dependency graph node renderAccessNode

This example demonstrates how to work with render callbacks. The plug-in will register a render callback, a shadow cast callback, and a post-process callback. When a render starts, render callback will be invoked, providing info related to the render's size. Then if shadow maps exist in the render, shadow cast callback will be invoked after shadow maps have been calculated, providing data to the shadow maps. Finally after geometry's have been rendered, post-render callback will be invoked, providing pointers to the rendered pixels.

The plug-in will modify the rendered image in post-process callback to demonstrate how to manipulate the pixels. The attribute pointWorld will be converted to screen space and back to test MRenderData::worldToScreen() and MRenderData::screenToWorld().

## renderViewInteractiveRenderCmd

A new example that demonstrates the immediate feedback setting that has been added to the startRender() methods of the MRenderView class. After loading this plug-in, execute the following to see what options it supports:

    help renderViewInteractiveRender;

## renderViewRenderCmd

Produces MEL command renderViewRender

This example demonstrates how to render a full image to the Render View window using the MRenderView class. The command takes no arguments. It renders a 640x480 image tiled with a red and white circular pattern to the Render View.

## renderViewRenderRegionCmd

Produces MEL command renderViewRenderRegion

This example demonstrates how to use the MRenderView class to update the currently selected Render Region in Maya's Render View. The command takes no arguments, and always updates the Render Region with a blue and white circular pattern. The command assumes that the Render View is currently displaying a 640x480 image (such as the one generated by the 'renderViewRender' example command).

## rotateManip

The rotateManip is a manipulator plug-in that demonstrates the rotate base manipulator function set. This example produces the MEL command rotateContext to create the tool context for this manipulator.

To create the tool button for the plug-in, create a new shelf named "Shelf1" and execute the following MEL commands to create the tool button in this shelf:

    rotateContext;
    setParent Shelf1;
    toolButton -cl toolCluster -t rotateContext1 -i1 "moveManip.xpm";

To use the manipulator, select an object and click on the new tool button. A rotate manipulator should appear on the object along with a state manipulator nearby. The plug-in rotate manipulator is configured to behave similarly to the built-in rotate manipulator. The state manipulator can be used to choose the mode for the rotate manipulator, which can be one of object space mode, world space mode, gimbal mode, and object space mode with snapping enabled.

## sampleCmd

Produces MEL command sampleCmd

This example demonstrates how to sample shading group/node using MRenderUtil::sampleShadingNetwork().

The command takes lists of shading info such as pointCamera and UVs, and samples a given shading group/node and returns the result colors and transparencies. Lighting will be calculated if a shading group is sampled. Shadows can be calculated as well if the -shadow flag is specified. For example:

    sampleCmd file1.outColor 4 -uvs 0 0 1 0 1 1 0 1;
    sampleCmd creater1.outColor 4 -refPoints 0 0 0 1 0 0 1 0 1 0 0 1;

sampleCmd -h provides more details on how to use the command.

## sampleParticles

Produces MEL command sampleParticles

This example demonstrates how to sample shading groups or nodes using MRenderUtil::sampleShadingNetwork() to assign colors to a particle object.

The command takes lists of shading info such as pointCamera and UVs, and samples a given shading group or node, then assigns the sampled colors and transparencies to a grid of particles using the emit command. Lighting will be calculated if a shading group is sampled. Shadows can be calculated if the -shadow flag is specified.

- sampleParticles -h provides more details on how to use the command.
- The MEL script, sampleParticles.mel demonstrates how to use this command.

## scanDagCmd

Produces MEL command scanDag

This plug-in demonstrates walking the DAG using the DAG iterator class. To use it, create a number of objects anywhere in the scene, then execute the command scanDag. This will traverse the DAG printing information about each node it finds to the window from which you started Maya. The plug-in contains specific knowledge of cameras, lights, and NURBS surfaces, and will print object type specific information for each of these.

As well, the command accepts several flags:

-b/-breadthFirst | Perform breadth first search
-d/-depthFirst | Perform depth first search
-c/-cameras | Limit the scan to cameras
-l/-lights | Limit the scan to lights
-n/-nurbsSurfaces | Limit the scan to NURBS surfaces

## scanDagSyntax

Produces MEL command scanDagSyntax

This command plug-in provides the same functionality as scanDagCmd except that the syntax parsing is performed via syntax objects. The command accepts several flags:

-b/-breadthFirst | Perform breadth first search
-d/-depthFirst | Perform depth first search
-c/-cameras | Limit the scan to cameras
-l/-lights | Limit the scan to lights
-n/-nurbsSurfaces | Limit the scan to NURBS surfaces

## ShadingConnection

This class stores useful information about a shader's attribute, including what's connected upstream of it. It also automatically passes through shader switches.

## ShapeMonitor

The ShapeMonitor is a singleton class that watches shape or texture nodes, and keep track of which one changed since the last export. It is used to keep the IFX scenegraph up-to-date in respect to textures.

Client code can:

- Ask for a pointer to the ShapeMonitor. (using the instance() function) If it doesn't already exist, it is created.
- Ask the ShapeMonitor to watch a specific Maya node name (specifying whether it's a texture, or a shape) and give a unique texture name. Doing so creates some callbacks on the specified node, so that we know when it changes. When a specific node changes, it's unique name is appended to the list (actually, set) of dirty textures.
- Ask for the list of dirty textures. Those should be removed from the IFX scenegraph, and will possibly be regenerated, if they still exist.
- Clear the list of dirty textures.

Additionally, once the ShapeMonitor is no longer necessary (for example, the scene is being closed), it can be destroyed using the destroy() function. Finally, all callbacks and data structures can be cleared by calling the initialize() function.

## shellNode

Produces dependency graph node shell

This plug-in demonstrates how to generate a complex mesh object procedurally. It also demonstrates how to customize the attribute editor for a node.

To use the plug-in, enter the MEL command "shell" to create a new shell node. A mesh object will also be created to display the output. Open the attribute editor for the new shell node to see custom controls for picking various sea shell presets. The attribute editor layout is created by the file AEShellTemplate.mel and provides a complex example of how to create an attribute editor template.

## shiftNode

Produces dependency graph node shiftNode

This plug-in demonstrates modifying uvCoord and refPointCamera from within a texture plug-in. The uvCoord and refPointCamera are marked as "renderSource" attributes. The uvCoord and refPointCamera for the current sample position are requested and then subsequently shifted four times. Each time these attributes are modified, the inColor attribute is requested, and because the attributes are render sources, the request for inColor forces a shading evaluation. Thus the 2D or 3D texture connected to inColor will be evaluated four additional times for every point shaded. The inColor values are averaged which produces a blurred result.

## simpleEmitter

Produces dependency graph node simpleEmitter

This node is an example of a particle emitter that emits in a direction from a single position.

There is an example MEL script "simpleEmitter.mel" that shows how to create the node and appropriate connections to correctly establish a user defined particle emitter.

## simpleFluidEmiter

Produces dependency graph node simpleFluidEmitter.

This example demonstrates how to use the new MPxFluidEmitterNode class to implement most of the functionality of Maya’s standard fluid emitters.

MEL usage:

    createNode simpleFluidEmitter -name simpleFluidEmitter;
    // create particle object and connect to the plugin emitter node.
    particle -name particles ;
    connectDynamic -em simpleFluidEmitter particles;
    setAttr "simpleFluidEmitter.rate" 200;
    setAttr "simpleFluidEmitter.speed" 25;
    playbackOptions -e -min 0.00 -max 60.0;
    currentTime -e 0;
    play -wait -forward true;
    // make some keyframes on emitter
    currentTime 0 ;
    select -r simpleFluidEmitter ;
    setKeyframe "simpleFluidEmitter.tx";
    setKeyframe "simpleFluidEmitter.ty";
    setKeyframe "simpleFluidEmitter.tz";
    setKeyframe "simpleFluidEmitter.rx";
    setKeyframe "simpleFluidEmitter.ry";
    setKeyframe "simpleFluidEmitter.rz";
    currentTime 30 ;
    move -r -2.011944 6.283524 -2.668834 ;
    move -r -ls -wd 0 0 12.97635 ;
    rotate -r -os 0 -75.139762 0 ;
    setKeyframe "simpleFluidEmitter.tx";
    setKeyframe "simpleFluidEmitter.ty";
    setKeyframe "simpleFluidEmitter.tz";
    setKeyframe "simpleFluidEmitter.rx";
    setKeyframe "simpleFluidEmitter.ry";
    setKeyframe "simpleFluidEmitter.rz";
    currentTime 60 ;
    move -r 0 0 -14.526107 ;
    move -r 0 -8.130523 0 ;
    rotate -r -os 0 0 78.039751 ;
    rotate -r -os 0 0 53.86918 ;
    setKeyframe "simpleFluidEmitter.tx";
    setKeyframe "simpleFluidEmitter.ty";
    setKeyframe "simpleFluidEmitter.tz";
    setKeyframe "simpleFluidEmitter.rx";
    setKeyframe "simpleFluidEmitter.ry";
    setKeyframe "simpleFluidEmitter.rz";

## simpleImageFile

Simple Image File plug-in. This plug-in registers a new image file format against file extension .moo. Loading any.moo image file will produce a procedurally generated color spectrum, including values outside of 0 to 1.

## simpleLoftNode

Produces dependency graph node userLoft

This plug-in demonstrates how to accept geometry as an input, and create geometry for output. A NURBS curve is input to the node, and from it a NURBS surface is created. The resulting geometry is passed to an internal Maya node which displays it and allows it to be positioned.

To use this node, first draw a curve in the X-Y plane. Then execute the MEL command "simpleLoftNode.mel" that contains the following commands:

    createNode transform -n simpleLoft1;
    createNode nurbsSurface -n simpleLoftShape1 -p simpleLoft1;
    createNode simpleLoft -n simpleLoftNode1;
    connectAttr curveShape1.local simpleLoftNode1.inputCurve;
    connectAttr simpleLoftNode1.outputSurface simpleLoftShape1.create;

This creates a nurbsSurface node and hooks the result into the world for display. It then creates a simpleLoft node, and connects its input to curveShape1 (the geometry from the first curve drawn), and connects its output to the NURBS surface node.

A surface will now appear on the screen. If the CVs of the original curve are selected and moved, the surface will be reconstructed to match.

## simpleSolverNode

Registers IK solver simpleSolverNode

Loading this plug-in will register a new IK solver with Maya as type simpleSolverNode. To use the solver, create a single IK bone with 2 joints using the Joint tool, then enter the following command in the command window to create an IK handle which uses the new solver:

    ikHandle -sol simpleSolverNode -sj joint1 -ee joint2

Moving the handle in the x-y plane will rotate the joint.

The command:

    ikHandle -q -sol handleName

can be used to determine which solver a handle is using.

## simpleSpring

Produces dependency graph node simpleSpring

This node is an example of a spring node that calculates the spring behavior that Maya will use in a simulation.

There is an example MEL script "simpleSpring.mel" that shows how to create the node and appropriate connections to correctly establish a user defined spring law.

## sineNode

Produces dependency graph node sine

This plug-in is a simpler version of circleNode. It takes a single input value and outputs the sine of this multiplied by 10. It’s a simple example of creating a procedural animation. Below are a simple set of commands to attach this node to a sphere:

    sphere -n sphere;
    createNode sine -n sine1;
    connectAttr sine1.output sphere.tx;
    connectAttr time1.outTime sine1.input;

Once this is done, as the time changes the sphere will roughly move along the X axis in a periodic manner.

(Roughly because the input is normally 1 through 48 and the compute method of the sine node just takes the sine of the input, which should be radians.)

## spiralAnimCurveCmd

Produces MEL command spiralAnimCurve

This plug-in attaches anim curves to the X, Y, and Z translation attributes of the selected objects, and then animates the object along a spiral path. This is a good example of attaching a anim curve to the attributes of an object.

To use it, select an object (or objects) in the Maya perspective window, the execute the command "spiralAnimCurve". Next click on the "play" button on the time slider at the bottom right of the screen. The selected objects will move in a spiral as the animation plays.

## splitUVCmd

The splitUV command unshares or "splits" the selected UVs of a polygonal mesh. It is also a good example of how to write poly operation nodes that properly deal with history, tweaks, etc. For a thorough explanation of creating this command, refer to the splitUVCmd example in the "Working with the polyAPI" chapter of the <PalItal>Maya Developer’s Tool Kit.

## stringFormatNode

Produces dependency node stringFormat.

This plug-in is an example of a user-defined dependency graph node. It takes several numbers as input, as well as a format string. It generates a formatted string as an output.

All occurrences of ^[0-9][dft] are replaced with the corresponding input parameter using the specified format.

- d means output as an integer.
- f means output as a floating point value.
- t means output as a timecode.

For example, the string "format ^1f ^2d ^0t end format", using the array {2.3, 3.4, 4.5} as an input will generate the result "format 3.4 4 00:00:02 end format"

## surfaceBumpManip

The surfaceBumpManip is a manipulator plug-in that demonstrates how the pointOnSurface base manipulator can be used. This example produces the MEL command surfaceBumpContext to create the tool context for this manipulator.

To create the tool button for the plug-in, create a new shelf named "Shelf1" and execute the following MEL commands to create the tool button in this shelf:

    surfaceBumpContext;
    setParent Shelf1;
    toolButton -cl toolCluster -t surfaceBumpContext1 -i1 "moveManip.xpm";

To use the manipulator, create a NURBS sphere and select the tool button. A manipulator should appear on the surface of the sphere. Moving the manipulator over the surface of the sphere will cause the surface to be modified near the manipulator by moving a CV out along the sphere normal.

## surfaceCreateCmd

Produces MEL command surfaceCreate

This plug-in creates a NURBS surface by supplying its own CVs and knots. To use it, just enter the command "surfaceCreate".

## surfaceTwistCmd

Produces MEL command surfaceTwist

To use this command, you must first create and select a number of NURBS surfaces or polygons (a fun surface to twist is the one created by the surfaceCreateCmd command). Then enter the command "surfaceTwist" and all selected surfaces will be twisted around the y-axis.

This command demonstrates how to access and modify the CVs of a NURBS surface or the vertices of a polygon.

## sweptEmitter

Produces dependency graph node sweptEmitter

This node is an example of a particle emitter that emits in a direction from a curve or surface.

There is an example MEL script "sweptEmitter.mel" that shows how to create the node and appropriate connections to correctly establish a user defined particle emitter.

## swissArmyManip

Produces dependency graph nodes swissArmyLocator and swissArmyLocatorManip

This is a contrived example plug-in that attaches one of every kind of user-defined manipulator to a node. It is a good example of the source code required to create each user-defined manipulator. To use it, issue the command:

    createNode swissArmyLocator

then click the showManip icon on the toolbar. The locator on the screen will be overlaid with one of every kind of user-defined manipulator.

## threadTestCmd

Produces MEL command threadTestCmd.

This example demonstrates how to use the MThreadPool class to calculate primes using a threaded algorithm. For comparison purposes, a serial calculation of primes is also provided. To use this plug-in, first load it and then execute the following:

    threadTestCmd 1 10000

Where argument 1 and argument 2 specify the start and end ranges of the prime search.

## threadTestWithLocksCmd

Produces MEL command threadTestWithLocksCmd.

Very similar to the threadTestCmd but incorporates thread spin locking with the MSpinLock class. To use this plug-in, first load it and then execute the following:

    threadTestWithLocksCmd 100000

Argument 1 specifies the iteration count.

## tiffFloatReader

Demonstrates how to write a .tif float file reader using the API. In Maya’s image reading menu dialogs, a user can select *.* to see all images and then retrieve a tiff extension file item in order to load the .tif file into Maya.

## torusField

Produces dependency graph node torusField

This node is an example of a dynamics field that creates a attract-repel field between itself and a distance.

There is an example MEL script "torusField.mel" that shows how to create the node and appropriate connections to correctly establish a user defined field.

## transCircleNode

Produces dependency graph node transCircle

This plug-in demonstrates how to use an attribute that contains multiple values (a compound attribute). The translate attribute of the transform node is used which is composed of the elements: translateX, translateY, and translateZ, all of which are communicated over a single dependency graph connection.

To use this node, execute the MEL command "transCircleNode.mel" that contains the following commands:

    createNode transCircle -n circleNode1;
    sphere -n sphere1 -r 1;
    sphere -n sphere2 -r 2;
    connectAttr sphere2.translate circleNode1.inputTranslate;
    connectAttr circleNode1.outputTranslate sphere1.translate;
    connectAttr time1.outTime circleNode1.input;

This creates two spheres and a transCircle node. The translate attribute of sphere1 is connected to the input of the transCircle node, and its output is connected to the translate attribute of sphere2.

If the play button is pressed, the second sphere will circle around the first. If the first sphere is moved, the second will also move such that the first sphere always remains at the center of the circle.

This plug-in also comes with a sample of an attribute editor template. This example suppresses the display of all attributes except scale and frames, and also provides an extra quick set control for the scale attribute that uses radio buttons to update the attribute value.

## translateCmd

Produces MEL command translate

This plug-in translates the CVs of selected curves, surfaces, or polygonal objects by a user specified amount. It is a good example of manipulating CVs on these three data types. To use it, select an object then execute "translate 1.0 2.0 3.0" in the command window.

It should be noted that this command will not work on NURBS primitives that have construction history. The history forces the CVs to return to their original position immediately after the translate command has moved them. To allow the translate command to work on such surfaces, you must either delete the construction history on the object (Edit > Delete by Type > History), or open the Tool Settings window before creating the surface and turn off History.

## undoRedoMsgCmd

This plug-in example demonstrates how to listen to undo and redo message events using the MEventMessage class.

The syntax of the command is:

    undoRedoMsg add;
    undoRedoMsg remove;

The add argument causes listening to undo/redo to be turned on. The remove argument causes undo/redo listening to be removed.

## userMsgCmd

This example plug-in produces the MEL command "userMessage" that demonstrates how a plug-in can use user-defined messages.

Here is an example of how the command can be used:

    // Register a user-defined event named "test". The plug-in will internally register
    // callbacks for the event.
    userMessage -r test;
    // Post to the user-defined event. The plug-in prints info messages from the callbacks.
    userMessage -p test;
    // Entered userMessage::userCallback2
    // Received data: Sample Client Data (an MString object)
    // Entered userMessage::userCallback1
    // Received data: Sample Client Data (an MString object)
    // Deregister the user-defined event
    userMessage -d test;
    // Trying to post a message after the event has been removed will fail.
    userMessage -p test;

## viewCallbackTest

Produces a command viewCallbackTest.

This plug-in installs the pre and post rendering callbacks of MUiMessage. As a simple demonstration, a modelling view can be inverted or shaded based on depth. In the depth shaded mode, the closer objects are lighter in color. Below is some sample MEL for using this plug-in once it is loaded.

    // Invert mode
    viewCallbackTest -bo "invert" `getPanel -withFocus`;
    // Depth mode
    viewCallbackTest -bo "showDepth" `getPanel -withFocus`;

Limitations: screen does not refresh right after plug-in executes.

## viewCaptureCmd

Produces MEL command viewCapture

This plug-in uses OpenGL to capture the current 3D view and write it into a PPM file. To use it, give it a filename as an argument into which the PPM image of the current view should be written.

NoteAny parts of other X windows that are obscuring the view will be captured rather than the view underneath. This is an effect of the OpenGL buffer system on SGIs.

Color index mode buffers cannot be read by this plug-in, so the view should be set to shaded or rgb mode before doing the capture.

## volumeLightCmd

Produces command volumeLight

Demonstrates the use of the MFnVolumeLight class. This example creates a volume light then queries and sets a number of its attributes.

Example usage:

    volumeLight;
    volumeLight -a $arc -c $coneEndRadius -e $emitAmbient;

## weightListNode

Produces node weightList.

This example demonstrates how to work with multi of multi attributes as found in deformer nodes. A weightList node is created by the plug-in. The compute() method of the plug-in demonstrates how to manipulate multi of multi attributes while initialize() shows how to create the attribute. The plug-in can be demonstrated with the following once the plug-in is loaded:

    createNode weightList;
    setAttr weightList1.bias 1;
    getAttr -type weightList1.weightsList;
    // check result in shell window

## whatisCmd

Produces MEL command whatis

This simple command prints a message to standard out describing the API types of Maya objects. If no Maya objects are passed to the command then it lists the types of all of the currently selected objects.

For each object, the following information will be printed:

- name of the object
- API type for the object
- API function sets that could be used on the object. Note that not every function set listed actually exists.

This list is essentially the class derivation list containing all parent classes of this object.

For example, the command

    whatis nurbsSphereShape1

results in the following output:

    Name: nurbsSphereShape1
    Type: kNurbsSurface
    Function Sets: kBase, kNamedObject, kDependencyNode, kDagNode, kShape, kGeometric, kSurface, kNurbsSurface, kNurbsSurfaceGeom

This is a good example of taking Maya objects as arguments to a command.

## yTwistNode

Produces dependency graph node yTwist

This plug-in demonstrates how to create a user-defined deformer. A deformer is a node which takes any number of input geometries, deforms them, and places the output into the output geometry attribute. This example plug-in defines a new deformer node that twists the deformed vertices of the input around the y-axis.

To use this node:

- create a sphere or some other object
- select the sphere
- type: "deformer -type yTwist"
- bring up the channel box
- select the yTwist input
- change the Angle value of the yTwist input in the channel box

## zoomCameraCmd

Produces MEL command zoomCamera

This is a simple plug-in which divides the horizontal field of view for the current active camera by 2.0. It is a good example of getting the current active view, and of modifying the camera. To use this plug-in, first create a camera by selecting the menu item Create > Cameras > Camera, then position the camera to "look at" an object in the scene. Then, either,

- Select the menu item View > Perspective > Camera Name

  or

- Hold down the Ctrl key, press the right mouse button, and select Perspective > Camera Name from the menu that pops up.

You will now be looking through the camera. Execute "zoomCamera" in the command window, and your view through the camera will zoom-in by a factor of 2.