Tools are very important in game production, especially when you are working with someone who cannot write code. In my project, I worked with 2 artists, so I need to write some tools to export their models to my engine. There are different choices to export the models, you can parseCOLLADA files… But I choose to extract it directly from the modeling package that the artists use – Writing Maya plugin to extract the model data.

To write Maya plugin for exporting models, we should know how data are stored in Maya first. Basically, Maya stores most of its data (e.g. meshes, transformation…) in a MItDag like this:

  1. MStatus status;
  2. MItDag dagIter( MItDag::kDepthFirst, MFn::kInvalid, &status );
  3. MDagPathArray meshPath;    // store the DAG nodes that contains mesh
  4. for ( ; !dagIter.isDone(); dagIter.next())
  5. {
  6.     MDagPath dagPath;
  7.     status = dagIter.getPath( dagPath );
  8.     if ( status )
  9.     {
  10.         MFnDagNode dagNode( dagPath, &status );
  12.         // Filter out the DAG nodes that do not contain mesh
  13.         if ( dagNode.isIntermediateObject()) continue;
  14.         if ( !dagPath.hasFn( MFn::kMesh )) continue;
  15.         if ( dagPath.hasFn( MFn::kTransform )) continue;
  17.         meshPath.append(dagPath);
  18.     }
  19. }

then, we can get the mesh data in the DAG nodes using the MFnMesh like this:

  1. for(int i=0; i< meshPath.length(); ++i)
  2. {
  3.     MDagPath dagPath= meshPath[i];
  5.     MFnMesh  fnMesh( dagPath );
  6.     MPointArray meshPoints;// store the position of vertices
  7.     fnMesh.getPoints( meshPoints, MSpace::kWorld );
  9.     // get more mesh data such as normals, UV…
  10. }

For the details of getting the mesh data, you may refer to objExport.cpp.

Another reason I choose to write plugin instead of parsing .fbx/COLLADA is because of extracting the animation data. In my project, I just need to export some simple animations which linear interpolates between key frames, and I would like to get the key frames defined by artists in Maya. I have tried using the FBX SDK but when exporting animation data, it bakes all the animation frames as key frames… Using COLLADA get even worse because I cannot find a good exporter for Maya on the Mac platform… So writing Maya plugin can get rid of all these problems and get the data I want. I can also write a script for artists to set the animation clip data:

After exporting the mesh data, I think it would be nice to edit the collision geometry inside Maya, so I have written another plugin to define the collision shapes of the models:

This plugin works similar to the draw() methods with some openGL calls to render the corresponding shapes.

In conclusions, extracting mesh data directly from Maya is not that hard. We can get all the data such as vertex normals, UV sets and key frame data from Maya and do not need to worry about the data loss during export through another formats, especially animation data. Also Maya provides a convenient API to get those data and it is easy to learn. After familiar with the Maya API, I can also write another plugin to define the collision shapes. Next time when you need to export mesh data, you may consider to extract them directly from the modeling package rather than parsing a file format.

Reference:
[1] MAYA API How-To: 
[3] Rob The Bloke: 
[5]