二次開發實例教程：中望3D PDF輸出控制項製作

1.引言

使用三維CAD軟體的工程師都知道，要將三維模型保存成3D PDF格式，需要通過另存為，選擇PDF格式才可以。如果一個裝配中有多個零件需要存成3D PDF格式，操作就比較繁瑣。在這種情況下，可利用中望3D的API函數，根據客戶的特殊用途進行軟體的個性化定製和二次開發，從而大大提高工作的效率，深度滿足企業的要求。

2.二次開發準備

2.1系統需求：

• Windows7 或以上系統；
• Visual Studio 2012（或者任意能夠創建C/C++的IDE工具）；
• 中望3D 2012或以上版本軟體（本文使用中望3D 2017）；

3.創建二次開發程序

3.1 打開Visual Studio 2012，選擇新建項目，選擇Win32控制台應用程序，然後在名稱中輸入FileExport，選擇程序生成位置，完成後選擇確定。3.2在彈出的對話框中選擇【下一步】。 3.3 選擇應用程序類型為DLL，選擇附加選項為空項目，然後點擊【完成】。3.4 右鍵FileExport項目，選擇添加，選擇新建項，或者使用快捷鍵Ctrl+Shift+A，分別創建FileExport.cpp源文件和FileExport.def文件。 3.5 右鍵FileExport項目，選擇屬性，進入FileExport屬性頁。（注意：如果是64位系統，平台必須選擇X64！）選擇C++，選擇常規，選擇附件包含目錄，在該目錄中輸入安裝目錄下API文件夾的地址，如圖5所示。 3.6在FileExport屬性頁中，選擇鏈接器，選擇常規，在附加庫目錄中輸入中望3D安裝目錄地址，（注意：如果是64位系統，平台必須選擇X64！）。3.7 在FileExport屬性頁中，選擇鏈接器，選擇輸入，在附加依賴項中輸入zw3d.lib，（注意：如果是64位系統，平台必須選擇X64！）如圖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);elseiRet = 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.");elsecvxMsgDisp("File is saved successfully.");returniRet;};3.9 輸入以下代碼，定義項目中的FileExport.def文件。LIBRARY FileExport.dllEXPORTSFileExportInitFileExportExitFileExportImgFileExportPdf3.11 右鍵FileExport項目選擇生成，在該項目目錄中Debug文件夾下會產生FileExport.dll應用程序文件。3.12 在中望3D安裝目錄下，新建文件夾apilibs文件夾，將FileExport.dll文件複製到該文件夾中，即在中望3D中載入該應用程序。3.13 打開中望3D，選擇應用程序管理器，選擇插件應用程序。我們可以看到，FileExport程序已經載入到了中望3D。3.14 下面我們來使用一下這個程序，在中望3D中新建一個塊零件並保存到桌面，然後在命令框中輸入~符號，然後通過方向鍵選中FileExportPdf應用程序，然後回車輸入該程序，在桌面我們得到了這個零件的3D PDF文件。圖10

4.定製二次開發工具欄

每次要在輸入框中手動輸入~FileExportPdf命令太麻煩，下面，我們來介紹一下如何將二次開發程序添加到工具欄或指定位置。4.1 在中望3D零件環境下，選擇工具，選擇自定義，進入自定義界面。4.2 在自定義命令界面中，點擊添加命令按鈕，按圖11依次輸入按鈕名稱、PNG圖標等屬性。4.3 在自定義轉換界面中，先找到4.2中創建的FileExport命令。然後，用滑鼠將該命令拖動到圖12所示位置，或者拖動到您所指定的位置，選擇應用。

5.命令使用測試

這樣我們就在中望3D實用工具欄中添加了FileExport這個命令按鈕，接下來，我們就可以直接在造型選項欄中使用該命令了，在測試零件所在位置就可以得到一個3D PDF，如圖13所示。

總結：

本教程給大家簡單介紹了三維CAD/CAM軟體中望3D二次開發的流程，思路是在Visual Studio中創建dll程序，再將該程序載入到中望3D中。通過二次開發，我們將原本需要點四步的操作，簡化到只需要一步，大大提高了工作效率，當然，在此教程的基礎上，我們還可以進一步開發，將輸出PDF的操作批量化，附件是本教程的所有程序，大家一起動手，開啟您的中望3D私人定製之旅吧！