基于RevitAPI 建筑消防噴頭輔助建模軟件開發

張 慎 楊 浩

(1.中南建筑設計院股份有限公司，武漢 430071;2.武漢大學土木建筑工程學院，武漢 430072)

1 引言

Revit 是當今世界流行的協同工作軟件之一，它擁有強大的功能。然而，在實際工程設計階段，該軟件并不能完全滿足設計人員的需要。Revit 作為一款強大的建筑行業設計軟件，提供了非常強大和完整的三維建模能力，支持創建大型的復雜項目。同時為了滿足用戶的個體需要，提供了非常方便的二次開發功能，支持用戶根據自己的需要進行二次開發［1］。

在進行協同設計時，通常需要在某一區域內布置噴頭。然而，Revit2014 軟件本身并沒有批量布置消防噴頭的功能。在對建筑內進行消防噴頭的布置時，設計人員需要手工點擊噴頭位置，同時還需要參照規范計算噴頭的間距和個數，工作量大且出錯概率較大。因此開發了基于Revit2014 的建筑消防噴頭輔助建模軟件，減輕了設計人員的工作量，提高了工作效率。

2 Revit 二次開發相關知識

本文介紹的二次開發是基于Revit2014 版本，主要開發工具為Visual Studio2010、RevitAPI(Application Programming Interface)和Revit SDK。

2.1 開發平臺及語言

本文講述的二次開發最終創建的文件為外部插件，創建平臺為Visual Studio2010(簡稱VS)，基于的模板為類庫。開發語言為C#，并結合了Revit2014 提供的對外接口(Add -In Manager 2014)，實現在Revit2014 中自動布置噴頭的功能。

2.2 Revit API

Revit2014 二次開發參考文檔為RevitAPI.chm，里面包含了二次開發可以使用的一些命名空間，以及命名空間下的類和類中包含的函數和屬性。Revit SDK 是Autodesk 官方提供的包含完整客戶端API 庫、文檔及實例代碼的綜合文件庫［2，3］。

提取Revit2014 模型中的對象時利用了RevitAPI 中類之間的繼承關系［4］。常用類之間的繼承關系如圖1 所示。

2.3 二次開發主要步驟

采用Visual Studio2010，運用C#語言對Revit2014 進行二次開發的主要步驟:

(1)建立項目

啟動Visual Studio2010，新建一個VisualC#類庫項目，命名為RShower。Visual Studio2010自動生成Class1.cs 等文件，將Class1.cs 重命名為Sprinklers.cs。

(2)添加外部引用

在Visual Studio2010 菜單欄中點擊項目→添加引用，在彈出的“添加引用”對話框中，選“瀏覽”標簽，選中Revit2014 安裝文件根目錄下的RevitAPI.dll和RevitAPIUI.dll 文件，完成添加。繼續添加引用，在彈出的“添加引用”對話框中，選“.NET”標簽，找到System.Windows.Forms，完成添加。

(3)引用命名空間

在Sprinklers.cs 文件引用命名空間代碼區域添加using Autodesk.Revit.DB、using Autodesk.Revit.UI 等語句，調用Revit API 中相關命名空間。

(4)創建命令類

在創建的命名空間下為命令類加載屬性，選擇創建類的命令加載方式，主要包括選擇文件事物、更新、日志等的模式，Revit 在2014 版本中，文件事物模式和更新模式只能選擇手動模式，接著創建一個從IExternalCommand 派生的類。

(5)重載Execute()方法

在命令類中載用Execute()方法，并在方法中編碼實現一定的功能。

(6)生成dll。選擇菜單欄中生成→生成RShower(U)，并在Visual Studio2010 輸出窗口中找到生成dll 的位置。

(7)添加到Revit2014 菜單中

運行Revit2014，選擇菜單附加模塊→外部工具→Add-In Manager(Manual Mode)，在彈出的Add -In Manager 2014 對話框中選擇Load，找到生成RShower.dll 文件，添加。

(8)運行插件。

3 建筑消防噴頭布置輔助建模軟件開發

3.1 主要功能

軟件的主要功能是在Revit2014 中加入批量布置噴頭的功能，需要滿足以下要求:對于規則布置區域，可以框選所有布置區域，自動按照《自動噴水滅火系統設計規范》(GB50084)快速合理的布置噴頭;對于不規則區域，設計人員可以指定某一區域，插件自動讀取該區域的信息，滿足要求進行最優化布置;若設計人員指定布置的參數，按照設計人員指定的參數進行布置;軟件以外部插件的形式嵌入到Revit2014 軟件中，軟件界面友好，設計人員操作方便。

3.2 軟件的界面

安裝本軟件后，在Revit2014 的工具欄上會生成一個按鈕，如圖4 所示，單擊后啟動軟件。

軟件的主要工作界面如圖5 所示。

圖3 軟件的主要工作界面

由工作界面可以看出布置方式有兩種:已知行列和已知間距。用已知間距方法布置噴頭時，噴頭與墻最小距離、噴頭之間的最小間距、噴頭之間最大間距、噴頭距墻最大間距默認值均為規范中的規定，用戶也可以根據實際需要更改;用已知行列布置噴頭時，行數和列數均為用戶指定，可以根據情況選擇布置方式。噴頭類型中的類型為加載到項目中的所有噴頭類型，危險等級按規范取四種:輕危險級、中危險級Ⅰ、中危險級Ⅱ、嚴重危險級。噴頭與天花板的距離為布置的噴頭與該層天花板的距離。

圖4 軟件主要操作流程

3.3 操作流程及主要算法

軟件的操作比較方便，主要流程如圖2 所示。軟件首先會讀取用戶載入項目中的所有噴頭族文件，并獲取默認危險等級及相關參數顯示主界面。隨后根據用戶選擇的危險等級和噴頭類型，并結合用戶選擇的布置方式在房間內根據規范布置噴頭。用戶選擇布置區域的方式有兩種:房間布置和區域布置，對于標準化大空間布置區域，可以通過房間布置方法布置，主要操作為將區域定義為房間，框選所有標準化布置區域，軟件即可讀取布置區域布置;對于非不規則的布置區域，可以通過區域布置方法布置，主要操作為選取布置區域的四個角點，軟件即可選擇布置區域進行布置。若用戶勾選了預演保護半徑，則在布置完成后會在平面圖中顯示每個噴頭的噴水區域。

圖5 軟件算法的實現

軟件在布置噴頭時考慮了《自動噴水滅火系統設計規范》(GB50084)中的要求和施工及經濟性的要求［5］。規范中對噴頭之間的最大間距、最小間距，噴頭距端墻的最大距離、最小距離都有要求如表1 所示，施工要求又要求噴頭與邊墻的距離和噴頭之間的距離為模數。在滿足這些要求的同時，從經濟方面要求布置的噴頭數最少。

實現噴頭的布置的算法如圖3 所示。其中一個方向上噴頭個數最少取為布置區域在該方向邊長L除以D3 向上取整。驗證過程如下:

噴頭個數:N=L/D3(N 向上取整);

噴頭之間間距:L1=L/N(L1 向上取整并取50的倍數);

噴頭據端墻的距離:L2=［L -L1* (N -1)］/2(L2 向上取整并取50 的倍數);

易知L1≤D3，L2 ≤D1(滿足了小于最大值要求);

另，當L1≤D2 時，取L1=D2;當L2 ＜D0 時，該房間無法滿足規范要求，暫時不布置。至此，滿足了規范、施工、經濟所有要求。

表1 規范中對噴頭間距的要求

圖6 布置平面圖

3.4 程序中主要運用的函數

為實現批量布置消防噴頭的功能，運用Revit2014 二次開發的幫助文檔RevitAPI.chm 中的函數和類，編寫了實現一定功能的函數，程序主要用到的函數如表2 所示。

表2 程序中主要運用的函數

3.5 軟件應用

利用本軟件在某項目中布置噴頭，布置的平面如圖6 所示。

布置該示例區域的消防噴頭的過程如下:

(1)房間布置

用戶設置好安全等級和噴頭類型后，選擇程序中【房間布置】命令，框選所需布置的所有房間。布置完成后程序彈出界面顯示有兩個房間未布置，布置結果如圖7 所示。

(2)區域布置

在房間布置完成后，有兩個房間未布置，可看出那兩個房間不是標準區域，程序自動過濾非標準區域。將未布置的兩個區域分別分解為2 個矩形區域，選擇程序中【區域布置】命令，按照提示點選各矩形區域的四個角點，布置。運行4 次【區域布置】命令，布置結果如圖8(a)所示。

圖7 房間布置

圖8 布置完成結果

如圖8 布置完成的結果所示，圖8(a)中圈出區域為房間布置和區域布置共同布置的結果，并由圖8(b)標注結果與表1 中要求對比可知，利用軟件布置的噴頭間距滿足規范和施工中的要求，并根據噴頭間的距離采用的是滿足所有要求的最大值，可以判斷布置結果是經濟的。布置消防噴頭過程中，遇到管道等原因不能均勻布置時，可采用“房間布置+區域布置”的方法布置。

4 結語

Revit 作為主要的BIM 軟件之一，目前和將來在建筑行業都有重要的應用前景。Revit 具有良好的二次開發接口，用戶可以很方便的利用API 編寫程序，實現自己需要的功能。隨著Revit 二次開發技術的不斷發展，在Revit 中工作將會更加的方便，Revit 這款軟件將在BIM 中發揮越來越大的作用。

［1］何關培.BIM 和BIM 相關軟件［J］.土木建筑工程信息技術，2010，2(4):110-117.

［2］徐迪.基于Revit 的建筑結構輔助建模系統開發［J］.土木建筑工程信息技術，2012，4(3):70-77.

［3］李雄華.BIM 技術在給水排水工程設計中的應用研究［D］.廣州:華南理工大學，2009.

［4］徐劍.Revit 系統軟件二次開發研究［J］.鐵路技術創新，2014(5):39-41.

［5］中華人民共和國標準.自動噴水滅火系統設計規范(GB50084 — 2001)［S］.北京:中國建筑工業出版社，2010.