3dsmax插件开发新手上路

 感谢老狼同学的这篇文章。

 点击可看原帖地址

[原创]3dsmax插件开发新手上路

作者:老狼

email: [email protected]
QQ:4197680024

我尽量把话题说的通俗易懂一点，因为要做插件的可能不只是程序员：）
所谓插件，其实就是动态链接库，windows 系统上就是dll，打开Autodesk\3ds Max 9\stdplugs文件夹，会看到下面一大堆扩展名叫dlu,dlo,等等的文件。其实这都是dll改的名字，本质还是dll。当宿主程序运行起来的时候，会加载这个文件夹下的所有dlxx扩展名的文件。因此你可以用任何创建dll的方法来生成它,比如用Win32 DLL Project,或者MFC DLL Project;我本人更喜欢用MFC DLL Project,可以方便的用MFC的功能;在3dsmax插件中使用MFC DLL Project ,有一些需要注意的问题,将在后文叙述.

如果你想快速写插件,通常使用 maxsdk提供的 vc wizard 最容易创建一个特定的插件框架程序.这里简单说一下设置 3dsmax vc wizard 的方法:

安装了3dsmax product以后,还要安装maxsdk,sdk和大量的sample在dvd完整安装版本上,PluginWizard 的路径在Autodesk\3ds Max 2009 SDK\maxsdk\howto\3dsmaxPluginWizard下面,里面有readme.txt文件,大意是这样的:用文本编辑器打开3dsmaxPluginWizard.vsz,我装的是3dsmax2009,打开这个vsz文件的内容如下:

VSWIZARD 7.0
Wizard=VsWizard.VsWizardEngine.8.0

Param="WIZARD_NAME = 3dsmaxPluginWizard"
Param="ABSOLUTE_PATH = C:\dev\p4\gouda\3dswin\src\maxsdk\howto\3dsmaxPluginWizard"
Param="FALLBACK_LCID = 1033"

把ABSOLUTE_PATH 的路径改为 D:\Autodesk\3ds Max 2009 SDK\maxsdk\howto\3dsmaxPluginWizard,就是你复制文件的原路径

这个时候用VC8 新建 Project ,选择VC++,会看到一个 3ds max plugin Wizard 列表项,然后按照提示一步一步操作就能创建一个基本的插件框架.

这里我要多说一点的是用自定义dll project方法创建3dsmax plugins的方法,我本人不太喜欢用现成的东西,凡事总喜欢自己亲手做来的东西,这样理解的也比较深刻透彻

3dsmax插件，有几个标准的可导出函数，3dsmax.exe装载插件时，用GetProcAddress API找出预定的几个标准接口，然后调用一个LibClassDesc的接口，创建出用户自定义的对象实例，类似于"抽象厂"方法

3dsmax 插件中必须定义的标准导出函数：
#define DLLEXPORT_API  __declspec(dllexport)

//插件描述
DLLEXPORT_API  const TCHAR* LibDescription()
{
    LoadString( IDS_LIBDESCRIPTION );
}
//这个dll中有几个插件
DLLEXPORT_API  int LibNumberClasses()
{
    return 1;
}
//取得插件描述块,3dsmax.exe用它来创建你的插件类的实例
DLLEXPORT_API  ClassDesc* LibClassDesc(int i)
{
    switch(i) 
    {
          case 0: return GetMyClassDesc();
          default: return 0;
    }
}
//LibVersion用来匹配插件和宿主3dsmax.exe之间的版本匹配问题.
DLLEXPORT_API  ULONG LibVersion()
{
    return VERSION_3DSMAX;
}

关于如何在VC中创建DLL Project,不需要多说了,要说的一点就是导出函数必须用 _declspec(dllexport) 修饰,另外还需要在def文件中列出导出函数的名字如下:
假定一个导出插件的文件名是SampleExporter
//SampleExporter.def
LIBRARY SampleExporter
EXPORTS
    LibDescription            @1
    LibNumberClasses  @2
    LibClassDesc            @3
    LibVersion                   @4
SECTIONS
    .data READ WRITE

下面着重说GetMyClassDesc() 这个函数...

#define SampleExporter_CLASS_ID   Class_ID(0xc2a1ee34, 0x832cc295)  //这个Class_ID用Autodesk\3ds Max 2009 SDK\maxsdk\help\getcid.exe 自己生成,只要不存在冲突就可以.

//SampleExporter 是从SceneExport 继承的导出插件类,SceneExport是sdk预定义的用于实现导出插件的基类,用户写导出插件,只需要继承它,然后实现相应的纯虚接口即可.
//导入插件基于SceneExport,辅助插件基于UtilityObj,还有创建面板上的,详见3ds Max SDK Programmer'sGuide中的Type of Plug-Ins 介绍.
//函数DoExport是3dsmax.exe和导出插件程序交互的主要接口,选择File/Export菜单,然后选择SampleExporter后,将会进入DoExport函数...
class SampleExporter : public SceneExport {
public:        
    static HWND hParams;
        
    int        ExtCount();                // Number of extensions supported
    const TCHAR *    Ext(int n);                // Extension #n (i.e. "3DS")
    const TCHAR *    LongDesc();            // Long ASCII description (i.e. "Autodesk 3D Studio File")
    const TCHAR *    ShortDesc();            // Short ASCII description (i.e. "3D Studio")
    const TCHAR *    AuthorName();            // ASCII Author name
    const TCHAR *    CopyrightMessage();            // ASCII Copyright message
    const TCHAR *    OtherMessage1();            // Other message #1
    const TCHAR *    OtherMessage2();            // Other message #2
    unsigned int    Version();                // Version number * 100 (i.e. v3.01 = 301)
    void        ShowAbout(HWND hWnd);        // Show DLL's "About..." box

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

    //Constructor/Destructor
    SampleExporter ();
    ~SampleExporter ();        

};
//3dsmax.exe如何与用户自定义的插件建立起联系,就是通过下面这个ClassDesc类来获得创建插件对象实例所需要的必要的信息
class  SampleExporterClassDesc: public ClassDesc2 
{
public:
    virtual int IsPublic()                     { return TRUE; }
    virtual void* Create(BOOL /*loading = FALSE*/)         { return new SampleExporter (); }//这里其实就是"抽象厂"方法,让用户提供一个实例
    virtual const TCHAR *    ClassName()             { return GetString(IDS_CLASS_NAME); }
    virtual SClass_ID SuperClassID()                 { return SCENE_EXPORT_CLASS_ID; }
    virtual Class_ID ClassID()                 { return SampleExporter_CLASS_ID; }
    virtual const TCHAR* Category()                 { return GetString(IDS_CATEGORY); }
    virtual const TCHAR* InternalName()             { return _T("SampleExporter"); }    // returns fixed parsable name (scripter-visible name)
    virtual HINSTANCE HInstance()                 { return hInstance; }        // returns owning module handle
};

static  SampleExporterClassDesc  expoertDesc;
ClassDesc2* GetMyClassDesc() { return &expoertDesc; }

//下面是SampleExporter类的实现代码
SampleExporter::SampleExporter()
{
}
SampleExporter::~SampleExporter() 
{
}
int SampleExporter::ExtCount()
{
    #pragma message(TODO("Returns the number of file name extensions supported by the plug-in."))
    return 1;
}
const TCHAR *SampleExporter::Ext(int n)
{        
    #pragma message(TODO("Return the 'i-th' file name extension (i.e. \"3DS\")."))
    return _T("");
}

const TCHAR *SampleExporter::LongDesc()
{
    #pragma message(TODO("Return long ASCII description (i.e. \"Targa 2.0 Image File\")"))
    return _T("");
}
    
const TCHAR *SampleExporter::ShortDesc() 
{            
    #pragma message(TODO("Return short ASCII description (i.e. \"Targa\")"))
    return _T("");
}
const TCHAR *SampleExporter::AuthorName()
{            
    #pragma message(TODO("Return ASCII Author name"))
    return _T("");
}
const TCHAR *SampleExporter::CopyrightMessage() 
{    
    #pragma message(TODO("Return ASCII Copyright message"))
    return _T("");
}
const TCHAR *SampleExporter::OtherMessage1() 
{        
    //TODO: Return Other message #1 if any
    return _T("");
}
const TCHAR *SampleExporter::OtherMessage2() 
{        
    //TODO: Return other message #2 in any
    return _T("");
}
unsigned int SampleExporter::Version()
{                
    #pragma message(TODO("Return Version number * 100 (i.e. v3.01 = 301)"))
    return 100;
}
void SampleExporter::ShowAbout(HWND hWnd)
{            
    // Optional
}
BOOL SampleExporter::SupportsOptions(int ext, DWORD options)
{
    #pragma message(TODO("Decide which options to support.  Simply return true for each option supported by each Extension the exporter supports."))
    return TRUE;
}
//这里是真正的导出函数入口,用户选择导出后,将执行到这里
int  SampleExporter::DoExport(const TCHAR *name,ExpInterface *ei,Interface *i, BOOL suppressPrompts, DWORD options)
{
    #pragma message(TODO("Implement the actual file Export here and"))

    if(!suppressPrompts)
        DialogBoxParam(hInstance, 
                MAKEINTRESOURCE(IDD_PANEL), 
                GetActiveWindow(), 
                maxProject1OptionsDlgProc, (LPARAM)this);

    #pragma message(TODO("return TRUE If the file is exported properly"))
    return FALSE;
}

至此一个基本的插件程序框架就搭建起来了,剩下的就是要遍历场景节点,实现你自己的数据导出功能了
(完)