3dsMax2022插件开发Utility型空插件代码结构分析

kagula

2021-10-23

        这里分析由3dsmax Wizard建立的Utility类型插件&＃xff0c;空项目&＃xff0c;它的结构&＃xff0c;空项目指的是没有在向导自动生成的代码基础上添加一条有效代码。本文假设你已经在Win10上成功搭建3dsmax2022插件开发环境。具体如何搭建3dsmax2022插件开发环境&＃xff0c;参考我的上一篇文章。

 新建空项目

        在Visual Studio 2017中使用3dsmax Wizard新建Utility类型的插件&＃xff0c;假设控件名称为maxEmptyProject&＃xff0c;Category取kagula&＃xff08;你也可以随便取个其它名字&＃xff09;。

        在项目中排除QtPluginRollup.h、QtPluginRollup.cpp这两个文件&＃xff0c;这两个文件对我们Build&Run空插件一点作用都没有。

        Build&Run所需要的文件有八个resouce.h、maxEmptyProject.rc、maxEmptyProject.def&＃xff0c;DllEntry.cpp&＃xff0c;plugin_form.ui&＃xff0c;maxEmptyProject.h&＃xff0c;maxEmptyProject.cpp及3dsmaxsdk_preinclude.h文件。

• maxEmptyProject.def定义了导出函数&＃xff0c;详细信息请查阅Win32编程手册。
• DllEntry.cpp定义入口代码。
• plugin_form.ui是由QT Designer生成的模板&＃xff0c;Compile这个文件后自动产生ui_plugin_form.h文件&＃xff0c;这个文件中的PluginRollup类&＃xff0c;是我们的代码hook视图模板的关键。
• maxEmptyProject的h和cpp文件&＃xff0c;是我们空项目的核心。
• 3dsmaxsdk_preinclude.h文件&＃xff0c;定义了向Output窗口输出信息的宏&＃xff0c;DllEntry.cpp用到了这些宏。
• resource.h、maxEmptyProject.rc定义了字符串资源&＃xff0c;没有rc文件虽然也能通过build&＃xff0c;但是就不能正常显示字符串了。

启动顺序&＃xff08;只列出重要部分&＃xff09;

• 第一步&＃xff1a;DllEntry.cpp&＃xff0c;LibClassDesc函数&＃xff0c;返回给3dsmax类描述&＃xff1a;static maxEmptyProjectClassDesc 。告诉3dsmax需要实例化的class&＃xff0c;maxEmptyProject。
• 第二步&＃xff1a;3dsmax实例化maxEmptyProject类&＃xff0c;这个类会链接由QT Designer制作的模板&＃xff0c;并把前端视图加入到3dsmax Utility控制面板中。

源代码结构

图一  代码结构

整个项目以maxEmptyProject类为核心&＃xff1a;

• BeginEditParams&＃xff0c;控件视图被初始化的时候&＃xff0c;会被3dsmax调用。
• EndEditParams&＃xff0c;控件视图被撤销的时候&＃xff0c;会被3dsmax调用。
• Init、Destroy&＃xff0c;是控件被启动或销毁的时候调用。
• GetInstance&＃xff0c;返回静态单实例。
• DoSomething, 一个Qt Click事件如何链接的例子。

【1】《Creating a Qt-based plug-in》

https://help.autodesk.com/view/MAXDEV/2022/ENU/?guid&＃61;Max_Developer_Help_writing_plug_ins_using_qt_with_3ds_max_plug_ins_creating_a_qt_based_plug_in_html