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,选择程序生成位置,完成后选择确定。

image002.jpg 

图3-1

3.2选择下一步。

image003.jpg 

图3-2

3.3 选择应用程序类型为DLL,选择附加选项为空项目,然后点击完成。

image004.jpg 

图3-3

3.4 右键FileExport项目,选择添加,选择新建项,或者使用快捷键Ctrl+Shift+A,分别创建FileExport.cpp源文件和FileExport.def文件。

image005.jpg 

图3-4

image006.jpg 

图3-5

image007.jpg 

图3-6

3.5 右键FileExport项目,选择属性,进入FileExport属性页。(注意:如果是64位系统,平台必须选择X64!)选择C++,选择常规,选择附件包含目录,在该目录中输入安装目录下API文件夹的地址,如图3-7所示。

image008.jpg 

图3-7

3.6在FileExport属性页中,选择链接器,选择常规,在附加库目录中输入中望3D安装目录地址,(注意:如果是64位系统,平台必须选择X64!)如图3-8所示。

image009.jpg 

图3-8

3.7 在FileExport属性页中,选择链接器,选择输入,在附加依赖项中输入zw3d.lib,(注意:如果是64位系统,平台必须选择X64!)如图3-9所示。

image010.jpg 

图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;

};

image011.jpg 

图3-10

3.9 输入以下代码,定义项目中的FileExport.def文件。

LIBRARYFileExport.dll

EXPORTS

FileExportInit

FileExportExit

FileExportImg

FileExportPdf

image012.jpg 

图3-11

3.11 右键FileExport项目选择生成,在该项目目录中Debug文件夹下会产生FileExport.dll应用程序文件。

image013.jpg 

图3-12

3.12 在中望3D安装目录下,新建文件夹apilibs文件夹,将FileExport.dll文件复制到该文件夹中,即在中望3D中加载该应用程序。

image014.jpg 

图3-13

3.13 打开中望3D,选择应用程序管理器,选择插件应用程序。我们可以看到,FileExport程序已经加载到了中望3D。

image015.jpg 

图3-14

3.14 下面我们来使用一下这个程序,在中望3D中新建一个块零件并保存到桌面,然后在命令框中输入~符号,然后通过方向键选中FileExportPdf应用程序,然后回车输入该程序,在桌面我们得到了这个零件的3D PDF文件。

image016.jpg

image017.jpg  

图3-15

4.定制二次开发工具栏

每次要在输入框中手动输入~FileExportPdf命令太麻烦,下面,我们来介绍一下如何将二次开发程序添加到工具栏或指定位置。

4.1 在中望3D零件环境下,选择工具,选择自定义,进入自定义界面。

image018.jpg 

图4-1

4.2 在自定义命令界面中,点击添加命令按钮,按图4-2依次输入按钮名称、PNG图标等属性。

image019.jpg 

图4-2

4.3 在自定义转换界面中,先找到4.2中创建的FileExport命令。然后,用鼠标将该命令拖动到图4-3所示位置,或者拖动到您所指定的位置,选择应用。

 image020.jpg

图4-3

5.命令使用测试

这样我们就在中望3D实用工具栏中添加了FileExport这个命令按钮,接下来,我们就可以直接在造型选项栏中使用该命令了,在测试零件所在位置就可以得到一个3D PDF,如图5-1所示。

 image021.jpg

image022.jpg 

图5-1

总结:

本教程给大家简单介绍了中望3D二次开发的流程,思路是在Visual Studio中创建dll程序,再将该程序加载到中望3D中。通过二次开发,我们将原本需要点四步的操作,简化到只需要一步,大大提高了工作效率,当然,在此教程的基础上,我们还可以进一步开发,将输出PDF的操作批量化,附件是本教程的所有程序,大家一起动手,开启您的中望3D私人定制之旅吧!

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

Z3是什么格式文件:http://www.zw3d.com.cn/blog/201503131763.html

image023.jpg

最新资讯 经验技巧 CAD常见问题