11-CityEngine规则建模-常用函数和语法

1、Esri中国信息技术有限公司徐汝坤 -规则语法与常用函数l常用函数 常用函数的用法 练习：利用常用函数创建自己的规则l规则语法lextrude(拉伸/挤出)：把地块变成一个建筑lcomp（拆分组件/炸开）：把模型从整体分成不同的部分lcolor（着色）：给模型着色lSplit(分割/切片)：建筑分成不同的楼层l功能：挤出一个高度，使模型从面状变为体块l概要： extrude(height) extrude(axisWorld, height)l参数说明： height：拉伸的高度。默认沿模型的Y轴拉伸 axisWorld：设定拉伸轴线，使用世界坐标系的轴作为拉伸轴线。其可选参数为：world.

2、x/world.y/world.z。使对象的拉伸有共同的方向l示例规则：Lot-extrude(10)CompModell功能：从模型中分离出满足一定条件的模型l概要： comp(compSelector) selector operator operations | selector operator operations . l参数说明： compSelector(keyword)：要分割组件的类型。可选值f:面 | e:边 | v:点 selector (keyword) front, back, left, right, top, bottom 前后左右上下（模型轴系），常用 vert

3、ical（垂直）, horizontal（水平）, aslant（有坡度的）, nutant side 除水平部件外的其它部分 all 所有的lLot- extrude(10) CompModellCompModel- comp(f)side: ColorsSideFacade | top: ColorfTopFacadel功能：给模型着色l概要： color(s) Color(r,g,b)l参数说明： s (string)：文本类型的颜色值(16进制)例如：#rrggbb r,g,b (float,float,float)：浮点类型的颜色值，每个值的取值在0到1.0之间lLot- extru

4、de(10) CompModellCompModel- comp(f)side: ColorsSideFacade | top: ColorfTopFacadelColorsSideFacade- color(#00ffff) SplitModellColorfTopFacade- color(1,0,0) TopFacadel功能：沿一定方向切割模型l概要： split(splitAxis) size1 : operations1 | size2 : operations2 | . | sizen-1 : operationsn-1 split(splitAxis) size1 : oper

5、ations1 | size2 : operations2 | . | sizen-1 : operationsn-1 *l参数说明： splitAxis：取值X | Y| Z，轴系为模型轴系 sizen：分割的宽度l示例规则：lSplitModel- split(y)4:color(#aa33bb) GroundFloor. | 3:Floor.*l注：符号“ * ”代表重复执行，“ ”代表一个近似值lLot- extrude(10) extrudeModellextrudeModel- comp(f)side:SplitModel | top: ColorfTopFacade lColor

6、fTopFacade- color(0,0,1) TopFacade.lSplitModel- split(y)4:color(0,1,0) GroundFloor. | 3:color(1,1,0) MidFloor.| 1:color(1,0,0) TopFloor.l规则文件：由规则、属性、自定义函数以及注释等构成的集合。l规则（函数） 标准规则 带参规则 随机规则 条件规则 递归规则l属性l自定认函数l注释(comments)l形式： PredecessorShape - Successorl特点：与无参函数比较类似，其结果返回给模型标识l示例规则：lLot- extrude(10)

7、CompModell形式： PredecessorShape(Parameters) - Successorl特点：与有参函数比较类似，根据需要传递改变后继模型外观的信息l注意1：参数的类型可以是布尔型（bool）、浮点数值（float）和字符型（string），也可以是表达式l注意2：具有不同参数个数的带参规则（前缀一样）比较类似于函数的重载，在CityEngine认为这样的规则为不同的规则l示例规则：lLot - color(1,0,0) Footprint(20)lFootprint(height)- extrude(height) Envelope.l形式：lPredecessorSh

8、ape - percentage%: Successor1 percentage%: Successor2 . else: SuccessorNl主要作用：用以随机生成不同外观的模型l注意1：随机语句外不能出现任何语句l注意2：必须以else结尾，else前面的percentage的和不得超过100l示例规则：lLot - 60%:color(1,0,0) Footprint(20) 30%:color(0,1,0) Footprint(30) else:color(0,0,1) Footprint(50)lFootprint(height)- extrude(height) Envelope

9、.l形式：lPredecessorShape - case condition1: Successor1 case condition2: Successor2 . else: SuccessorNl特点：与函数中的条件语句比较类似，条件规则的关键字是case、else，根据不同的条件生成不同外观的模型l注意：条件语句外不能出现任何语句l示例规则lLot - case geometry.area1000:color(0,1,0) Footprint(30) else:color(0,0,1) Footprint(50) lFootprint(height)- extrude(height) E

10、nvelope.l形式：lPredecessorShape - case condition1: Operations PredecessorShape case condition2: Successor2 . else: SuccessorNl特点：与函数中的循环语句比较类似，适用于满足一定条件时重复执行相同的操作l示例规则lLot - extrude(10) color(1,0,0) comp(f)side:SideFacade | top:RecursivelRecursive- case geometry.area100: X. s(0.8,0.8,1) extrude(3)cent

11、er(xz)comp(f)side:SideFacade | top:Recursive else: X.l属性是一组静态的全局变量，每个属性被初始化一个特定的值。lattr（变量）：可在inspector面板里调整，与对象的属性字段做关联；当定义的属性名字与字段名一致时会自动关联（值类型一致）lConst（常量）：参数值不能在inspector面板里调整，也不能在规则中利用set函数调整其值。l注意当没有关键字时，CityEngine会认为是自定义函数lconst height=20l lLot -lcolor(1,0,0)lextrude(height)CityEngnie中的自定义函数与属性比较类似，前面无关键字。自定义函数可以被参数化、随机化和条件化。示例：lattr Floor=0 lheight= case Floor2:5 case Floor color(1,0,0) extrude(height)l目的：提高规则的易读性l三种形式：行注释、块注释和行内注释 行注释：利用字符“/”或“#”注释一行。示例如下： /acomment #anothercomment 块注释：利用“/*/”可以实现块注释。示例如下： /*blo