Rhino.Inside®.Revit

在这一章我们将会讲解如何读取使用 Grasshopper 所建立的 Revit 图元的参数，如果想了解 Revit 中的参数是如何组织的，请浏览 Revit Elements:Parameters Guide

检查参数

如果你需要检查某一个图元的属性，你可以使用 Inspect Element 来查看

现在请按住 Shift 键+鼠标双击 Inspect Element 运算器，这样你可以查看所有和该元素相关的参数列表。

你可以从输出端连接一些查看运算器来查看相关的属性信息, 例如Panel，然后你可以按住 Ctrl 键 +鼠标双击 Inspect Element 运算器来恢复默认显示大小，输出端有连接其他运算器的端口会被继续保留

要检查现有参数的定义，请使用 Parameter Identity 运算器：

查找图元参数

要查找与一个图元相关的参数，请将图元与参数名称接入 Query Element Parameters 运算器来进行查询：

参数范围

参数可以被附加到图元类型或单个实例，将 Graphical Element 直接接入至 Inspect Element 运算器以检查两个实例参数，将
Element Type 运算器链接至 Inspect Element 运算器以获取类型参数，你会发现可用参数的差异。

查找内置参数

可以使用 Built-In Parameters 运算器来检索 Revit 内建参数，双击标题可以搜索部分参数名称：

读取参数值

如果你需要查询特定的参数值，建议你使用 Revit Parameters 面板中的 Parameter 运算器：

继续鼠标右键点击这个运算器，然后选择你需要查询的一些参数项

运算器输出端连接 Element Parameter 来查询这个值

也可以使用 Element Parameter 以指定参数名的方式来读取这个参数值

我们是以特定的语言来指定参数名称，因此如果利用不同语言版本的 Revit 打开这个 Grasshopper 脚本文件可能会出现中断错误

使用共享参数时还可以用 UUID的作为查询输入值

设置参数值

可以使用 Element Parameter 运算器来设置一个 Revit 图元的参数值，要注意有些参数值为只读而不可以被覆盖

注意 Element Parameter 运算器仅以一个参照方式引入 Revit 图元，因此当基于这个运算器的参数值被更新时，它会把所有引入的图元运算器参数进行更新，这个操作可能不同于常规的 Grasshopper 运算器。

创建参数

创建参数的运算器位于 Grasshopper > Parameter 面板下，可以利用它再 Revit 中建立新的参数，通常流程如下：

首先必须定义一个参数，
然后增加这个参数至文档，
对于项目参数，需要设置附加类别和组（可选），
然后进行图元、类型或是全局参数设置。

参数定义可以使用 Define Parameter c运算器来创建或是直接从一个共享参数文件读取。

一旦建立定义，可使用 Add Parameter+ v1.0 运算器将参数增加至项目，如果是参数范围是针对全局参数, 则使用 Global Parameter 运算器进行设置参数值，请在使用前设置项目参数的额外属性。

新增项目参数

相对一个基础参数而言项目参数会有很多额外的属性，项目参数属于某些类别，且起参数值也因图元不同而有所不同。

通过连接参数名至 Define Parameter 运算器就可以来创建一个新的参数，然后使用 Built-In Parameter Types 与 Built-In Parameter Groups 来设置参数类型与输入群组， Define Parameter 运算器将会建立一个新的参数定义，这个定义可以连接至 Add Parameter+ v1.0 运算器在 Revit 中创建参数，你也可以使用 Parameter Identity 来检查你所创建的参数。

当前 Revit API 并不支持直接创建项目参数，因此需要利用 Grasshopper 的共享项目参数来创建项目参数

下面是共享参数中的参数配置：

可以后续将其参数名连接至 Element Parameter 运算器来读取或设置其参数值，也可以使用 Inspect Element 运算器与 Parameter Identity 运算器来检查参数值：

共享参数文件

使用 Shared Parameters 运算器来读取共享参数文件，将会返回当前文件的路径、群组与参数定义等。这个文件仅仅包含定义内容，所以必须将参数添加至当前项目中才能后续设置参数值，使用 Add Parameter+ v1.0 来添加参数且使用 Element Parameter 来设置图元的参数值。