[營建知訊轉載] 提升BIM工具效能－Revit API中文操作指引手冊將問世 郭榮欽 (2015.04)

郭榮欽 國立臺灣大學 土木工程學系工程資訊模擬與管理研究中心執行長

​Revit API 穿針引線

​提升BIM工具效能 Revit API中文操作指引手冊將問世 郭榮欽 國立臺灣大學 土木工程學系工程資訊模擬與管理研究中心執行長 Revit API 穿針引線 BIM技術在我國的發展已經形成不可擋的氣勢，目前許多相關工具，確實帶給工程業界明顯的助益。但從國內外對BIM所界定的願景，及對其所期待的想法來看，顯然，現階段仍有相當大的成長空間，需要國內產官學界一起來努力。例如最常被提及的3D、4D、5D之間的應對關係，許多業界朋友以為目前的塑模工具都能輕易地解決，孰不知3D與4D，或3D與5D之間，要想達到預期的成果，許多必備的前置條件，以及後製手工之繁雜與耗力，都會遠超過原來的認知，然其涉及「圖」與「文」之間分分合合的複雜關係，非本文強調的重點；但是，以「圖」為核心，對模型元組件的幾何關係，及其附帶屬性的有效掌握，讓前述之「前置」與「後製」作業更為自動化，更為精準，更能高效地符合工程階段甚至營運階段，於運作流程中的各類需求，而這正是塑模工具如Autodesk Revit的 API所能發揮的功能角色。除此以外，整個BIM技術範疇，若以「文」為作業核心的主導角色，仍然隨時有可能需要以模型進行輔助時，此時，Revit API仍得扮演穿針引線的重要角色。 

由上述顯見，從塑模工具中產出的模型，要落實到工程階段或營運階段而與工程實務需求接軌，則原工具既有的功能是遠遠不足的，務必藉助許多客製化的設計與開發來彌補，這時，API的使用就非常重要了。國立臺灣大學土木工程學系工程資訊模擬與管理研究中心（以下簡稱BIM研究中心）在數年前(2012)開始，即因研究教學之需要，開始著手針對Autodesk公司出版之「Revit 2012 API Developer’s Guide」一書進行探討，並試圖解譯及實作各章範例，經數年之相關實務教學配合，以自建之模型實作所有範例(如圖一)，並整理成「Revit API中文操作指引手冊」，準備分享給國內土木建築產業界參考學習，本手冊試圖將Revit API指引手冊中所介紹的功能與方法，以中文淺白闡述，詳盡地介紹給國內有志進行相關研發者，幫讀者開闢一扇方便門，讓更多有此需求的工程先進，加入研發行列，盼能加速國內業界在BIM技術領域上，奠定深厚之基礎與長足之進步。至於其後在工程或營運等專業上的應用，因其領域既龐雜又廣泛，就有賴開發者高度的想像力與經驗去發揮了。 

圖一 將選取自習作模型中之元組件的ID值顯示出來

「Revit API中文操作指引手冊」雖是以Autodesk公司為Revit塑模平台所出版之「Revit 2012 API Developer’s Guide」一書作為藍本，但整本手冊的範例係延續BIM研究中心之「透過案例演練學習BIM-基礎篇」中所採用之六層樓(地下一樓)雙併住宅之模型作為程式練習實作案例。綜觀Autodesk Revit 從2012到2015的API開發指引官方文件，由於因應每年變動，已從正式編撰成書，改成以網路知識庫模式呈現，主體內容架構並無太大變動，僅就少數類別定義調整，其餘大致都延續2012版之卅章再加一附錄。因此，「Revit API中文操作指引手冊」雖以2012版為參考基礎(實際上，都曾以Revit 2015版及Visual Studio 2013版實作)，但對初學者而言，仍具高度參考價值。

本手冊共卅一章，分成六大主題，第一主題為「Revit API介紹」，包括第01、02兩章；第二主題為「基本主題」，從03章到09章，是了解Revit API堂奧與Revit軟體處理模型元件之原理的最重要基礎，值得精讀；第三主題為「元件主題」，包括10~19章，皆以Revit 模型元件為探討對象，第四主題為「進階主題」，包括20~27章，對客製化輔助工具之研發非常重要；第五主題為「特定產品」，亦即針對建築、結構、機電特定專業不同的API需求，分別在28~30章說明；第六主題「其他」，也就是「附錄」，雖為零星的參考資料，但內容闡述API開發技術的補強資料，例如輸出入介面的開發等，都是相當關鍵的參考文獻，所占篇幅也特別多。整個手冊近約七百頁，擬分冊裝訂，以利閱讀。 

在本手冊譯述過程中，許多中文常用術語，在資訊慣用語與Revit工具用語之間會有少數幾個重疊，為避免造成混淆而不易拿捏，編譯者皆以API的資訊技術面做優先考量。而讀者在練習Revit API程式寫作時，除了深入探討手冊中每章對於Revit 在API操作指引中所透露出的軟體底層架構，及其所提供之存取功能外，應該進一步從「API使用者介面指引」(附錄G)，去熟悉其使用者介面的寫作方法，才能滿足開發者擬撰寫一套方便使用的應用程式之基本要求。 

Revit軟體平台每年改版，其附屬API也不例外，新版API所支援的動態連結檔(.dll檔)也會隨Microsoft的NET Framework版本更新而持續跟進，例如，手冊內少數範例程式在2015版編譯時，已出現版本支援問題之警示訊息。但到目前（2015年4月）為止，所有範例在2014、2015版的Revit中皆能執行(如圖二)，未來BIM研究中心仍會持續以新版本測試，並做必要的調整與跟進。(附註：本手冊不擬出書，裝印成冊，數量有限，為非賣品，僅供教學講義參考。) 

圖二 創建和顯示任務對話框

(本篇刊載於營建知訊384期第56-59頁)