3D MAX导出插件编写

[转]3D MAX导出插件编写

2011-6-9阅读1667 评论0

文章版权归博客园 BigCoder所有，转载请于明显位置标明原文作者及出处，以示尊重！！

原文出处：http://www.cnblogs.com/csyisong/archive/2009/09/01/1558051.html

 

      想想研究3D MAX 的SDK已经有了不短的时间，真正算起来也有两个月了吧，但是讲到收获，确实不大。作为一个3D MAX二次开发的学习者，我首先学习了导出插件的编写，网上有很多参考资料，写的都差不多，可是都是写到关键的地方或者说比较模糊的地方就说不清楚了，今天我就结合自己所做的工作来讲讲3D MAX导出插件的编写心得。
     首先，需要做好如下的准备工作：
     1. 安装一个完整版本的3D MAX与Visual Stdio。
        我安装的是3D MAX 2009，最好是找一个完整的版本，因为完整的版本中有很多的学习资料与sdk供学习，很省事。3D MAX的二次开发对VS的要求是有一个对应关系的，在SDK文档中可以找到，3D MAX 2009对应的VS开发版本应该是VS 2005，确保电脑上已经安装了VS 2005。
     2.定制3D MAX plug-in向导。
        a.找到安装目录的3dsmaxPluginWizard文件夹(我的安装目录是C:/Program Files/Autodesk/3ds Max 9 SDK )，
          b.打开此目录下的MaxPluginWizard.vsz 文件，编辑ABSOLUTE  PATH参数为：

/maxsdk/howto/3dsmaxPluginWizard

Param="ABSOLUTE_PATH=C:/Program Files/Autodesk/3ds Max 9/SDK/maxsdk/howto/3dsmaxPluginWizard"

          c.将3dsmaxPluginWizard文件夹下的三个文件3dsmaxPluginWizard.ico、3dsmaxPluginWizard.vsdir、3dsmaxPluginWizard.vsz拷贝到VS 2005安装目录的 VC  Projects 目录下，我电脑上的目录是C:/Program Files/Microsoft Visual Studio 8/VC/vcprojects。
          d.启动VS 2005,File-New Project，选择Visual C++就可以看到3ds max Plugin Wizard选项，说明定制成功。
      以上只是开发前的一些准备工作，都可以直接在3D MAX SDK的文档中直接找到，不过文档可都是英文的哦，要耐心的读下去_^。
     在以上准备工作做好以后，就可以开始开发一个插件了，由简单到复杂，先做一个简单的插件程序。插件程序的编写有两种方法，一是用插件向导，就是刚才上面所说的；另一种是通过手工创建一个插件项目，在这里暂时只讨论用插件向导来开发，比较便捷，手工开发以后在补上。
     1.第一步，生成一个插件程序的工程，具体如下：
       a. 打开File —>New Project —>选择3ds max Plugin Wizard，输入project名字，如 “MyExport”。
       b. 进入Welcome to the 3ds max Plugin Wizard 画面，选择plugin type如图所示：
          
      c.这里显示各种插件类型，目前要做的是一个文件的导出插件，所以选择FileExport类型。
      d.下一步，再出现一个对话框        。     
      e.再下一步，设置一些路径，具体见图及注明。
              
      

    

 

      Enter your MAXSDK path指的是3D MAX SDK的安装目录

            

Enter your Plugin output path 指的是生成插件文件.dll存放的目录，可以自己设置

 

 

            Enter your 3dsmax.exe path指的是3D MAX的安装目录

      2.项目生成以后，在MyExport.cpp文件中找到Ext(int n)函数，改为return _T("MY3D"), "MY3D"是根据自己的要求来添加的；
        找到ShortDesc()函数，改为return _T ("MyExportPlugin")；

                找到DoExport(const TCHAR *name,ExpInterface *ei,Interface *i, BOOL suppressPrompts, DWORD options)内添加：

         AllocConsole();

            _cprintf( "Export Begin/n" );//记得#include <conio.h>

            3. 生成并调试你的插件，系统会执行3dsmax.exe以启动3ds Max，然后选择“文件”->”导出”，如果能看到"MyExportPlugin(*.My3D)"
                说明导出成功，然后定义一个导出文件的名称即可.这样一个空的导出插件就编写成功了！接下来请看: 3D MAX导出插件编写II    

 

在3D MAX导出插件编写I中已经具有了一个插件程序的基本框架，但这还是远远不够的，接下来，我们对I中的程序来补充肌肉、注入血液。
      在正式写插件之前，也必须要弄清楚一些概念，比如说Node，Object，Mesh，Face，以及他们之间的关系，还有就是3D MAX场景的组织方式，关于这些内容我会专门安排一篇文章来进行归纳总结，请阅读：3D MAX中的重要概念及场景组织方式
      在写程序之前，有一点必须弄明白的是，需要导出的什么数据，在这里，我们需要的导出的数据有：
      1.几何信息——顶点坐标、顶点法线向量、面法线向量、顶点颜色
      2.材质信息——基本材质信息(材质的Ambient、Diffuse、Specular、Shininess)、纹理信息(纹理图片的文件名)
      从读程序开始，首先找到程序的入口点DoExport()函数，在这个函数中有一个重要的类ExpInterface，在这个类中包含IScene这个类，这个类很关键，我们先看它在SDK 9.0中的描述：

Description:

Methods of this class may be used to enumerate the scene and to flag certain nodes in the scene. Nodes chosen by the plug-in may be flagged using the EnumTree() method. Selected nodes may be flagged using FlagFGSelected().         由上面的描述可以看出这个类的作用是列举场景中所有的Nodes，而这个功能是由函数EnumTree()实现的，而这个函数会在程序的入口处被调用。对于每个结点，都有一个ITreeEnumProc *proc对象来描述它，proc对象是作为EnumTree()的参数传递进去的，再看类ITreeEnumProc的描述：
 Description:

This is the callback object used by IScene::EnumTree(). To use it, derive a class from this class, and implement the callback method.

      可见，这个类中对Node信息的获取就是通过callback()这个函数来实现的。这个函数的完整形式是：virtual int ITreeEnumProc::callback(INode* node)
      还有，由上面描述可知ITreeEnumProc这个类必须通过继承去实现其中的callback()函数才行，继承类MyTreeEnum如下：

有了这样类，剩下的导出数据的工作就都在这个函数中实现。 
       接下来，是一个callback函数的简单框架：
 

class MyTreeEnum : public ITreeEnumProc

{

public:

    MyTreeEnum(void);

    ~MyTreeEnum(void);

public: 

    int callback( INode *node );

};

 

     
     

int MyTreeEnum::callback(INode *node)
{
ObjectState os = node->EvalWorldState(10);

if ( os.obj->CanConvertToType( Class_ID(TRIOBJ_CLASS_ID, 0) ) )
    {
        _cprintf( "TRIOBJECT %s/n", node->GetName());

        Mtl *pMtl = node->GetMtl();

        if ( pMtl )
        {
            _cprintf( "MATERIAL %s/n",pMtl->GetName() );

        }
        return TREE_CONTINUE;
    }

    if (os.obj)

    {
        switch(os.obj->SuperClassID()) 
        {
            case CAMERA_CLASS_ID:

            _cprintf( "CAMERA %s/n", node->GetName());

            break;

            case LIGHT_CLASS_ID:

            _cprintf( "LIGHT %s/n", node->GetName());

            break;

        }
}
    return TREE_CONTINUE;
}

 

---

      而在程序的入口函数处需要修改一下：

 

int  MaxExportTest::DoExport(const TCHAR *name,ExpInterface *ei,Interface *i, BOOL suppressPrompts, DWORD options)
{
    MyTreeEnum tempProc;
    ei->theScene->EnumTree( &tempProc );
    return TRUE;
}

      

      最后，编译它，开始调试，找一个有物体，材质，灯光，摄像机的场景进行导出，如果你能在控制台输出窗口看到每个结点的名字，说明你的代码成功了。

        其实上面的代码部分不是自己的，作者分析的不错，我就直接copy过来了，见参考链接：http://www.cgsir.com/download/tut_files/3dsmax_export_plugin.htm    

后面导出信息的代码，就自己写了一些，继续。

 

---

      1. 在SDK中有一个Mesh的概念，Node的几何信息都可以通过这个Mesh类获取到。在获取到TriObject对象后，获取Mesh对象就很容易了。

  Mesh* pMesh = &tri->GetMesh();

     然后分别获取顶点信息、法向量信息、纹理坐标。
           

        Mesh *pMesh = &triobj->GetMesh();
        int VerticesNum = pMesh->getNumVerts();
        for ( int i=0; i<VerticesNum; i++ )
            {
                Point3     Coord,Normal,VColor,TCoord;
                int FaceNumber;
                //导出顶点坐标
                Coord = pMesh->getVert(i);
                
                //导出顶点的法向量
                pMesh->buildNormals();
                Normal = pMesh->getNormal(i);
                
                //导出顶点的纹理坐标
                TCoord = pMesh->tVerts[i];
             }

寥寥几行代码，就可以导出node的几何信息。除此，还需要导出node的材质信息，对于单纹理的node，可以简单的获取材质信息。

//Access the material information 
Mtl* pMtl = inode->GetMtl();

if(pMtl->ClassID() == Class_ID(DMTL_CLASS_ID, 0))
{    
   StdMat* std = (StdMat *)pMtl;
   //Access the ambient,diffuse,specular,shininess,emission 
   const MSTR& sMtlName = pMtl->GetName();
   Color m_Ambient = std->GetAmbient(0); 
   Color m_diffuse = std->GetDiffuse(0);
   Color m_specular = std->GetSpecular(0);
   float m_shininess = std->GetShininess(0);
   float m_shiniStrength = std->GetShinStr(0);
   if (pMtl->GetSelfIllumColorOn())
    {
        float r = pMtl->GetSelfIllumColor().r;
        float g = pMtl->GetSelfIllumColor().g;
        float b = pMtl->GetSelfIllumColor().b; 
        }
   else
       Texmap *tmap = pMtl->GetSubTexmap(ID_DI);
       if (tmap->ClassID() == Class_ID(BMTEX_CLASS_ID, 0))
    {
      BitmapTex *bmt = (BitmapTex*)tmap;
      if(bmt)
       {
        char* MapName = bmt->GetMapName();
       }
    }
}

 以上获取的这些信息还只是孤立的数据，要想把这些数据组织起来，需要获取Mesh类中的Face信息。

 

 

 

 

 

        不用去管这些Plugin Detail,会有默认路径的，