3DMax导出插件的制作

来源:互联网 发布:排球拦网后触网 知乎 编辑:程序博客网 时间:2024/04/29 16:58

一转:http://blog.csdn.net/wrq147/archive/2009/06/29/4306135.aspx

 

3Dmax导出插件制作(译文)

前言:本教材将建立一个3dMax导出插件。目的是帮助使你掌握建立MAX插件的基础知识和学习怎样从3ds max中导出场景数据。

本教材一共五个部分,每一部分都带有相应源码,相应的目录如下:

第一节:开始

第二节:几何体

第三节:灯光和纹理

第四节:动画和修正

第五节:定制数据

注:

MaxSDK 类 ,用Iderivedobject 格式

MaxSDK 方法,用DoExport() 格式

文件名:export.cpp

和本教材相关的源代码应用方式:PerFaceData

第一节:开始

源代码:phase0.zip

在这一节我们将建立插件的“框架”,通常建立插件时我们需要按下面步骤:

1. 假如插件的框架已经存在(通过VC向导建立),那么就可以跳过此节。
2. 假如没有存在我们用VC的向导来建立。
3. 那么我们做下面的事情:
建立一个Win32DLL工程,通常把这个工程放进MaxSDK目录下。设置工程的配置,用于编译DLL。将DLL生成目录设置为MAXSDK/PLUGIN目录。并在工程设置中加入MAXSDK的Include 和 Lib路径。

加两个CPP文件(PLUGINNAME.CPP and DLLENTRY.CPP),前一个文件将包含根据实际的插件类型产生的执行代码。后一个文件是插件DLL ”C” 类型的导出接口。同样,我们加PLUGINNAME.H文件来定义插件的主类。我们加 PLUGINNAME.DEF文件,来说明DLL的导出接口,内容如下:

 LIBRARY MyPlugIn  // 插件名称EXPORTS LibDescription  @1  // DLL描述 LibNumberClasses @2  // 返回嵌入类数目 LibClassDesc  @3  // 返回第I个类的描述符 LibVersion  @4  // 插件版本SECTIONS .data READ WRITE  我们加一个字符串资源连同一个版本资源,假如插件需要一个对话框的话,可以加一个。对于本文不需要对话框。

插件必要条件:

我们需要加一个基本类,这个类是所有插件都需要的。DLLENTRY.CPP包含我们所需要的类,这些代码变化不大,几乎可以作为样板在各个插件中使用。这个类经由 LibClassDesc 导入插件构造类 ClassDesc。

DLL接口清楚的说明:DllMain 初始化一些习惯性的定制。LibDescription 将返回字串用来描述插件。Libnumberclasses 返回插件类型号。Libclassdesc 返回Classdesc类用来建立插件对象。Libversion 返回插件的版本,版本在VERSION_3DSMAX 中定义。

LibClassDesc 通常返回单个静态ClassDesc类地址。对于本文,我们的类继承自ClassDesc2。一般来说,我们推荐使用ClassDesc2 和 ParamBlock2 代替以前的版本,以前的版本将被逐步淘汰。

早先的观点,ClassDesc类主要作为一个类工厂被插件类继承。既然这样,主要插件类将继承sceneExport。在我们的插件中我们从 Classdesc2 和 sceneExport 中继承。代表性的,一个静态的单独的ClassDesc类实例通过LibClassdesc建立和返回。我们的派生类也将返回类ID和名字信息和SceneExport派生类名字信息。SDK有一个工具(GENCID.EXE)可以提供一个简单的途径建立唯一的类ID。

MyExporter 是我们从SceneExport 类派生的,简要的说明如下:

int ExtCount() :返回导出提供者扩展名的数量。

const TCHAR * Ext(int n) :返回扩展名

const TCHAR * LongDesc() :返回文件导出格式的“长”类型描述

const TCHAR * ShortDesc() :返回文件导出格式的“短”类型描述

const TCHAR * AuthorName() : 提供插件名,描述插件的作者和公司

const TCHAR * CopyrightMessage() :提供版本字串

const TCHAR * OtherMessage1() : 没有用

const TCHAR * OtherMessage2() : 没有用

unsigned int Version() :有时多余的,但是返回一个版本号为导出者

void ShowAbout() :显示一个about对话框,

int DoExport() :实际的导出方法

大多数方法从字符串表中返回一个局部串或者一个宏定义和常量。导出插件的最主要方法是DoExport方法,我们将在下节中进行扩展。这个例子是简单的,我们没有定制导出选项。看一下导出例子和框架导出,通过简单的途径,我们可以提供一个指定的对话框,在导出前设置导出选项。

我们加一些保护方法(DoHeader,DoNodes,DoTailer)为我们导出全局场景信息时可用,下面的每个节点的信息,下面的任何“End Delimiter”文件信息。我们也加入一些指针成员变量,和一些文件读写指针将在实际导出时用。

!注意:上面讲的在sdk中可以读的更详细,参考“Creating a new Plug-In Project”

!注意:你可以看一下sdk中的例子,许多不同类型的代码组织结构被用。你可以选择自己合适的。

实现:

1、 建立一个DLL工程 Exporter。
2、 复制phase0文件到Exporter目录。
3、 打开VC,打开工程Exporter.dsw。
4、 检查EXPORTER.DEF
5、 检查DLLENTRY.CPP
6、 看 EXPORTER.H、EXPORTER.CPP 注意一下#define MYEXP_CLASSID 、MyExporterClassDesc等。
7、 看资源,对话框,版本等。
8、 编译,用3Dmax导出,你会看到一个“.MEP”扩展名,这就是你的插件要导出的。
第二节 几何体

源代码:phase1.zip

对于我们第一次进行实际的3dmax场景导出,我们将集中讨论几何场景对象。

对于3ds max场景导出通过节点操作比较容易实现,我们第一步需要建立一个节点列举器方法来处理和操作3dmax场景中的节点。我们通过不同的方式这样做:提供我们自己的方法,利用 Iscene 和 TreeEnum 回调函数经由ExpInterface来操作。举个例子,我们编写我们的列举器。

对于在3ds max场景层次中一些简短背景信息,基本层次是场景树,有一个根节点,它的孩子是场景中的其它所有节点。假如一个节点又有一个层次(经由3ds Max连接,可能基于对象层,比如骨骼),这也将被描述为“树”,对此我们也可给出更好的抽象的定义。

根节点有些特殊,我们访问它通过Interface::GetRootNode 这个方法,根节点不代表任何实际的几何对象。

对于我们节点操作,代码如下面所示:

 nodeEnum(Node ptr)    If the ptr isn’t valid, exit    If the ptr isn’t selected, and we’re exporting only selected nodes, exit    If the user canceled (usually via ESC), exit    Otherwise    Evaluate the object, determine what type of object it is, and call   a specific helper method that exports that type of object    For each child of the current ptr Node    nodeEnum(child)上面的代码在MyExporter::DoNodes函数中调用了节点列举函数,此函数实现如下:

 Get a count of the children of the Root NodeFor each child of the Root Node    Check for cancel and break if cancelled    nodeEnum(child)网格对象(Mesh):
3dmax网格是由三角形构成的,每一个几何对象必须能转变为相应的三角形网格。场景中的任何东西都是由这些三元网格组成。然而原始的可能不是这样,为了得到三角形网格我们用函数:Object::ConvertToType(参数TRIOBJ_CLASS_ID).

我们调用 ConvertToType函数,它检查和返回与原始对象指针相同的对象指针。假如过这样做了,返回的指针和原始指针相同,那么将产生一个新的网格对象,我们调用和负责释放此网格,示例如下:

TriObject *tri = (TriObject *) obj->ConvertToType(ip->GetTime()

if (obj != tri) deleteIt = TRUE

一旦我们有了一个网格,我们可以得到顶点的数目和面的数目。这些信息通过网格(Mesh)类的API来得到。

在对像空间操作网格,我们需要得到节点的转换矩阵(为现在的帧),我们以行的格式将它们导出。

我们通过ObjectTM类导出网格的每一个顶点的世界坐标。

我们导出面,面由用三个数值的顶点数组来表示。顶点是按照顺时针方向排列的,描述物体的“前”表面。我们也可导出“边缘可见性”,它是用来描述边缘,比如 A->B。假如3dsmax画一条高光线在视口,并且采用的是边缘模式,再假如这边缘能被选择,最后我们将导出一组光滑的面,这是通过顶点法向量经过Phong运算或者其它Shading运算方法产生的。

在这片教材中我们将导出网格材质和UV坐标等信息,可以参考源码。

具体源码如下:

原创粉丝点击