OpenCASCADE STEP Color
Abstract. STEP AP214的STEP中是帶有顏色信息的，OCCT可以讀取其中的顏色信息。本文介紹一種比官方XCAFDoc_ColorTool更方便的獲取方法。
Key Words. OCCT, STEP, Color
1. Introduction
STEP是通用格式，常用的3D軟件都可以打開，用於不同的軟件之間相互交流之用。OCCT的Data Exchange模塊支持STEP格式的讀寫功能，其中支持STEP的AP203和AP214版本，這兩者有什麼區別呢？下面從網上摘取如下解釋：
應用協議(APs: Application Protocol)是用來交換數據。每種應用協議屬於一個不同的應用領域。例如,AP227屬於空間裝置技術和包含幾個實體屬於這個區域,如管道Pipe或彎頭Elbow。此外,這些APs使用某些公共實體稱爲通用資源,如幾何和拓撲結構,定義實體模型。
AP203適用於機械零件和組件的表示。AP214適用於數據的表示有關汽車設計。今天AP203文件通常包含邊界表示模型、裝配數據和數量有限的其他產品信息。
AP214文件通常包含顏色,層,和通用資源。邊界表示法的模型是一個CAD模型代表它的邊界。例如,一個表面模型由只有表面使用,使模型。固體模型包括幾何信息,如表面,曲線,並指出,和拓撲信息,比如邊緣,頂點,面臨着。幾何信息提供了數據模型的形式,和拓撲信息提供這些幾何元素之間的連接性和幾何元素的程度。
相同點：AP214 AP203均支持的實體、面的輸入和輸出。
區別是：STEP AP203 標準不具有任何顏色，AP214標準具有顏色的。
縮上所述，當以AP203應用協議保存STEP後，只保存了幾何模型，沒有顏色數據。當需要在STEP中體現顏色，就需要以AP214來保存。
爲了更好的顯示STEP模型或者需要將STEP中的模型及顏色轉換到其他格式，需要獲取STEP中的顏色信息。本文主要介紹如何在OCCT中讀取AP214的STEP中的顏色信息。
2. STEP in Draw
在Draw Test Harnes中對應AP203和AP214分別有兩個命令來讀取STEP文件：
l stepread：對應AP203協議，只讀取STEP中的模型；
l ReadStep：對應AP214協議，能讀取STEP中的模型、顏色、組裝結構等；
通過命令ReadStep讀取進來的模型，可以顯示顏色：
從ReadStep命令提示中可以看出，讀取AP214的STEP需要用到OCCT的應用程序框架中的文檔。即需要使用Extended Data Exchange(XDE)來讀取。
3. Access STEP Color
在XDE中可以讀寫模型的顏色信息，支持的三種顏色類型爲：
l Generic Color (XCAFDoc_ColorGen) 通用顏色
l Surface Color (XCAFDoc_ColorSurf) 曲面顏色
l Curve Color (XCAFDoc_ColorCurv) 曲線顏色
在XDE文檔中，顏色是通過類XCAFDoc_ColorTool來管理的，即通過這個類可以來設置、獲取每個Label的顏色，包括Label的子Label。可以通過類的函數IsSet()來檢查一個節點是否設置了指定類型的顏色：
獲取一個節點或模型顏色的方法如下：
使用這些函數當然可以獲得STEP中模型的顏色信息，但當模型很大，而且還帶有複雜的裝配結構時要求就高了，需要你瞭解CAF中的數據結構，對裝配結構進行遍歷，還要處理子節點的模型變換。既然OCCT的DRAW中可以顯示出帶顏色的STEP模型，說明OCCT中有現成的功能。怎麼找到這個功能呢？還是要從DRAW中去找。
4. OCCT Solution
對於有一定開發經驗的OCCT開發者，我建議使用或開發OCCT的流程是：首先在DRAW中，利用Tcl腳本來實現原型或檢驗一些功能。其次纔是寫C++代碼。雖然OCCT面向對象做得很好，但是有些類的參數設置不當，得到的結果也並非所願。而在DRAW中就可以很容易地來調整一些參數，方便查看結果。如果在DRAW中的結果與期望一致，還可以查看DRAW中相關命令的源碼，看官方的使用方法。
在DRAW模塊中找到XDE讀取STEP的命令實現源碼：ReadStep
可以看官方使用類STEPCAFControl_Reader來讀取STEP文件。而顯示XDE的文檔使用命令XShow，實現源碼如下：
從上圖可以看到，官方在這裏已經不用XCAFDoc_ColorTool來處理其中的顏色了！將其註釋掉啦。那麼官方是怎麼處理其中的顏色呢？通過Debug跟蹤源碼，可以發現是使用了類XCAFPrs_AISObject，核心算法實現是在類的函數void XCAFPrs_AISObject::DispatchStyles (const Standard_Boolean theToSyncStyles)中，如下圖所示：
XCAFPrs::CollectStyleSettings()函數是個遞歸函數，用來處理STEP中裝配結構中的顏色及模型變換。
5. Conclusion
綜上所述，若想獲取STEP中模型對應的顏色，只需要用類XCAFPrs_AISObject即可，也不需要考慮子節點的模型變換問題，OCCT已經爲你考慮並處理好了。
Draw的源碼是個藏寶庫和百科書，若有問題可以先在Draw中測試，若滿足需求，進而可以找到官方的源碼實現。