引擎模組其實就是之前我們說的App-Command-Tool模組,透過這個模組,把系統的主幹框架搭建起來。
其中大部分出現在選單以及工具條上的按鈕都會繼承這個框架定義ICommand和ITool。整個系統也是透過整合一些列Comand和Tool的方式,把整個系統搭建出來,這點也可以透過我們系統的主窗體程式碼中看到。
一些常用的工具,例如地圖放大、縮小、平移等。這些工具要求定義能夠被框架引擎識別,並且符合當前使用的UI風格。定義如下。
this.UI_Tool_Bar.Items.Add(new BarCheckItemCommandUI(new FrameworkUI.MapTools.MapZoomInTool(this._MapApplication))); this.UI_Tool_Bar.Items.Add(new BarCheckItemCommandUI(new FrameworkUI.MapTools.MapZoomOutTool(this._MapApplication))); FrameworkUI.MapTools.MapPanTool myMapPanTool = new FrameworkUI.MapTools.MapPanTool(this._MapApplication); this.UI_Tool_Bar.Items.Add(new BarCheckItemCommandUI(myMapPanTool)); this._MapApplication.MapPanTool = myMapPanTool; this._MapApplication.CrruteTool = myMapPanTool; this.UI_Tool_Bar.Items.Add(new BarButtonItemCommandUI(new FrameworkUI.MapTools.MapFullExtentCommand(this._MapApplication))); this.UI_Tool_Bar.Items.Add(new BarButtonItemCommandUI(new FrameworkUI.MapTools.MapZoomInFixedCommand(this._MapApplication))); this.UI_Tool_Bar.Items.Add(new BarButtonItemCommandUI(new FrameworkUI.MapTools.MapZoomOutFixedCommand(this._MapApplication))); this.UI_Tool_Bar.Items.Add(new BarButtonItemCommandUI(new FrameworkUI.MapTools.MapZoomBackCommand(this._MapApplication))); this.UI_Tool_Bar.Items.Add(new BarButtonItemCommandUI(new FrameworkUI.MapTools.MapZoomForwardCommand(this._MapApplication)));
通用模組設計主要包括一些比較通用且核心的模組定義。目前我開發的GeoChem系統定義了三個模組。進度資訊模組,Geoprocessor擴充套件模組和多語言支援模組。
能在Core裡面出現的模組,要滿足通用性以及核心性兩點。我們以最簡單的ProcessInfo為例,來說明這樣的模組的特性。
配合這個ProcessInfo的是FrameworkUI裡面定義的ProcessInfoDialog對話方塊,定義如下。
設計一,在ProcessInfoDialogHelper使用了一個新執行緒彈出進度對話方塊,在主執行緒進行運算的時候,進度條可以很順暢的響應進度變化不會卡。
設計二,ProcessInfo定義了SubProcessInfo的概念,可以很好的和子函式銜接。例如一個模型計算,有5個步驟,A(10)、B(30)、C(60)、D(90)、E(100)。其中兩個步驟比較複雜,其中B包含3個步驟,B1(20)、B2(80)、B3(100)。D包含了5個步驟,分別是和D1(20)、D2(40)、D3(60)、D4(80)、D5(100)。如何把B和D的計算進度反饋更方便的反饋給計算模型呢?
版本1,不關注B和D的細節了,進度到了A之後,進度條不在動了,只是更新上面的計算資訊,等B計算完,一下跳到B該有的進度。D同理。
版本2,加入B是一個專門為本模型定義的一個函式,那麼可以把ProcessInfo傳入進去,直接設定B1的計算完值為14%,B2計算完之後,設定為26%,B3計算完設定為30%。假如D是一個通用的函式,除了該模組呼叫,其他模組也會呼叫,那麼可以傳ProcessInfo進入,然後再傳起始進度值和結束進度值進度。例如呼叫D,傳入ProcessInfo和60、90。計算完D1,設定進度之為60+(90-60)*20%,依次類推。
版本3,設計了SubProcess的概念。當模型呼叫B的時候,會呼叫主ProcessInfo,建立一個子ProcessInfo,並設定這個子ProcessInfo應該進度到何值。當子ProcessInfo進度值發生變化的時候,反饋給其父ProcessInfo,由父ProcessInfo計算自己應該前進多少進度。二接收子ProcessInfo的函式,還是設定進度從0-100即可。
public void Exe(ProcessInfo pProcessInfo) { //獲取柵格CellSize pProcessInfo.SetProcess(5, "Get cell size..."); double myCellSize = GetRasterCellSize(); //提取柵格資料的範圍 pProcessInfo.SetProcess(10, "Data Extent..."); string myRasterDomainFile = this.GetRasterDomain(); //平滑資料 pProcessInfo.SetProcess(12, "Smooth Data..."); string myRasterFilePath = this.SmoothData(this.RasterFilePath); //生成等值線 pProcessInfo.SetProcess(20, "ContourList..."); string myContourLineFile = this.CreateContourLine(myRasterFilePath); //調整等值線值的資料精度 pProcessInfo.SetProcess(25, "Calculate CONTOUR field..."); this.AdjustAccuracy(myContourLineFile); //平滑等值線 pProcessInfo.SetProcess(30, "SmoothLine..."); myContourLineFile = this.SmoothContourLine(myContourLineFile, myCellSize); //用柵格資料的範圍裁切等值線 pProcessInfo.SetProcess(35, "Clip Contour Line..."); myContourLineFile = this.ClipContourLineByRasterDomain(myContourLineFile, myRasterDomainFile); //根據等值線,生成等值面 pProcessInfo.SetProcess(40, "Create Contour Polygon"); pProcessInfo.StartSubProcess(70); string myContourPolygonFile = this.GetContourPolygonFile(pProcessInfo.SubProcessInfo, myContourLineFile, myRasterDomainFile); pProcessInfo.EndSubProcess(); //得到切割時使用的 Shape檔案 pProcessInfo.SetProcess(75, "Clip data..."); this.ClipContourLineAndPolygon(myRasterDomainFile, ref myContourLineFile, ref myContourPolygonFile); //刪除面積較為小的面 pProcessInfo.SetProcess(88, "Eliminate Small Area..."); this.ContourEliminate(ref myContourLineFile, ref myContourPolygonFile); //計算極值標註 pProcessInfo.SetProcess(90, "Create Limite Value Point..."); this.UpdateThresholdLabel(myContourPolygonFile); pProcessInfo.SetProcess(95, "Save Map Document..."); this.SaveAsMxdFile(myContourLineFile, myContourPolygonFile); pProcessInfo.SetProcess(100, "Complete!"); }
使用子進度物件的函式定義如下。
private string GetContourPolygonFile(ProcessInfo pProcessInfo, string pContourLineFile, string pRasterDomainFile) { var myContourPolygonCal = new ContourPCreator { ContourLineFilePath = pContourLineFile, ExtentFilePath = pRasterDomainFile, ResultPolygonFilePath = FilePathHelper.GetTempShapeFilePath() }; myContourPolygonCal.Exe(pProcessInfo); return myContourPolygonCal.ResultPolygonFilePath; }
ContourPCreator類的Exe函式定義如下。
public void Exe(ProcessInfo pProcessInfo) { this._PolygonList.Clear(); this._PolylineList.Clear(); //把線轉換成面 pProcessInfo.SetProcess(0, "Feature To Polygon..."); var myPolygonFilePath = FilePathHelper.GetTempShapeFilePath(); var myFeatureToPolygon = new FeatureToPolygon() { in_features = this.ContourLineFilePath + ";" + this.ExtentFilePath, out_feature_class = myPolygonFilePath, cluster_tolerance = "0.001 Meters" }; GPEx myGPEx = new GPEx(); myGPEx.Execute(myFeatureToPolygon); //用柵格範圍裁切面 string myClipOutFilePath = FilePathHelper.GetTempShapeFilePath(); pProcessInfo.SetProcess(10, "Clip..."); var myClip = new ESRI.ArcGIS.AnalysisTools.Clip() { in_features = myPolygonFilePath, clip_features = this.ExtentFilePath, out_feature_class = myClipOutFilePath }; myGPEx.Execute(myClip); //新增欄位 pProcessInfo.SetProcess(20, "Add Field..."); var myAddField = new AddField { in_table = myClipOutFilePath, field_name = "Value", field_type = "DOUBLE" }; myGPEx.ExecuteByGP(myAddField); //複製結果資料 ShapeFileHelper.Copy(myClipOutFilePath, this.ResultPolygonFilePath); //讀取面資訊 pProcessInfo.SetProcess(30, "Init ContourPolygon ..."); this.LoadContourPolygonList(); //分析面與面之間的臨近關係 pProcessInfo.SetProcess(40, "Polygon Neighbors ..."); this.LoadContourPolygonRels(); //讀取等值線的值列表 pProcessInfo.SetProcess(50, "Read Line Value ..."); this.LoadContourPolylineList(); //面與線 臨近分析 pProcessInfo.SetProcess(60, "Load Contour Polygon Line Rels ..."); this.LoadContourPolygonLineRels(); //計算等值面值,在此迴圈,主要是為了避免特殊情況,導致死迴圈 pProcessInfo.SetProcess(70, "Cal Contour Polygon Value..."); for (int i = 0; i < 100; i++) { int myUnCalCount = this.CalContourPolygonValue(); if (myUnCalCount == 0) { break; } } //把計算的值寫入該檔案中 pProcessInfo.SetProcess(90, "Write Value To Contour Polygon File..."); this.WritePolygonValueToFeatureClass(); //計算完成 pProcessInfo.SetProcess(100, "Contour Polygon Cal Complete..."); }
因為ProcessInfo是非常核心一個類,使用範圍非常廣泛,如果把這個定義好了,會讓系統非常清晰。這樣的話,每個需要暴露進度的函式,值需要定義一個ProcessInfo引數傳入進來即可,在函式內部進度從0開始,100結束,其他的都不需要關心了。
常用函式庫,我一般會定義到Framework程式集的Helper目錄下。如果是欄位相關的會定義成FieldHelper,空間參考相關的會定義成SpatialReferenceHepler。並且裡面大部分都是靜態函式,方便直接呼叫。
在這些裡面用的最多的就是FolderPathHelper、ShapeFileHelper、SpatialReferenceHepler以及FeatureClassHelper等。