3DS Max plugin 编程五，第一行代码

这个篇章结束，我们能自己写一个*.dle插件，这个插件的最后结果很简单，弹出一个对话框，如下图：

从图中的对话框内容可以看出，我们这个对话框是在DoExport()中被Max引擎给调用到了。文章中，我们会从一个空的工程开始一点一点加入代码，直到最后上面的结果，整个过程能让我们实践一个插件的开发过程，当然，只是万里长征的第一步。

整个工程最后的文件清单如下：

1，dllmain.h, dllmain.cpp

2，exporterdesc.h, exporterdesc.cpp

3，resource.h

4，OgreExporter.h, OgreExporter.cpp

5，exporter.def

4里面用到Ogre开头的名称，是因为我们后续可以导出成Ogre识别的XML格式，这个格式可以在Ogre DTD文档中看到，对大家都比较方便。最后我们也可以用Ogre知道我们导出的有没有问题。

现在就让我们开始：

准备、用VC新建win32 project，创建一个DLL， 记住勾选empty project，我们会在写插件的过程中不停的手工加入需要的文件。

1、在新项目中添加new item，类型选择.cpp，加入第一个文件，dllmain.h，内容如下：

#ifndef DLLMAIN_H#define DLLMAIN_H#include <windows.h>#include "resource.h"#include "max.h"extern HINSTANCE hInstance;extern TCHAR *GetString(int id);#endif

这个头文件主要是包含了resource.h, windows.h, max.h 3个重要的头文件，准备做为一个基础给其他的C++文件包含用。

2、新加入dllmain.cpp，相关的代码如下，建议这个文件可以作为以后的模板文件，Copy-Paste代码的方式在这里完全是有意义的。

#include "dllmain.h"#include "exporterdesc.h"HINSTANCE hInstance;static ExporterDesc gExporterDescInst;BOOL WINAPI DllMain (HINSTANCE hInst, ULONG ulReason, LPVOID lpvReserved){    hInstance = hInst;    switch(ulReason)     {    case DLL_PROCESS_ATTACH:        if (FAILED(CoInitialize(NULL)))            return FALSE;        break;    case DLL_THREAD_ATTACH:        break;    case DLL_THREAD_DETACH:        break;    case DLL_PROCESS_DETACH:        break;    }    return(TRUE);}//------------------------------------------------__declspec( dllexport ) const TCHAR *LibDescription() {     return _T("ogre exporter"); }__declspec( dllexport ) int LibNumberClasses() {     return 1; }__declspec( dllexport ) ClassDesc *LibClassDesc(int i) {    switch(i)     {    case 0:         return &gExporterDescInst;         break;    default:         return 0;     break;    }}__declspec( dllexport ) ULONG LibVersion() {     return VERSION_3DSMAX; }__declspec( dllexport ) ULONG CanAutoDefer(){    return 1;}//------------------------------------------------TCHAR *GetString(int id){    static TCHAR buf[256];    if (hInstance)        return LoadString(hInstance, id, buf, sizeof(buf)) ? buf : NULL;        return NULL;} 

需要特别注意的是，LibClassDesc()这个DLL入口实现，可以返回一个ClassDesc的指针，这里通常我们会在插件编写中让它返回一个全局的静态变量。

3、新加入文件，这次是.DEF文件。

LIBRARY    "exporter"EXPORTS    LibDescription    @1    LibNumberClasses  @2    LibClassDesc      @3    LibVersion        @4SECTIONS.data READ WRITE

这个文件定义了整个插件能导出的方法名称。

4、dllmain中引出了一个exporterdesc.h，所以我们新加入文件，名称即exporterdesc.h，文件中内容如下：

#include "iparamb2.h"class ExporterDesc : public ClassDesc2{public:    ExporterDesc();    virtual ~ExporterDesc();    int IsPublic();    void * Create(BOOL loading = FALSE);    const TCHAR * ClassName();    SClass_ID SuperClassID();    Class_ID ClassID();    const TCHAR* Category();};

这个类必须继承自ClassDesc2(或者ClassDesc，ClassDesc2是前者的继承类)，并实现上述的接口。在Max启动的过程中，扫描到我们的插件的时候，DllMain()是重要的入口，因为是动态链接库强制的。而这里的Create()，则是Max引擎强制的，会被Max引擎用来创建插件主体的一个实例。

5、实现上面类的是exporterdesc.cpp中，我们要实现这些方法，如下：

#include "dllmain.h"#include "exporterdesc.h"#include "OgreExporter.h"ExporterDesc::ExporterDesc(){}ExporterDesc::~ExporterDesc(){}int ExporterDesc::IsPublic(){    return true;}const TCHAR* ExporterDesc::Category(){    return GetString(IDS_STRCATEGORY);}Class_ID ExporterDesc::ClassID(){    return Class_ID(0x73bd1636, 0x22f05f49);}const TCHAR* ExporterDesc::ClassName(){    return GetString(IDS_STRCLASSNAME);}void* ExporterDesc::Create(BOOL loading){    OgreExporter* pExporter = new OgreExporter(hInstance);     return pExporter;}SClass_ID ExporterDesc::SuperClassID(){    return SCENE_EXPORT_CLASS_ID;}

我们的Create()方法创建了一个OgreExporter实例。所以，我们需要来加入OgreMaxExport这个类。这个类也是导出插件的真正主体。前面一切的一切都是因为Max引擎或者说是SDK需要我们那么做，为了让Max引擎能跟我们的插件做配合才做的工作。而这个被创建的OgreExporter才是我们真正的主角。

6、新加入OgreExporter.h文件，内容如下：

#ifndef OGREEXPORTER_H#define OGREEXPORTER_H#include <windows.h>#include "resource.h"#include "max.h"#include "impexp.h"#include "dllmain.h"class OgreExporter : public SceneExport{public:OgreExporter(HINSTANCE hInst) : m_hInstance(hInst) { }virtual ~OgreExporter ();public:    virtual int ExtCount();    virtual const MCHAR* Ext(int n);    virtual const MCHAR* LongDesc();    virtual const MCHAR* ShortDesc();    virtual const MCHAR* AuthorName();    virtual const MCHAR* CopyrightMessage();    virtual const MCHAR* OtherMessage1();    virtual const MCHAR* OtherMessage2();    virtual unsigned int Version();    virtual void  ShowAbout(HWND hWnd);    virtual int DoExport(const MCHAR* name,ExpInterface* ei,Interface* i,BOOL suppressPrompts=FALSE, DWORD options=0);private:HINSTANCE m_hInstance;};#endif

对于导出插件来讲（3DS Max中，导出插件是其中一个类型），我们需要继承SceneExport,

并实现基类的几个函数，列表如下：

virtual int ExtCount();
virtual const MCHAR* Ext(int n);
virtual const MCHAR* LongDesc();
virtual const MCHAR* ShortDesc();
virtual const MCHAR* AuthorName();
virtual const MCHAR* CopyrightMessage();
virtual const MCHAR* OtherMessage1();
virtual const MCHAR* OtherMessage2();
virtual unsigned int Version();
virtual void  ShowAbout(HWND hWnd);

virtual int DoExport(const MCHAR* name,ExpInterface* ei,Interface* i,BOOL suppressPrompts=FALSE, DWORD options=0);

在SDK中，可以看到这些方法SDK有标准[Pure Virtual]，也就是“纯虚函数”，所以，有这个标注的方法就必须自己来实现实体。

7，实现的文件是新加入的文件，OgreExpoter.cpp。

#include "OgreExporter.h"OgreExporter::~OgreExporter(){}int OgreExporter::DoExport(const MCHAR *name, ExpInterface *ei, Interface *i, BOOL suppressPrompts, DWORD options){    MessageBox (NULL, "DoExport called by Max engine", "Max plug-in", MB_OK);        return 1;}const MCHAR* OgreExporter::AuthorName(){    return GetString(IDS_STRAUTHORNAME);}const MCHAR* OgreExporter::CopyrightMessage(){    return GetString(IDS_STRCOPYRIGHT);}const MCHAR* OgreExporter::Ext(int n){    switch (n)    {    case 0:return _T("xml");break;    default:return _T("");    }}int OgreExporter::ExtCount(){    return 1;}const MCHAR* OgreExporter::LongDesc(){    return GetString(IDS_STRLONGDESC); }const MCHAR* OgreExporter::OtherMessage1(){    return GetString(IDS_STROTHER1);}const MCHAR* OgreExporter::OtherMessage2(){    return GetString(IDS_STROTHER2);}const MCHAR* OgreExporter::ShortDesc(){    return GetString(IDS_STRSHORTDESC); }void OgreExporter::ShowAbout(HWND hWnd){    }unsigned int OgreExporter::Version(){    return 100;}

如我在前面的文章中（http://blog.csdn.net/tinyhum/article/details/6918540）提过的，上述的Ext方法会被Max引擎迭代用来找到该插件支持的后缀，DoExport则是真正的主体，在用户选好导出的文件名字并按下保存后就会被Max引擎呼叫到，想做什么事情，主要在这里做文章。

因此，我们后续的事情，都可以由DoExport()起，至DoExport()终。唯一的一点，你现在完全进入了Win32编程了，你可以在Win32的范畴和Max SDK的范畴，尽情发挥。

弹出的对话框我们是直接调用Win32的MessageBox()来进行的，你也可以在VC中自己制作好Dialog模板来进行调用。我们的GetString()利用了VC的resource view来进行字符串调用。

上述7个文件，还不能编译成功整个工程，如果要编译过，你必须在工程中加入resource，并把GetString()用到的那些ID全部实现。

编译的过程中，项目的属性页上，头文件包含目录必须有max sdk的include路径；链接目录上，必须有max sdk的lib路径；输入的库文件中，需要有comctl32.lib core.lib geom.lib gfx.lib helpsys.lib maxutil.lib mesh.lib paramblk2.lib这些库，特别是最后一个库是我们目前一定需要的(ClassDesc2存在的库)。