沈剛 官雄明 馮衛(wèi)星 張杰銘
摘 ?要：Composer player是法國(guó)達(dá)索公司開發(fā)的一款輕量化三維模型播放軟件，輕量化模型的展示在產(chǎn)品驗(yàn)證、推廣、銷售等環(huán)節(jié)起著至關(guān)重要的作用。本文結(jié)合控件提供的開發(fā)接口，簡(jiǎn)要介紹了Web網(wǎng)頁(yè)內(nèi)調(diào)用該控件的方法，并輔以實(shí)例講解控件所提供方法、事件、屬性的調(diào)用步驟。
關(guān)鍵詞：Composer API;二次開發(fā);輕量化模型;網(wǎng)頁(yè)開發(fā)
中圖分類號(hào)：TP311.1 ? ? 文獻(xiàn)標(biāo)識(shí)碼：A
Abstract：Composer player is a 3D model desktop application developed by Dassault Systèmes，which plays significant role in the fields of marketing，sales，customer service，etc.In combination with the API in the ActiveX control，this paper introduces how to use the control and how to call the methods，events，and properties provided by the ActiveX control in a web page.
Keywords：Composer API;secondary development;simplified models;web development
1 ? 引言（Introduction）
Composer是法國(guó)Dassault Systèmes研發(fā)的一款桌面應(yīng)用程序，旨在為非CAD用戶提供一個(gè)可以直接從3D源文檔創(chuàng)建相關(guān)的2D、3D輕量化產(chǎn)品文檔的平臺(tái)，被廣泛應(yīng)用于銷售、市場(chǎng)推廣、客戶服務(wù)、培訓(xùn)、支持等領(lǐng)域[1]。Composer支持直接打開大部分3D CAD設(shè)計(jì)軟件的原始設(shè)計(jì)文檔（Catia、UG、Creo、Solidworks、Inventor），以及各類中間格式，并可以在原始設(shè)計(jì)文檔發(fā)生變更時(shí)，將變更更新到Composer內(nèi)，避免了Composer文檔的重建。
目前，基于Composer的輕量化三維模型可視化系統(tǒng)在各大行業(yè)得到了廣泛的應(yīng)用，相關(guān)研究人員分別提出了三維模型裝配工藝可視化系統(tǒng)[2-4];基于Flash的網(wǎng)絡(luò)教學(xué)虛擬仿真課件平臺(tái)[5]，這些成果重點(diǎn)研究了輕量化模型的展示效果，未對(duì)輕量化平臺(tái)與其他系統(tǒng)集成的具體實(shí)施過程進(jìn)行介紹。本文將重點(diǎn)討論輕量化軟件Composer Player與網(wǎng)頁(yè)集成的詳細(xì)方法。
2 ?網(wǎng)頁(yè)與3D模型的結(jié)合（Combination of 3D modelsand web pages）
Composer最初是達(dá)索公司的獨(dú)立軟件3D Via Composer，后來被分別集成到CatiaV6和Solidworks的安裝包內(nèi)供用戶選擇購(gòu)買安裝，相應(yīng)的名稱分別變更為Catia Composer和Solidworks Composer，但其在使用方法與內(nèi)核上保持一致。
當(dāng)下，越來越多的行業(yè)將產(chǎn)品3D模型置于WEB網(wǎng)站供用戶瀏覽，以此提高客戶對(duì)產(chǎn)品的感知度，幫助客戶制定精準(zhǔn)可靠的采購(gòu)計(jì)劃。WEB作為企業(yè)宣傳的有力保障，相對(duì)于傳統(tǒng)的Word、PPT，其適用面更廣泛，用戶群體更大，更方便用戶通過WEB與產(chǎn)品進(jìn)行互動(dòng)交流操作，更有利于企業(yè)產(chǎn)品的宣傳推廣。
在工業(yè)領(lǐng)域，3D模型零件數(shù)量龐大，產(chǎn)品結(jié)構(gòu)復(fù)雜。為降低企業(yè)設(shè)計(jì)圖紙泄密風(fēng)險(xiǎn)，同時(shí)提高用戶體驗(yàn)，3D模型發(fā)布至網(wǎng)頁(yè)端前的精簡(jiǎn)輕量化必不可少。Composer為企業(yè)提供了可靠的模型輕量化解決方案，同時(shí)開放眾多的API接口，用戶可以靈活地定制符合工作需求的各類命令及功能[6]。
3 ? 二次開發(fā)準(zhǔn)備（Secondary development preparation）
本文將結(jié)合Catia Composer Player Pro的ActivX控件所提供的API，使用Visual Studio 2015作為開發(fā)工具，介紹如何在HTML網(wǎng)頁(yè)內(nèi)調(diào)用接口內(nèi)的事件、方法和屬性。
在進(jìn)行網(wǎng)頁(yè)開發(fā)前，需在電腦上安裝Composer Player軟件并取得相應(yīng)許可。其中，Player ActiveX 內(nèi)的部分功能需取得Pro許可證后方可訪問。控件會(huì)在軟件安裝過程中自動(dòng)注冊(cè)到計(jì)算機(jī)，用戶也可通過安裝路徑內(nèi)的批處理文件“＼bin＼Register.bat”進(jìn)行手動(dòng)注冊(cè)[1]。
4 ? 網(wǎng)頁(yè)框架構(gòu)建（Web framework construction）
4.1 ? 初始化控件
首先，新建一個(gè)ASP.NET空網(wǎng)站，本文以Visual C#語(yǔ)言為例。在新建的空網(wǎng)站項(xiàng)目上添加一個(gè)WEB窗體，并命名為MyWebPlayer。接下來，在該WEB窗體內(nèi)聲明Composer Player ActiveX.ocx控件，OCX控件存放在Composer安裝路徑下。要聲明OCX控件，首先需要獲得控件的ClassID，ClassID是ActiveX控件的唯一標(biāo)識(shí)符，ClassID可以從注冊(cè)表編輯器中獲得。”＼HKEY_CLASSES_ROOT＼CLSID＼{410B702D-FCFC-46B7-A954-E876C84AE4C0}”，花括號(hào)內(nèi)的字符串即為所需ClassID。
在MyWebPlayer.aspx文件的
間使用
標(biāo)簽聲明該控件。
聲明語(yǔ)句中，“id”是用戶為該控件定義的身份標(biāo)識(shí)，用戶通過該id在WEB應(yīng)用程序內(nèi)調(diào)用控件的屬性和方法;“height”和“width”定義了控件在WEB窗口中的大小，WEB應(yīng)用程序通過“classid”調(diào)用ActiveX控件。
同時(shí)，在“”標(biāo)簽內(nèi)通過“
至此，WEB網(wǎng)頁(yè)完成了控件的聲明，用戶可在以IE為內(nèi)核的瀏覽器中查看效果。
4.2 ? 控件交互
網(wǎng)頁(yè)內(nèi)的按鈕、文本框、進(jìn)度條是實(shí)現(xiàn)用戶與操作界面交互的基本手段，交互界面的設(shè)計(jì)應(yīng)力求簡(jiǎn)潔。簡(jiǎn)單易懂的界面設(shè)計(jì)既可以提升用戶使用過程中的易用性，又能夠降低使用者的培訓(xùn)成本[7]。
在WEB頁(yè)面內(nèi)設(shè)計(jì)三個(gè)按鈕，分別用于改變所選零件的顏色、位置，重載默認(rèn)屬性;插入一個(gè)文本框，用于顯示信息。
在
標(biāo)簽內(nèi)聲明鼠標(biāo)左鍵單擊事件，當(dāng)用戶單擊3D零件時(shí)，在文本框內(nèi)顯示所選零件名稱;同時(shí)聲明"EndLoadModel"事件，當(dāng)模型加載完畢后，觸發(fā)該事件，獲取并備份所有幾何模型的默認(rèn)屬性值，默認(rèn)屬性值用于在用戶誤操作后將零件屬性重置為初始值。
ShowName（）; ?//鼠標(biāo)左鍵單擊事件
5 ? 功能實(shí)現(xiàn)（Function implementation）
為實(shí)現(xiàn)用戶的定制化需求，控件內(nèi)提供了大量事件與方法供用戶訪問。本文將控件提供的方法封裝到JavaScript文件內(nèi)，簡(jiǎn)化代碼編寫和調(diào)用過程。
為項(xiàng)目添加一個(gè)Js文件，命名為“MyFunctions.js”。在文件內(nèi)添加函數(shù)以實(shí)現(xiàn)按鈕功能，添加事件響應(yīng)函數(shù)以處理鼠標(biāo)單擊事件。
文中主要使用了API提供的以下接口函數(shù)，如表1所示。
“MyFunctions.js”文件中，各函數(shù)的實(shí)現(xiàn)代碼如下所示：
function SetColor（） { ? //改變所選零件的顏色
var strSelection;
var bValue;
var strPropertySet;
strPropertySet="
strSelection=document._ComposerPlayerActiveX.Selection（）;
bValue=document._ComposerPlayerActiveX.SetPropertySet（strSelection，strPropertySet）;
document._ComposerPlayerActiveX.RefreshScene（1）;
}
function MovePart（） { ? ? //零件平移
var strSelection;
var bValue;
strSelection=document._ComposerPlayerActiveX.Selection（）;
bValue=document._ComposerPlayerActiveX.TranslateInWCS（strSelection，30，0，25）;
document._ComposerPlayerActiveX.RefreshScene（1）;
}
function ShowName（） { ? //鼠標(biāo)單擊事件響應(yīng)
var strSelection;
var TextBox;
TextBox=document.getElementById（"MsgBox"）;
TextBox.value=document._ComposerPlayerActiveX.Selection（）;
}
function RstDft（） { ? ? //恢復(fù)默認(rèn)屬性
var bRtn;
bRtn=document._ComposerPlayerActiveX.SetPropertyMap（strProps）;
document._ComposerPlayerActiveX.RefreshScene（1）;
}
function GetNeutralProps（） { ? ?//獲取默認(rèn)屬性，在模型加載完畢后觸發(fā)事件
var strSelection;
strSelection = document._ComposerPlayerActiveX.GetAllActorsByType（"CLitActorMesh"）;
strProps = document._ComposerPlayerActiveX.GetActorsProperties（strSelection）;
}
在瀏覽器內(nèi)打開網(wǎng)頁(yè)，驗(yàn)證各命令按鈕功能是否與設(shè)計(jì)相符，如圖1所示。
6 ? 結(jié)論（Conclusion）
本文以Visual Studio 2015為開發(fā)平臺(tái)，簡(jiǎn)單介紹了Catia Composer Player ActiveX在WEB端二次開發(fā)的基本流程，并結(jié)合實(shí)例講解了實(shí)際應(yīng)用過程中的關(guān)鍵步驟。定制化的瀏覽器端產(chǎn)品三維展示平臺(tái)的搭建，能夠極大地增強(qiáng)企業(yè)產(chǎn)品的展示效果，助力銷售、研發(fā)、制造等環(huán)節(jié)。
參考文獻(xiàn)（References）
[1] Dassault Systèmes.Composer Programming Guide R2015x.D Systèmes，2014.
[2] 屈力剛，魏佩振，苑俊超.基于三維工藝模型的裝配現(xiàn)場(chǎng)可視化[J].制造業(yè)自動(dòng)化，2013，35（20）：83-87.
[3] 周亞麗，江征風(fēng)，王立偉，等.基于3 DVIA Composer 的金剛石線切割機(jī)裝配工藝可視化研究[J].現(xiàn)代制造工程，2015（3）：71-74.
[4] 彭煜，盛步云，潘陽(yáng)芬，等.基于3DVIA Composer的汽輪機(jī)裝配工藝可視化研究[J].智能制造，2012（4）：87-89.
[5] 谷艷華，朱艷萍，楊得軍，等.用于網(wǎng)絡(luò)教學(xué)的虛擬仿真交互式課件研究[J].圖學(xué)學(xué)報(bào)，2016，37（4）：545-549.
[6] DS SOLIDWORKS公司.SolidWorks Composer使用指南[M].北京：機(jī)械工業(yè)出版社，2014.
[7] 馬躍.SolidWorksComposerAPI應(yīng)用小窺[J].智能制造，2015（11）：56-59.
作者簡(jiǎn)介：
沈 ?剛（1990-），男，碩士，助理工程師.研究領(lǐng)域：軟件開發(fā).
官雄明（1988-），男，碩士，助理工程師.研究領(lǐng)域：虛擬仿真.
馮衛(wèi)星（1972-），男，本科，助理工程師.研究領(lǐng)域：機(jī)械設(shè)計(jì).
張杰銘（1987-），男，本科，工程技術(shù)員.研究領(lǐng)域：前端設(shè)計(jì).
