【零基础 Revit API 教学】 #Day2 - Revit API 常见工具及网页

常用的工具有哪些？

在开发外挂时，常用的 Revit 外挂有两个，一个是用来执行撰写好的程式的外挂 Add-In，另一个则是用来查看 Revit 物件资料结构的外挂 LookUp。

Add-In

Add-In 比较容易理解，网路上有许多免费的 Revit 外挂，可以供下载使用，有使用过的人应该就知道，下载完以后，工具列处会多出几个按钮，按下按钮以后就能够执行不同功能，这些按钮我们称为 Ribbon。然而，在外挂还未被包装成 Ribbon 前，就需要使用 Add-In 来执行我们撰写的程式（外挂）。至于如何将撰写好的程式包装成 Ribbon，之后会有一天做更详细的说明。

LookUp

LookUp 在撰写外挂中扮演非常重要的角色，有了它才能知道程式应该如何撰写。首先，要从 BIM (建筑资讯模型, Build Information Modeling) 开始说起，Revit 是 BIM 软体的其中一种，它与一般 3D 软体不同的地方在于，Revit 的 3D 模型还包含了物件导向的概念。

举例来说，一根柱在一般的软体中，就是一个长方体量体，可在 Revit 中，一根柱即是一个物件，它属于 “结构柱” 这个品类，类别中还有不同类型的柱，每个类型的柱都有其订定的尺寸、材料，而一个类型中又有许多柱物件，每根柱物件有各自的楼层、起始高度等参数，这样层层递进便是物件导向的概念。

当使用者点选某根柱物件，能够在一旁的性质栏位中，看见这根柱的的尺寸、长度、体积等这些参数。然而，这根柱除了包含使用者在性质栏位中看到的参数以外，背后其实还包含了更多资讯，例如组成这根柱的面、边、点等，这些 Revit 介面中无法查看的资讯，则能够透过 LookUp 这个外挂看见。除此之外，也能看到该物件所能呼叫的 API 函式，以及呼叫函式后，可以获得的资讯内容。

说明到这里，可能还是无法清楚了解 物件导向、Revit 的资料结构，以及 LookUP。别担心，之后会有ㄧ天做更详细的说明，再搭配实际使用，大家便能清楚了解，使用多了就会非常得心应手。

---

常用的网页有哪些？

常使用的网页则有 Revit API Docs、Revit API Forum、The Building Coder。事实上，LookUp 中只提及了少部分的函示，因此，才会需要 Revit API Docs 这个网页。里面包含了所有 Revit API 的函式说明，某些函式除了说明以外，也会有一小段的程式範例，让使用更清楚此函式如何使用。

然而，那些没有範例的函示，则可以在 Revit API Forum 这个网页中，找到相关範例。此网站是 Autodesk 所製作的论坛，有许多使用者会在上面提问，Autodesk 人员或路人大神会在下方解惑。而 The Building Coder 则是 Autodesk 专业的工程师，这位大神所发的文章包山包海，小至函式的使用範例，大至一整套功能等程式範例，而这些文章都在该网站中。

最最容易的方法，就是打开搜寻引擎，输入「Revit API」加上想知道的函示名称，或者想撰写的功能，例如「获取参数」，便能找到相关的教学网站。

https://www.revitapidocs.comhttps://forums.autodesk.com/t5/revit-api-forum/bd-p/160https://thebuildingcoder.typepad.com

---