CityEngine大楼与厂房规则库拆解：CGA参数化建模与避坑指南

简介这份资源是面向Cityengine用户的建筑规则库压缩包适合城市规划、建筑设计及三维建模从业者与学习者使用。Cityengine以规则驱动建模见长而本包聚焦大楼与厂房两类场景提供可直接调用或二次修改的规则模板帮助使用者绕开从零编写CGA规则的繁琐过程快速生成符合现实逻辑的工业与商业建筑群。包内共1257个文件以jpg、png贴图与obj、mtl模型数据为主辅以cga规则脚本、atx索引及gdb地理数据库文件整体约232.69MB覆盖几何形状、立面细节、空间布局与场地配套等维度。目前已有443人学习下载。借助其中的高度限制、形状模板、随机化参数与光照分析等预设规则读者能高效搭建多样且真实的三维城市场景并将GIS数据融入模型适用于规划展示、环境影响评估与房地产开发等实际项目。1. 拿到 Cityengine 大楼与厂房规则库先别急着双击如果你正在用 CityEngine 做城市设计或工业厂区规划大概率经历过这种场面地块红线导入进去了建筑体块却要一栋一栋手拉拉到后面自己都不知道哪栋是住宅哪栋是厂房。Cityengine 规则库这类资源解决的就是这个重复劳动的问题——把「大楼长什么样、厂房怎么排」写成 CGA 规则让软件按地块自动生成。这次拆的Cityengine大楼与厂房规则库.zip从文件名和内容看是一套面向建筑体块生成的规则集配套的.atx文件说明它同时携带了 CityEngine 工程里用到的属性类型、关系类型等元数据定义。它适合两类人一是刚接触 CityEngine、想看看成熟规则怎么写的规划专业学生二是手里有 GIS 地块数据、需要快速出体块方案却不想从零写 CGA 的从业者。但我要先泼一盆冷水规则库不是「导入就出效果」的魔法包它的价值取决于你对地块参数和规则入口的理解程度。2. 拆开压缩包规则文件、属性表与工程元数据各管什么2.1 从文件清单反推规则库的组织方式拿到一个规则库压缩包我习惯先看文件清单再动手。这次包里出现的文件大致分三类理解这三类文件的分工后面调规则才不会抓瞎。第一类是 CGA 规则文件通常以.cga结尾这是真正定义建筑形态的逻辑主体楼高、层数、立面分段、屋顶类型都在里面。第二类是 CityEngine 工程元数据也就是清单里那一串.atx文件比如CatItemTypesByName.atx、CatItemsByType.atx、CatRelTypesByName.atx。这些名字看着像天书其实它们是 CityEngine 用来管理工程内对象类型和对象关系的索引表——CatItemTypes管的是「有哪些类型的对象」CatRels管的是「对象之间是什么关系」。第三类是资源文件包括纹理贴图和材质定义决定建筑表面是玻璃幕墙还是彩钢瓦。文件类型典型文件名作用缺失后果CGA 规则大楼/厂房规则.cga定义体块生成逻辑无法生成模型属性类型表CatItemTypesByName.atx对象类型索引规则入口找不到属性关系类型表CatRelTypesByName.atx对象关系索引规则间引用断裂纹理材质贴图文件夹表面外观模型灰面无真实感这里要提醒一句.atx文件不是给你手动编辑的它们是 CityEngine 工程内部使用的二进制或结构化索引。你不需要打开它们但需要保证它们和.cga文件放在同一个工程目录结构下否则导入规则时会出现「属性未定义」的报错。2.2 规则库的入口参数高度、形状、立面、随机化规则库能不能用关键看它的入口参数是否暴露给你。一个设计良好的大楼与厂房规则通常会在 CGA 文件头部定义一组attr变量这些变量就是你在 CityEngine 里选中地块后能直接调的旋钮。常见做法是暴露这几类参数高度控制最大层数、层高、总高限制、形状模板矩形、L 形、U 形、回字形、立面细节窗墙比、阳台频率、装饰线脚开关、随机种子控制建筑群多样性。我一般会先打开 CGA 文件找到attr开头的行看看哪些参数是Range注解的——有注解的才能在 Inspector 面板里拖滑块没注解的只能改代码。// 典型的大楼规则入口参数定义 attr buildingHeight 30 // 建筑总高单位米 attr floorHeight 3.5 // 单层层高 attr maxFloors 20 // 最大层数限制 attr shapeType rectangle // 形状模板rectangle/L/U attr windowRatio 0.6 // 窗墙比 attr randomSeed 1 // 随机种子控制多样性这段代码的逻辑很直白buildingHeight和floorHeight共同决定层数maxFloors是规划法规的硬约束shapeType切换体块拓扑windowRatio影响立面纹理密度randomSeed保证同一套规则在不同地块上产生差异。参数说明里最容易被忽略的是randomSeed——如果你发现整个小区的楼长得一模一样先检查这个值是不是被固定成了同一个数。2.3 把规则库挂到地块上的完整操作链知道文件结构之后操作链其实不复杂但顺序不能错。我一般按下面这几步走每一步都有对应的检查点。第一步在 CityEngine 里新建或打开一个工程把规则库文件夹整体拷到工程目录下的rules文件夹里。注意是整个文件夹拷进去不要只拷.cga文件因为.atx和纹理资源需要保持相对路径。第二步导入你的地块数据。常见做法是用 File Import 导入 Shapefile 或 FileGDB确保地块有正确的投影坐标系。如果地块是地理坐标系经纬度CityEngine 会提示你转换这一步别跳过否则规则里的高度参数会失真。第三步选中地块图层在 Inspector 面板里找到 Rule File 一栏点击浏览按钮指向你拷进去的.cga文件。挂载成功后地块上会出现规则入口的箭头标记。第四步在 Inspector 面板里调整暴露出来的参数比如把buildingHeight从默认的 30 改成 60观察体块变化。如果参数面板是空的说明规则文件没有正确定义attr或者.atx索引没被识别回到 2.1 节检查文件完整性。第五步点击 Generate 按钮生成模型。生成后如果发现建筑朝向不对检查地块的起始边方向——CGA 规则通常以地块第一条边为正面朝向错了就在地块属性里调整startEdge索引。3. 大楼规则与厂房规则的参数差异别用同一套逻辑套两种建筑3.1 大楼规则的核心层数堆叠与立面分段大楼规则和厂房规则虽然都在同一个压缩包里但它们的生成逻辑差别很大。大楼的核心是垂直方向的层数堆叠规则通常按「体块 → 楼层切分 → 立面细分 → 屋顶」的顺序执行。我拆过的多数大楼规则里层数切分用的是split(y)操作把体块沿高度方向切成若干层每层再调用立面规则。// 大楼层数切分与立面调用 Lot -- extrude(buildingHeight) split(y) { ~floorHeight: Floor }* Floor -- split(x) { ~windowRatio: Facade | ~(1-windowRatio): Wall } Facade -- color(0.7, 0.75, 0.8) texture(facade_glass.jpg)这段代码里split(y) { ~floorHeight: Floor }*的星号表示重复切分直到体块用完~表示按比例切分。windowRatio控制窗户和墙面的横向比例值越大窗户越宽。参数调整时要注意floorHeight改小会让楼层变密但总高不变的情况下层数会增多立面纹理可能被拉伸变形这时候需要同步调整纹理的 UV 重复次数。3.2 厂房规则的核心大跨度空间与屋面结构厂房规则的重点不在层数而在屋面结构和跨度。工业厂房通常是大跨度单层建筑规则里会用roofHip或roofShed生成坡屋顶或锯齿形屋面同时用split(x)在长边方向切分出柱距。// 厂房大跨度屋面与柱距切分 Factory -- extrude(workshopHeight) split(x) { ~columnSpacing: Bay }* Bay -- split(z) { ~spanWidth: Span } Span -- roofShed(roofAngle, roofHeight) texture(roof_metal.jpg)columnSpacing是柱距常见值 6 米或 9 米spanWidth是跨度单跨厂房一般 18 到 30 米。roofShed生成的是锯齿形屋面适合有采光需求的厂房。如果你拿大楼规则去套厂房会得到一栋层数堆叠的「厂房楼」屋面逻辑完全不对——这是新手最容易翻车的地方。3.3 混合场景下如何让大楼和厂房共存实际项目里经常是厂区加办公楼的混合场景。这时候不要试图用一个规则文件搞定所有建筑正确做法是在地块属性里加一个buildingType字段用条件分支调用不同规则。// 按地块属性分流大楼与厂房规则 Lot -- case buildingType factory: Factory case buildingType office: OfficeTower else: ResidentialBlockbuildingType字段可以在导入地块时从 Shapefile 的属性表里带进来也可以在 CityEngine 里手动赋值。条件分支的写法让同一套规则库能覆盖多种建筑类型但要注意每个分支的入口参数名不能冲突否则 Inspector 面板会显示混乱。4. 避坑与排查规则库导入后不生成、生成错、生成慢怎么办4.1 导入后地块上没有反应现象规则文件挂载成功但点击 Generate 后地块没有任何变化或者只显示一个灰色体块。原因最常见的是.atx索引文件缺失或路径不对导致规则入口的属性类型无法解析。其次是地块本身没有闭合CGA 规则无法对非闭合多边形执行extrude。解决先检查规则文件夹是否完整拷贝特别是CatItemTypesByName.atx和CatItemsByType.atx这两个文件。然后选中地块在 Inspector 里查看 Geometry 是否显示为 Valid Polygon如果显示 Not Closed用 Vertex 工具把缺口补上。4.2 建筑高度全部一样随机化失效现象生成了一整片建筑但每栋楼的高度、层数、屋顶样式完全相同看起来像复制粘贴。原因randomSeed参数被固定成了同一个值或者规则里根本没有引入随机函数。有些规则库为了演示稳定性默认把随机种子写死。解决在 Inspector 面板里把randomSeed改成 0 或者用rand()函数替代固定值。如果规则里没有暴露这个参数打开 CGA 文件在高度赋值处加上buildingHeight rand(20, 60)这样的随机范围。4.3 纹理错位或拉伸变形现象建筑立面的窗户纹理被拉长成条状或者屋顶纹理方向不对。原因纹理的 UV 映射没有跟随体块尺寸自适应。CGA 里texture()默认按体块的实际尺寸映射如果体块被拉伸而纹理没有设置重复次数就会变形。解决在texture()后面加上texture(facade.jpg, 2, 1)这样的参数前两个数字控制 U 和 V 方向的重复次数。更稳妥的做法是用setupProjection手动设置投影平面和重复参数。4.4 生成速度极慢或内存溢出现象地块数量上百之后Generate 过程卡死CityEngine 无响应。原因规则里用了递归调用或者过高的细分层级导致每个地块生成的几何面数爆炸。常见于立面细节规则里嵌套了多层split和comp。解决先降低细节层级把立面装饰的split次数从 3 层减到 1 层。然后在 CityEngine 的 Generate 设置里勾选 Level of Detail用低精度模式预览确认布局无误后再出高精度模型。如果地块特别多分批生成每次选 20 到 30 个地块。提示规则库里的.atx文件不要用文本编辑器打开修改它们是工程内部索引改坏了整个规则库都挂不上。5. 进阶技巧用规则库做参数化比选与合规校验规则库真正省时间的地方不是生成一版模型而是快速出多版比选方案。我一般会固定一套规则只改两三个关键参数批量生成不同高度的体块方案然后对比日照和容积率。具体做法是在 CityEngine 里用attr定义几组预设值比如heightScheme low / mid / high在规则里用条件分支切换高度范围生成三版模型后导出统计报表。另一个实用技巧是把规划法规写进规则做合规校验。比如当地规定住宅日照间距系数 1.2可以在规则里加一段判断如果建筑高度超过某个值自动在体块南侧留出对应间距的空地。这样生成的模型天然满足日照要求不用后期再手动调。// 按高度自动留出日照间距 Lot -- extrude(buildingHeight) case buildingHeight 30: split(z) { ~(buildingHeight * 1.2): setback | ~1: Building } else: Building这段代码的逻辑是当建筑高度超过 30 米时在地块进深方向切出buildingHeight * 1.2的退让带剩余部分才放建筑。setback区域可以设为空地或绿化。参数1.2就是日照间距系数不同城市不同气候区取值不同改这个数就能适配当地规范。验证方法上我习惯把生成后的模型导出为.obj或.fbx丢进 GIS 软件里叠合地形和周边建筑检查是否有穿插或悬空。CityEngine 自带的 Dashboard 也能看建筑面积和容积率统计但它的计算基于体块外轮廓阳台和飘窗不算进去和实际报建面积有出入心里要有数。从那以后我每次拿到新的规则库都强制先跑一遍最小地块测试——就选一个矩形地块挂上规则生成看参数面板能不能调、纹理有没有丢、高度是不是按预期变化。这一步花不了五分钟但能省掉后面几小时的排查。希望帮到你。本文还有配套的精品资源点击获取