2.文件到文件轉換?本教程將引導您完成sample_import_export示例代碼的學習該示例是 HOOPS Exchange 中包含的示例之一。此示例演示了讀取輸入文件并將其導出為新格式的基本工作流程。前提條件是請確保您已完成之前的教程“設置環(huán)境”。請確保您可以構建并運行ImportExport示例。示例代碼位于軟件包的csharp/samples文件夾中。2.1代碼?在編輯器中打開ImportExport.cs 文件。由于該示例是一個完整的實現(xiàn)您無需向程序中添加任何新內(nèi)容。為了便于學習我們將深入分析每個功能區(qū)域并詳細解讀代碼的運行機制。首先你會注意到這個示例運行需要用到 C# 程序集。在本例中我們使用了using TS3D.Exchange;using TS3D.Exchange.Direct;此示例需要一些命令行參數(shù)HOOPS Exchange 庫的路徑、輸入文件名和輸出文件名。從這里開始Main第一個重要的步驟是解析命令行參數(shù)。這在 中處理ParseArgs。如果運行程序時未指定輸入和/或輸出文件則使用默認值默認輸入文件為HOOPS_EXCHANGE_INSTALL_DIRsamples/data/catiaV5/CV5AquoBottle/Aquo Bottle.CATProduct。默認輸出文件是輸入文件名加上后綴.prc。默認值表示我們將 Catia V5 輸入文件轉換為其 PRC 等效文件。接下來該示例連接日志文件的回調(diào)函數(shù)和各種回調(diào)函數(shù)。// Initialize log file and HOOPS Exchange callbacksLogFile newStreamWriter(outputLogFile); API.A3DDllSetCallbacksReport(MessageCallback, WarningCallback, ErrorCallback);雖然使用 HOOPS Exchange 并非必須但這些回調(diào)函數(shù)可以在調(diào)試時提供有價值的信息。所有示例都會將回調(diào)函數(shù)接收到的消息打印出來stdout。接下來初始化 HOOPS 交易所。// Initialize HOOPS Exchange librarytry{ Library.Initialize(HOOPS_LICENSE.KEY, exchangeFolder); }catch(Library.InitializationException e) {// handle errorConsole.WriteLine(e.Message);return(int) A3DStatus.A3D_ERROR; }該類Library允許我們訪問 HOOPS Exchange 庫對象。在使用 HOOPS Exchange 功能之前需要先對其進行初始化。如果您尚未在環(huán)境中的其他位置設置許可證密鑰則可以在此處設置。應用程序還需要知道 Exchange 庫的位置。該exchangeFolder參數(shù)是這些庫的路徑。完成初始化步驟后文件將被加載。但在此之前我們需要設置其參數(shù)。您將看到以下代碼行// initialize load parameters objectA3DRWParamsLoadData loadParams; API.Initialize(outloadParams);// set load parametersloadParams.m_sGeneral.m_bReadSolids true; loadParams.m_sGeneral.m_bReadSurfaces true; loadParams.m_sGeneral.m_bReadWireframes true; loadParams.m_sGeneral.m_bReadPmis true; loadParams.m_sGeneral.m_bReadAttributes true; loadParams.m_sGeneral.m_bReadHiddenObjects true; loadParams.m_sGeneral.m_bReadConstructionAndReferences false; loadParams.m_sGeneral.m_bReadActiveFilter true; loadParams.m_sGeneral.m_eReadingMode2D3D A3DEReadingMode2D3D.kA3DRead_3D; loadParams.m_sGeneral.m_eReadGeomTessMode A3DEReadGeomTessMode.kA3DReadGeomAndTess; loadParams.m_sGeneral.m_eDefaultUnit A3DEUnits.kA3DUnitUnknown; loadParams.m_sTessellation.m_eTessellationLevelOfDetail A3DETessellationLevelOfDetail.kA3DTessLODMedium; loadParams.m_sAssembly.m_bUseRootDirectory true; loadParams.m_sMultiEntries.m_bLoadDefault true; loadParams.m_sPmi.m_bAlwaysSubstituteFont false; loadParams.m_sPmi.m_pcSubstitutionFont Myriad CAD;該行代碼初始化加載器的參數(shù)結構。這些參數(shù)供應用程序的文件加載器使用并指示應加載哪些結構。由于不同的文件格式支持不同的結構因此這些參數(shù)可能因您嘗試加載的文件類型以及應用程序所需的結構而異。API.Initialize(out loadParams);筆記您可以找到支持的參數(shù)列表A3DRWParamsGeneralData。接下來使用上一步中初始化的參數(shù)加載文件// Load input CAD fileIntPtr modelFile; A3DStatus loadStatus API.A3DAsmModelFileLoadFromFile(inputFile,refloadParams,outmodelFile);其中inputFile是命令行參數(shù)loadParams是上一步的結果modelFile是翻譯后要寫入的 PRC 文件名。暗示使用函數(shù)的返回值檢查負載狀態(tài)始終是一個好習慣。它的類型為A3DStatus文件加載完畢后我們將導出它。翻譯會在寫入操作期間自動處理。我們只需指定文件類型這由outputFile擴展名隱含。成功執(zhí)行的函數(shù)會返回A3DStatus.A3D_SUCCESS.// Export output CAD fileA3DStatus exportStatus Export(modelFile, outputFile);if(exportStatus A3DStatus.A3D_SUCCESS) { Console.WriteLine(Success.); }else{ Console.WriteLine(Failure.); }注意不同的對象modelFile以及outputFile。modelFile是一個內(nèi)存中的對象它在邏輯上表示輸出文件。outputFile僅僅是文件名string。如果申請成功文件將被轉換?，F(xiàn)在我們應該干凈利落地終止程序。由于 C# API 只是一組綁定內(nèi)存占用在 C 二進制文件中。因此當不再需要這些對象時必須顯式地釋放它們。以下代碼片段釋放模型文件對象然后卸載 C 二進制文件。API.A3DAsmModelFileDelete(modelFile); Library.Free();2.2樣本調(diào)查?在本節(jié)中我們將調(diào)整代碼并查看變化。視窗LinuxmacOS更改命令行在 Visual Studio 的解決方案樹資源管理器中找到樣本ImportExport右鍵單擊并選擇“屬性”。在“調(diào)試”選項卡下編輯“命令參數(shù)”設置以更改輸入 CAD 文件和輸出。假設 HOOPS Exchange API 包安裝在磁盤根目錄則C:命令參數(shù)如下所示C:\HOOPS_EXCHANGE_INSTALL_DIR\samples\data\catiaV5\CV5_Aquo_Bottle\Bullet_Lid_Cap.CATPart C:\HOOPS_EXCHANGE_INSTALL_DIR\samples\data\catiaV5\CV5_Aquo_Bottle\Bullet_Lid_Cap.CATPart.stl運行示例ImportExport將名為Bullet_Lid_Cap.CATPart的 CATIA V5 零件轉換為 STL 格式。在輸出文件夾中找到文件Bullet_Lid_Cap.CATPart.stl 。打開 HOOPS Demo Viewer 桌面應用程序然后將生成的Bullet_Lid_Cap.CATPart.stl文件拖放到該應用程序中即可快速查看零件更改轉換設置在 Visual Studio 的解決方案樹資源管理器中找到示例ImportExport在“調(diào)試”選項卡下編輯“命令參數(shù)”設置以指定輸入 CAD 文件和輸出。假設 HOOPS Exchange API 包安裝在磁盤根目錄則C:命令參數(shù)如下所示C:\HOOPS_EXCHANGE_INSTALL_DIR\samples\data\pmi\PMI_Sample\CV5_Sample.CATPart C:\HOOPS_EXCHANGE_INSTALL_DIR\samples\samples\data\pmi\PMI_Sample\CV5_Sample.CATPart.prc運行示例程序將文件CV5_Sample.CATPart轉換為 PRC 格式。在 HOOPS Demo Viewer 中找到并拖放生成的CV5_Sample.CATPart.prc文件即可在輸出文件夾中查看該零件找到并打開安裝文件夾../include/中的A3DSDKInternalConvert.hxx文件。您現(xiàn)在正在查看文件A3DSDKInternalConvert.hxxA3DRWParamsGeneralData 其中公開了所有轉換參數(shù)。A3DRWParamsGeneralData m_sGeneral;/*! The general reading parameters. */A3DRWParamsPmiData m_sPmi;/*! The parameters for PMI reading. Used when m_sGeneral.m_bReadPmis is true. */A3DRWParamsTessellationData m_sTessellation;/*! The tessellation reading parameters. */A3DRWParamsAssemblyData m_sAssembly;/*! The reading parameters used to load Assembly files. */A3DRWParamsMultiEntriesData m_sMultiEntries;/*! The parameters used when reading multiple models. */A3DRWParamsSpecificLoadData m_sSpecifics;/*! The parameters specific to each CAD format. */A3DRWParamsIncrementalLoadData m_sIncremental;/*! The reading parameters used to load specific parts of an assembly. */A3DRWParamsLoadData;可以根據(jù)需要添加和編輯導入和導出參數(shù)。我們來看一個例子找到設置m_sLoadData.m_sGeneral.m_bReadPmis true;將其值更改為設置m_sLoadData.m_sGeneral.m_bReadPmis false;重新構建并運行示例將文件CV5_Sample.CATPart再次轉換為 PRC 格式。在HOOPS Demo Viewer中找到并拖放生成的CV5_Sample.CATPart.prc文件即可查看該零件。比較生成的兩個CV5_Sample.CATPart.prc文件。如您所見關閉導入?yún)?shù)后產(chǎn)品和制造信息將不會被轉換。m_sLoadData.m_sGeneral.m_bReadPmis true;2.3結論?文件到文件的轉換工作流程是評估 HOOPS Exchange 功能的常用起點。使用ImportExport產(chǎn)品附帶的示例您可以輕松地將文件從一種格式轉換為另一種格式。完成本教程后您已掌握如何在這個基本用例中使用 HOOPS Exchange。此外通過研究相關輔助類的實現(xiàn)您將對 API 本身的使用有更深入的了解。