1.引言
使用三维CAD软件的工程师都知道，要将三维模型保存成3D PDF格式，需要通过另存为，选择PDF格式才可以。如果一个装配中有多个零件需要存成3D PDF格式，操作就比较繁琐。在这种情况下，可利用中望3D的API函数，根据客户的特殊用途进行软件的个性化定制和二次开发，从而大大提高工作的效率，深度满足企业的要求。
2.二次开发准备
2.1系统需求：
1）Windows7 或以上系统；
2）Visual Studio 2012（或者任意能够创建C/C++的IDE工具）；
3）中望3D 2012或以上版本软件（本文使用中望3D 2017）；
3.创建二次开发程序
3.1 打开Visual Studio 2012，选择新建项目，选择Win32控制台应用程序，然后在名称中输入FileExport，选择程序生成位置，完成后选择确定。
图3-1
3.2选择下一步。
图3-2
3.3 选择应用程序类型为DLL，选择附加选项为空项目，然后点击完成。
图3-3
3.4 右键FileExport项目，选择添加，选择新建项，或者使用快捷键Ctrl+Shift+A，分别创建FileExport.cpp源文件和FileExport.def文件。
图3-4
图3-5
图3-6
3.5 右键FileExport项目，选择属性，进入FileExport属性页。（注意：如果是64位系统，平台必须选择X64！）选择C++，选择常规，选择附件包含目录，在该目录中输入安装目录下API文件夹的地址，如图3-7所示。
图3-7
3.6在FileExport属性页中，选择链接器，选择常规，在附加库目录中输入中望3D安装目录地址，（注意：如果是64位系统，平台必须选择X64！）如图3-8所示。
图3-8
3.7 在FileExport属性页中，选择链接器，选择输入，在附加依赖项中输入zw3d.lib，（注意：如果是64位系统，平台必须选择X64！）如图3-9所示。
图3-9
3.8输入以下代码，定义项目中的FileExport.cpp文件。
#include<stdio.h>
#include<string.h>
#include"VxApi.h"
intFileExportPdf(void);
intFileExportInit(intformat, void *data)
{
cvxCmdFunc("FileExportPdf", (void*)FileExportPdf, VX_CODE_GENERAL);
return 0;
}
intFileExportExit(void)
{
cvxCmdFuncUnload("FileExportImg");
cvxCmdFuncUnload("FileExportPdf");
return 0;
}
intFileExportPdf(void)
{
intiRet = 0;
vxNameExportName;
vxPathFilePath;
svxPdfDataPdfData;
cvxFileDirectory(FilePath);
iRet = strcpy_s(ExportName, "test.pdf");
if (FilePath[0])
iRet = cvxPathCompose(FilePath, ExportName);
else
iRet = strcpy_s(FilePath, "test.pdf");
if (iRet)
{
cvxMsgDisp("Fail to find the export path.");
returniRet;
}
cvxMemZero((void*)&PdfData, sizeof(PdfData));
PdfData.PaperHeight = 300;
PdfData.PaperWidth = 220;
PdfData.RangeMode = VX_EXPORT_PDF_RANGE_MODE_NORMAL;
PdfData.Type = VX_EXPORT_PDF_TYPE_OBJECT;
iRet = cvxFileExport(VX_EXPORT_TYPE_PDF, FilePath, (void*)&PdfData);
if (iRet)
cvxMsgDisp("Fail to save as pdf format.");
else
cvxMsgDisp("File is saved successfully.");
returniRet;
};
图3-10
3.9 输入以下代码，定义项目中的FileExport.def文件。
LIBRARYFileExport.dll
EXPORTS
FileExportInit
FileExportExit
FileExportImg
FileExportPdf
图3-11
3.11 右键FileExport项目选择生成，在该项目目录中Debug文件夹下会产生FileExport.dll应用程序文件。
图3-12
3.12 在中望3D安装目录下，新建文件夹apilibs文件夹，将FileExport.dll文件复制到该文件夹中，即在中望3D中加载该应用程序。
图3-13
3.13 打开中望3D，选择应用程序管理器，选择插件应用程序。我们可以看到，FileExport程序已经加载到了中望3D。
图3-14
3.14 下面我们来使用一下这个程序，在中望3D中新建一个块零件并保存到桌面，然后在命令框中输入~符号，然后通过方向键选中FileExportPdf应用程序，然后回车输入该程序，在桌面我们得到了这个零件的3D PDF文件。
图3-15
4.定制二次开发工具栏
每次要在输入框中手动输入~FileExportPdf命令太麻烦，下面，我们来介绍一下如何将二次开发程序添加到工具栏或指定位置。
4.1 在中望3D零件环境下，选择工具，选择自定义，进入自定义界面。
图4-1
4.2 在自定义命令界面中，点击添加命令按钮，按图4-2依次输入按钮名称、PNG图标等属性。
图4-2
4.3 在自定义转换界面中，先找到4.2中创建的FileExport命令。然后，用鼠标将该命令拖动到图4-3所示位置，或者拖动到您所指定的位置，选择应用。
图4-3
5.命令使用测试
这样我们就在中望3D实用工具栏中添加了FileExport这个命令按钮，接下来，我们就可以直接在造型选项栏中使用该命令了，在测试零件所在位置就可以得到一个3D PDF，如图5-1所示。
图5-1
总结：
本教程给大家简单介绍了中望3D二次开发的流程，思路是在Visual Studio中创建dll程序，再将该程序加载到中望3D中。通过二次开发，我们将原本需要点四步的操作，简化到只需要一步，大大提高了工作效率，当然，在此教程的基础上，我们还可以进一步开发，将输出PDF的操作批量化！
