BIM软件：Graphisoft二次开发_（6）.属性与参数的自定义设置.docx

PAGE1

PAGE1

属性与参数的自定义设置

在BIM软件中，属性与参数的自定义设置是实现项目个性化需求的关键步骤。Graphisoft的ArchiCAD提供了丰富的API和扩展功能，使得开发人员可以灵活地定义和管理对象的属性与参数。本节将详细介绍如何在ArchiCAD中进行属性与参数的自定义设置，包括属性的创建、管理、绑定以及参数的动态更新等。

1.属性的创建

在ArchiCAD中，属性可以通过GDL（GeometricDescriptionLanguage）脚本进行定义。GDL是一种用于描述建筑对象几何形状、属性和行为的编程语言。通过GDL，可以为对象添加自定义属性，这些属性可以用于存储对象的特定信息，如材料、尺寸、颜色等。

1.1使用GDL脚本添加属性

在GDL脚本中，可以使用attribute命令来定义属性。以下是一个简单的例子，展示如何为一个墙体对象添加自定义属性：

!定义墙体对象的自定义属性

attributeCustomWallColorascolor

attributeCustomWallMaterialasstring

1.2属性的初始化

定义属性后，可以在对象的初始化脚本中设置属性的默认值。以下是一个例子，展示如何在初始化脚本中设置自定义属性的默认值：

!初始化墙体对象的自定义属性

setCustomWallColorto!设置默认颜色为红色

setCustomWallMaterialtoConcrete!设置默认材料为混凝土

1.3属性的读取与修改

在对象的其他脚本中，可以读取和修改这些自定义属性。以下是一个例子，展示如何在对象的主脚本中读取和修改这些属性：

!读取自定义属性

localcolorwallColor

localstringwallMaterial

getCustomWallColortowallColor

getCustomWallMaterialtowallMaterial

!输出属性值

print墙体颜色:,wallColor

print墙体材料:,wallMaterial

!修改自定义属性

setCustomWallColorto255!修改颜色为蓝色

setCustomWallMaterialtoBrick!修改材料为砖

1.4属性的动态更新

属性值可以在运行时动态更新。例如，可以通过用户界面（UI）来修改属性值，并在对象更新时反映这些变化。以下是一个例子，展示如何通过UI动态更新属性值：

!定义用户界面

dialog自定义墙体属性with

colorbox墙体颜色id1,wallColor

textbox墙体材料id2,wallMaterial

!处理用户输入

ondialogdo

!获取用户输入的颜色

getdialogvalue1towallColor

!设置自定义属性

setCustomWallColortowallColor

!获取用户输入的材料

getdialogvalue2towallMaterial

!设置自定义属性

setCustomWallMaterialtowallMaterial

!刷新对象显示

refreshobject

2.参数的管理

参数是用于控制对象行为和外观的变量。在ArchiCAD中，参数可以通过GDL脚本进行管理和绑定。通过参数，可以实现对象的动态变化，如长度、高度、厚度等。

2.1参数的定义

在GDL脚本中，可以使用parameter命令来定义参数。以下是一个简单的例子，展示如何为一个门对象定义参数：

!定义门对象的参数

parameterDoorWidthasrealwith0.8,0.6,1.2

parameterDoorHeightasrealwith2.1,2.0,2.5

parameterDoorMaterialasstringwithWood

2.2参数的初始化

定义参数后，可以在对象的初始化脚本中设置参数的默认值。以下是一个例子，展示如何在初始化脚本中设置参数的默认值：

!初始化门对象的参数

setDoorWidthto0.8

setDoorHeightto2.1

setDoorMaterialtoWood

2.3参数的读取与修改