Writing a CgFX shader

Maya supports Cg version 1.5.

CgFX examples are shipped with the Maya software. You can find these examples at:

• (Windows) <drive>:\Program Files\Autodesk\Maya2011\presets\CgFX\examples
• (Mac OS X) /Applications/Autodesk/Maya2011/Maya/Contents/presets
• (Linux) /usr/autodesk/maya2011/presets/CgFX/examples

Varying parameter packing

You can pack multiple mesh inputs into a single varying parameter register. For example, you can pack two sets of UV coordinates into a single float4 register.

The following is a sample workflow:

1. The following vertex shader input structure shows a packed float4 that needs to contain 2 UV sets in a single varying parameter:

   struct appdata {     float3    Position: POSITION;     float4    UVs: TEXCOORD0; };

2. Create a second structure that describes the elements that should be packed into this input. To enable Maya to locate this second structure, its name must match the name of the original varying parameter (in this case, UVs).

   In this example, this auxiliary structure informs Maya that the original float4 parameter should be assembled on the fly from two float2 inputs: one named UV1, and one named UV2. This structure is not used by the shader itself - it simply tells Maya how to assemble the data for this input.

   struct UVs {     float2 UV1;     float2 UV2; };

3. Because Maya knows that this is a packed input, it presents the artist with an interface to the underlying data (UV1 and UV2) rather than the final packed structure (UVs). You can now optimize and reorganize the varying parameter register assignment without breaking any existing shader bindings in scenes using the shader.

   For more information, see UVPacking.cgfx as an example.

   NoteWhere the data assigned to a structure element is too large for the Cg data type specified (for example, a position with (x, y, z) coordinates is passed into a float2 value), the first n values will be used to populate the value, and any subsequent elements will be ignored (for example, x and y will be passed in, and z will be ignored).

Other CgFX shader features

Time semantic

Maya supports parameters that vary by time. See MrWiggle.cgfx for an example of a shader that moves with time.

Matrix semantic

You can specify matrices in your CgFX shader. Maya supports all matrix semantics keywords.

Transparent CgFX shaders

Maya supports rendering of transparent CgFX shaders. Maya detects whether the blending state is enabled in the first pass. If blending is enabled, Maya uses the Object Transparency Sorting or Polygon Transparency Sorting options in the scene view to correctly render the transparent shader.

Maya shader files

Maya provides shader files that developers can incorporate into their own CgFX shader, in the following directory:

• (Windows) <mayapath>\bin\cg
• (Linux) <mayapath>/bin/cg
• (Mac OS X) <mayapath>/Maya.app/Contents/bin/cg

Select a Maya_*.cgh code example; for example, maya_blends.cgh, the code that Maya uses for blending of the layered texture:

Known limitations

Known limitations for the CgFX shader include:

• Maya only supports .cgfx files and not .cg
• Pre and post effects (for example, full-screen effects)
• Pass scripting
• Cg Interfaces
• Time semantic: When using a shader that moves with time, you must refresh the scene in order to see the animation, for example, by tumbling the camera.