【实例教程】中望3D PDF输出控件制作

Abby001

       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文件。

       LIBRARY        FileExport.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的操作批量化，附件是本教程的所有程序，大家一起动手，开启您的中望3D私人定制之旅吧！

       马上下载中望3D2017版，体验智能设计，让创意无极限：https://www.zw3d.com.cn/product-58-1.html

       Z3是什么格式文件：https://www.zw3d.com.cn/blog/20150313176