Revit API

Revit API 允許使用任何與 .NET 相容的程式語言撰寫程式，本研究使用 C#。

需要實作兩個專案：(1) 增益集應用程式、(2) 功能區 (Ribbon) 面板 (Panel) 控制項。

以下依序說明實作概要。

1. 增益集應用程式

此步驟使用 Visual Studio 創建類型為類別庫的專案。此專案中必須實作 的功能包含面使用者操作以及與 WCF 建立存取通道獲得植栽清單功能。

使用者介面設計使用 Windows Form 實作，按照使用流程分為四頁籤，

以達成隨時可回到任一前步驟調整設計之需求，以下分別說明四頁籤之 實作方式。

• 綠化區域資訊

在開啟 BIM 模型之前，使用者應已先使用綠化區域類型之樓板元件 定義好綠化區域的位置與尺寸，本研究保留屋頂綠化以及植生牆的

圖 16：完成部署 WCF 服務

選項，但目前僅應用地面綠化。應用程式在開啟當下，須執行三件

由於無法獲得日照分析工具 Solar Analysis for Revit Plugin 的計算方 法或直接將它坎入應用程式中，因此採用文字描述顯示進行日照分

少配置相同植栽的重複動作，應用程式會將分類編碼相同的綠化區 域元件合併，意即面積相加，並將日照值依照各綠化區域元件之面 積大小進行加權平均。清單下方設置兩按鈕「不安排植栽」與「取 得推薦植栽」。介面右方用於顯示植栽資訊，包含分類按鈕、建議 品種 (名稱) 清單、主照片顯示區、滾動式照片預覽區、詳細資訊顯 示區 (文字)，以及選擇按鈕。

• CO2固定量估算

此頁籤為估算流程的最後一個步驟。應用程式於此頁籤僅執行一件 事：二氧化碳固定量估算，估算方式如式 5 與式 6 所示，然注意到 2006 IPCC 指南提供之估算結果為碳的固定量，而綠建築規範則是 使用 CO2的固定量，為方便比較，輔助程式最終將碳重量轉換為 CO2重量 (此轉換是合理的，參閱 2.2.1 節)。估算完成後以清單方式 顯示各綠化區域 CO2固定量以及總固定量。

2. 功能區面板控制項

此步驟用意為在 Revit 功能區添加面板控制項，讓使用者可直接透過這 個功能區面板控制項直接開啟增益集。首先，需要創建另一個類別庫專 案，與第一步驟的專案不同之處在於，其使用 IExternalApplication 介面，

其包含兩個抽象方法， OnStartup() 與 OnShutdown()，因此這個專案會在 Revit 啟動時自動被呼叫，程式內容主要包含新增面板控制項按鈕與呼叫 步驟一創建之執行檔。控制項按鈕上可新增圖標，由於此 API 用於估算 植栽 CO2固定量，因此圖標採用 CO2轉化為樹木的意像。做法是將 C、

O、2 三個字元拆開，2 成為樹幹的部分，O 成為數冠的細枝，C 成為茂 密的樹葉，如圖 17。建置好此應用程式後，再透過清單檔案註冊至 Revit 中，便完成功能區面板的控制項，如圖 18 所示。

圖 18：功能區面板之控制項 圖 17：估算輔助程式之圖標