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

CityEngineg规那么建模Esri中国信息技术 徐汝坤CityEngineg规那么建模-----规那么语法与常用函数常用函数常用函数的用法练习：利用常用函数创立自己的规那么规那么语法规那么语法和常用函数目录常用函数extrude(拉伸/挤出)：把地块变成一个建筑comp〔拆分组件/炸开〕：把模型从整体分成不同的局部color〔着色〕：给模型着色Split(分割/切片)：建筑分成不同的楼层常用的函数功能：挤出一个高度，使模型从面状变为体块概要：extrude(height)extrude(axisWorld,height)参数说明：height：拉伸的高度。默认沿模型的Y轴拉伸axisWorld：设定拉伸轴线，使用世界坐标系的轴作为拉伸轴线。其可选参数为：world.x/world.y/world.z。使对象的拉伸有共同的方向常用函数——extrude例如规那么：Lot-->extrude(10)CompModel常用函数——extrude功能：从模型中别离出满足一定条件的模型概要：comp(compSelector){selectoroperatoroperations|selectoroperatoroperations...}参数说明：compSelector(keyword)：要分割组件的类型。可选值｛f:面|e:边|v:点｝selector(keyword)front,back,left,right,top,bottom前后左右上下〔模型轴系〕，常用vertical〔垂直〕,horizontal〔水平〕,aslant〔有坡度的〕,nutantside除水平部件外的其它局部all所有的常用函数——compLot-->extrude(10)CompModelCompModel-->comp(f){side:ColorsSideFacade|top:ColorfTopFacade}常用函数——comp功能：给模型着色概要：color(s)Color(r,g,b)参数说明：s(string)：文本类型的颜色值(16进制)例如："#rrggbb"r,g,b(float,float,float)：浮点类型的颜色值，每个值的取值在0到1.0之间常用函数——colorLot-->extrude(10)CompModelCompModel-->comp(f){side:ColorsSideFacade|top:ColorfTopFacade}ColorsSideFacade-->color("#00ffff")SplitModelColorfTopFacade-->color(1,0,0)

TopFacade常用函数——color功能：沿一定方向切割模型概要：split(splitAxis){size1:operations1|size2:operations2|...|sizen-1:operationsn-1}split(splitAxis){size1:operations1|size2:operations2|...|sizen-1:operationsn-1}*参数说明：splitAxis：取值｛X|Y|Z｝，轴系为模型轴系sizen：分割的宽度常用函数——split例如规那么：SplitModel-->split(y){4:color("#aa33bb")GroundFloor.|{~3:Floor.}*}注：符号“*”代表重复执行，“~”代表一个近似值常用函数——split练习：简单规那么的编写练习：简单规那么的编写Lot-->extrude(10)

extrudeModel

extrudeModel-->comp(f){side:SplitModel|top:ColorfTopFacade}ColorfTopFacade-->color(0,0,1)

TopFacade.SplitModel-->split(y){4:color(0,1,0)GroundFloor.|3:color(1,1,0)MidFloor.|~1:color(1,0,0)TopFloor.}参考规那么规那么语法规那么文件：由规那么、属性、自定义函数以及注释等构成的集合。规那么语法规那么〔函数〕标准规那么带参规那么随机规那么条件规那么递归规那么属性自定认函数注释(comments)规那么语法形式：PredecessorShape-->Successor特点：与无参函数比较类似，其结果返回给模型标识例如规那么：Lot-->extrude(10)CompModel规那么---标准规那么形式：PredecessorShape(Parameters)-->Successor特点：与有参函数比较类似，根据需要传递改变后继模型外观的信息注意1：参数的类型可以是布尔型〔bool〕、浮点数值〔float〕和字符型〔string〕，也可以是表达式注意2：具有不同参数个数的带参规那么〔前缀一样〕比较类似于函数的重载，在CityEngine认为这样的规那么为不同的规那么规那么---带参规那么例如规那么：Lot-->color(1,0,0)Footprint(20)Footprint(height)-->extrude(height)Envelope.规那么---带参规那么形式：PredecessorShape-->percentage%:Successor1percentage%:Successor2...else:SuccessorN主要作用：用以随机生成不同外观的模型注意1：随机语句外不能出现任何语句注意2：必须以else结尾，else前面的percentage的和不得超过100规那么---随机规那么例如规那么：Lot-->60%:color(1,0,0)Footprint(20)30%:color(0,1,0)Footprint(30)else:color(0,0,1)Footprint(50)Footprint(height)-->extrude(height)Envelope.规那么---随机规那么形式：PredecessorShape-->casecondition1:Successor1casecondition2:Successor2...else:SuccessorN特点：与函数中的条件语句比较类似，条件规那么的关键字是case、else，根据不同的条件生成不同外观的模型注意：条件语句外不能出现任何语句规那么---条件规那么例如规那么Lot-->casegeometry.area<400:color(1,0,0)Footprint(20)casegeometry.area>1000:color(0,1,0)Footprint(30)else:color(0,0,1)Footprint(50)

Footprint(height)-->extrude(height)Envelope.规那么---条件规那么形式：PredecessorShape-->casecondition1:OperationsPredecessorShapecasecondition2:Successor2...else:SuccessorN特点：与函数中的循环语句比较类似，适用于满足一定条件时重复执行相同的操作规那么---递归规那么例如规那么Lot-->extrude(10)color(1,0,0)comp(f){side:SideFacade|top:Recursive}

Recursive-->casegeometry.area>100:X.s('0.8,'0.8,'1)extrude(3)center(xz)comp(f){side:SideFacade|top:Recursive}else:X.规那么---递归规那么属性是一组静态的全局变量，每个属性被初始化一个特定的值。attr〔变量〕：可在inspector面板里调整，与对象的属性字段做关联；当定义的属性名字与字段名一致时会自动关联〔值类型一致〕Const〔常量〕：参数值不能在inspector面板里调整，也不能在规那么中利用set函数调整其值。注意当没有关键字时，CityEngine会认为是自定义函数属性const

height=20

Lot-->

color(1,0,0) extrude(height)练习：属性的调整CityEngnie中的自定义函数与属性比较类似，前面无关键字。自定义函数可以被参数化、随机化和条件化。例如：attrFloor=0

height=caseFloor<2:5caseFloor<6:4+3.2*(Floor-1)else:3.8+3*(Floor-1)

Lot-->color(1,0,0)extrude(height)自定义函数目的：提高规那么的易读性三种形式：行注释、块注释和行内注释行注释：利用字符“//”或“#”注释一行。例如如下：//acomment#anothercomment块注释：利用“/*……*/”可以实现块注释。例如如下：/*block