交通工程软件：CityEngine二次开发_（6）.CityEngine脚本语言（CGA）.docx

PAGE1

PAGE1

CityEngine脚本语言（CGA）

1.CGA语言概述

CityEngine脚本语言（CGA）是一种专门用于生成和操作三维城市模型的高级脚本语言。CGA语言的全称是CityEngineGrammarLanguage，它通过一系列规则和操作来定义如何从基本的几何形状生成复杂的三维建筑和城市环境。CGA语言的设计理念是让城市规划师和设计师能够以编程的方式快速创建和修改城市模型，从而提高工作效率和模型的灵活性。

1.1CGA的基本概念

在CGA语言中，几何模型的生成过程被分解为一系列规则，这些规则定义了如何从一个初始形状（通常是简单的几何体）逐步构建出最终的复杂模型。每个规则可以包含多个操作，这些操作可以是几何变换、属性设置、条件判断等。通过这些规则和操作的组合，CGA语言能够实现高度复杂的模型生成和修改。

1.2CGA的语法结构

CGA语言的基本语法结构包括以下几个部分：

规则（Rules）：定义了如何从一个初始形状生成最终模型。规则可以嵌套调用，形成复杂的生成逻辑。

操作（Operations）：在规则中使用的具体操作，如extrude、split、color等。

参数（Parameters）：用于控制规则和操作的行为。参数可以是固定的数值，也可以是变量。

属性（Attributes）：用于存储模型的属性信息，如高度、材质等。属性可以在规则中被读取和修改。

条件判断（Conditions）：用于根据不同的条件执行不同的操作。条件判断可以是简单的布尔表达式，也可以是复杂的逻辑组合。

1.3CGA的开发环境

CityEngine提供了一个集成了CGA语言编辑器的开发环境，用户可以直接在CityEngine中编写和调试CGA代码。此外，CityEngine还支持通过外部工具（如Eclipse、VisualStudioCode）编写CGA代码，然后导入到CityEngine中进行测试和运行。

2.CGA基本操作

2.1几何变换操作

几何变换操作是CGA语言中最基本的操作之一，用于改变几何形状的位置、大小和方向。常见的几何变换操作包括：

平移（Move）：将几何形状沿着指定的向量移动。

旋转（Rotate）：将几何形状绕指定的轴旋转。

缩放（Scale）：将几何形状沿指定的轴缩放。

2.1.1平移操作

平移操作使用move函数，参数为一个三维向量，表示在x、y、z轴上的移动距离。

Lot--

move(0,0,10)//将Lot沿z轴向上移动10单位

extrude(20)//沿z轴向上拉伸20单位

2.1.2旋转操作

旋转操作使用rotate函数，参数为一个三维向量，表示绕x、y、z轴的旋转角度。

Lot--

rotate(0,45,0)//绕y轴旋转45度

extrude(20)//沿z轴向上拉伸20单位

2.1.3缩放操作

缩放操作使用scale函数，参数为一个三维向量，表示在x、y、z轴上的缩放比例。

Lot--

scale(2,1,1)//在x轴方向上放大2倍

extrude(20)//沿z轴向上拉伸20单位

2.2拉伸操作

拉伸操作是CGA语言中非常重要的操作之一，用于将平面形状沿指定方向生成三维形状。拉伸操作使用extrude函数，参数为一个数值或表达式，表示拉伸的高度。

Lot--

extrude(20)//沿z轴向上拉伸20单位

2.3分割操作

分割操作用于将一个几何形状沿指定方向分割成多个部分。常见的分割操作包括split和cut。split操作可以沿指定的面或线分割几何形状，而cut操作则可以在几何形状上创建一个切割面。

2.3.1分割操作示例

Lot--

split(y){//沿y轴分割

0.5:BuildingA()//前半部分生成BuildingA

0.5:BuildingB()//后半部分生成BuildingB

}

BuildingA--

extrude(20)//沿z轴向上拉伸20单位

BuildingB--

extrude(20)//沿z轴向上拉伸20单位

2.4颜色和材质操作

颜色和材质操作用于设置几何形状的颜色和材质属性。常见的颜色和材质操作包括color和texture