简介面向CityEngine三维建模用户的一份森林景观程序化生成规则包适合城市环境设计、自然场景构建、规划评估等场景下的设计师与GIS开发者。压缩包共2000个文件以971个js脚本为主体配合obj模型、mtl材质、xml配置、png贴图、css样式及少量html、json等辅助文件另含大量留存的bak备份文件整体容量约193.71MB。规则覆盖植被类型定义针叶树、阔叶树、灌木等、随机化高度与冠幅、地形坡度适应性、季节色彩变化、光照阴影调节以及批量生成机制用户导入CityEngine后可直接使用也可通过图形界面拖拽参数实现快速调整无需深入编写程序化代码。包内文件结构清晰可作为规则语法参考与场景搭建模板。目前已有124人学习下载对希望提升程序化建模效率的进阶学习者有较好参考价值。1. 这份森林景观规则zip为什么说它是能“长”出树林的CityEngine工程包CityEngine做城市建筑模型很出名但真正折磨人的是自然景观一片几千棵的树林靠手工摆模型摆到下班也摆不完。我拿到这份Cityengine规则森林景观规则.zip时的第一反应是它和网上那些素材包不一样解压出来不是一堆OBJ模型而是围绕CGA规则写的工程文件还带一批.pydevproject.bak备份文件说明规则在开发阶段反复改过很多轮。这套规则解决的核心问题是让森林在CityEngine里按规则自动生长树该长在哪、长多高、密度多大、遇到坡地怎么避让都通过规则参数控制适合做城市规划视线分析、游戏场景地形原型或者单纯想研究CGA规则怎么写的人。2. 拆开规则工程.cga文件、Python项目与森林生成的底层逻辑拿到一个zip先别急着解压拖进CityEngine。CityEngine不识别压缩包它识别的是工程目录结构。这套压缩包和我见过的一些“规则合辑”不同它连.pydevproject都打包进来了这一点反而说明它的来源是正经开发工程而不是随手打包的散文件。2.1 为什么里面躺着Python项目文件CityEngine其实是个Eclipse壳CityEngine底层是Eclipse平台编辑器、项目树、调试器都在这套壳上。.pydevproject就是PyDev插件用来记录Python工程配置的文件里面写的是源码目录、Python解释器版本、PYTHONPATH这类信息。为什么森林规则工程里会需要Python因为CGA规则虽然能描述“哪里长什么树”但真要批量处理坐标点、批量遍历场景、把生成的几千棵树导出成FBX单靠CGA的写法会很吃力这时候就用CityEngine的Python脚本接口补一刀。这个包里出现的.pydevproject.bak1000、.bak1003、.bak1015这类编号是PyDev在用户每次保存时自动生成的备份文件。备份编号到1000以上说明这个规则工程经历过上千次有效保存规则和脚本都是迭代出来的不是一次性写好的雏形。如果你解压后要恢复工程直接以解压目录为工作区导入即可.pydevproject里记录的源码目录会被自动识别为Python脚本根目录。常见做法是把Python脚本放在工程根目录下的scripts或src文件夹里规则文件放在根目录或rules文件夹。导入时CityEngine的Project Explorer会按PyDev配置把脚本目录挂接好既能在规则属性里写Python脚本也能在控制台里跑自动化任务。如果你看到某个规则包解压后只有.cga没有.pydevproject那大概率只是给别人用的成品规则不是方便二次开发的完整工程。2.2 CGA规则的生成逻辑初始形状怎么“长”成一棵树森林规则的核心不是模型而是形状操作。CityEngine会把一个初始形状当作种子规则不断对形状做拆分、缩放、平移、旋转最后把终端形状替换成具体的3D模型。看一份简单的森林树规则代码骨架大概是这样StartRule Init -- s(20, 5, 20) center(xz) split(y) { ~0.6 : Trunk | ~4.2 : Crown } Trunk -- color(#5C4033) extrude(12) t(0, 12, 0) Crown -- color(#2E5A1E) s(rand(10, 16), rand(8, 14), rand(10, 16)) i(assets/pine.obj)这段代码的逻辑是先在xz平面上把初始形状缩放到20米×20米center(xz)把形状沿水平方向居中然后按y轴比例拆成树干和树冠两段。Trunk规则先把树干向上挤出12米再平移到树冠应该出现的高度Crown规则随机缩放树冠尺寸最后用i()把终端形状替换成外部模型文件。需要注意的参数是s()里的rand(10,16)它的作用是在10到16之间取随机值让每一棵树的树冠大小都不完全一样。如果去掉随机函数所有树长成一个模子看起来就像路灯队列而不是森林。split(y)里用了~而不是固定值意思是按比例分割而不是按绝对米数分割这样无论初始形状多高树冠和树干的比例都能保持稳定。2.3 随机化与地形匹配让森林避开“阅兵式”分布森林规则里最考功夫的部分是随机化和地形适应。CGA的随机函数不是瞎随机而是基于一个随机种子的确定性伪随机序列同一个种子跑出来的结构完全一致这在项目复现时很有用。经典的写法是给每棵树一个独立随机种子让高度、冠幅、倾斜角在合理范围内波动。再看一段处理地形坡度的规则Tree -- case terrain.slope 35 : NIL else : s(rand(2.5, 4), rand(10, 16), rand(2.5, 4)) r(0, rand(0, 360), 0) i(assets/oak.obj)当坡度超过35度规则直接返回NIL该处不生成树木坡度平缓的地方才放模型。r(0, rand(0,360), 0)让树木绕y轴随机旋转避免所有树木面向同一个方向。这样处理之后树木在阴坡和阳坡的分布密度肉眼能看出差别在山脊线上会稀疏在山谷里会密集基本符合自然植被的分布特征。这里要特别提醒CGA里terrain.slope取的是当前地形的真实坡度数值单位是度但它只能反映地形本身不能自动让树贴合地面。如果初始形状是浮空的树就会浮空。后面的避坑章节里我会专门说这个坑。3. 把森林规则跑起来导入、绑形与参数调优的完整链路这章写的是实战操作。我按一套完整的流程把规则包落地到场景里照着走可以少踩一半的坑。3.1 解压与导入路径是第一道坎先把zip解压这个操作没什么技术含量但路径很讲究。CityEngine对中文路径和目录带空格的容忍度很低解压到“D:\用户\张三\桌面\森林 规则”这种路径下规则里的纹理贴图和模型文件经常加载失败控制台报File not found但文件名看起来明明是对的。我一般会在D盘或C盘根目录建一个纯英文、无空格的目录比如C:\CityEngineProjects\ForestRules把解压出来的文件全部放到这个目录下。然后在CityEngine里执行File Import Existing Projects into Workspace选择这个目录作为导入根目录确认工程被识别出来。注意不要用Open File直接双击.cga那样只打开单个规则文件素材库和Python工程都不会挂载规则运行时缺文件是必然的。导入成功后在Project Explorer里应该能看到规则文件、assets目录和scripts目录。如果某个目录是空的或者.cga文件前面的图标带感叹号说明资源引用关系断了这时候要检查规则里引用的资产路径和实际路径是否一致。规则文件本身是纯文本可以先用文本编辑器打开看一眼前20行确认有没有类似i(assets/xxx.obj)的写法再去assets目录里核对文件名。我见过不少规则包文件名是pine_tree.obj规则里写的却是tree_pine.obj这种错误肉眼检查比等运行时报错更快。3.2 绑定初始形状并运行规则路径没问题之后进入生成环节。CityEngine的规则需要有一个初始形状作为入口比如矩形面、地块线或一条道路边线。对于森林规则最稳妥的初始形状是绘制一个足够大的Lot面或者直接用Terrain工具导入地形面。操作步骤是这样的先用Create Shapes工具在地形上画一个矩形或者选择已有地块然后在Inspector窗口里找到Rule File字段点击文件夹图标选择刚导入的.cga规则文件规则会自动匹配StartRule标注的规则作为入口如果工程里有多个StartRule需要手动指定入口规则名称。点击Assign把规则应用到形状后CityEngine会立即开始计算。这个过程是实时的规则里所有的split、extrude、i()替换都会在视口里逐步呈现。正常情况下几秒钟后就能看到矩形地块被规则切分成一堆树木模型的实例。如果规则一直没有输出按数字键7打开CGA控制台报错信息会直接显示在哪一步失败。最常见的问题是初始形状too small森林规则里的treeHeight默认10米以上如果初始形状画得太小split连一次分割都做不成规则直接静默退出。3.3 参数调整密度、树高、冠幅、随机种子导入成功后效果好不好全靠参数盘。森林规则包里一般会用attr定义一系列可调参数在Inspector里会以输入字段或滑块的形式显示。我按过手头多个城市景观项目的需求整理了一张常用参数对照表可以当参考。参数名作用建议范围备注density每平方米树木数量0.05 ~ 0.3越高越密也越卡treeHeight树干高度8 ~ 20影响空间感crownSize树冠直径3 ~ 10和树高保持比例更真实seed随机种子任意整数固定后结果可复现minSlope允许生树的最大坡度30 ~ 45超过就NILmaxTrees单地块树木上限1000 ~ 10000防止卡死调整参数的常见误操作是把density调大后森林密度还是没变化。这是因为规则里如果先做了一次split再放树density参数只管每个split块里的密度而split块的数量由形状长度决定。想提高整体密度要先看规则里split的步长把步长缩小而不是只调density。另一个容易忽略的是seed参数某些规则包把seed和每个形状的唯一编号绑定导致一个场景里每棵树都在用不同种子结果不可复现这个问题在下一章的坑里还会细说。4. CityEngine森林规则避坑记录五个真实翻车现场规则包能用和好用是两回事。这份包在干净环境下按常规流程跑基本不会出大问题但真要融入实际项目有几个坑我反复踩过写下来给同行当个参考。4.1 坑一规则导入后列表是空的现象把工程导入CityEngine左侧Project Explorer里能看到工程文件夹但.cga规则文件不显示或者双击打开只有空白内容。原因这个坑多半不是资源问题而是导入方式问题。CityEngine按工程导入时如果规则文件放在工程目录之外的Location里项目解析时不会把非工程文件索引进来。解决不要直接在文件系统里用拖拽方式打开.cga正确做法是先建一个空白工程再把规则文件所在的目录设置为工程内的规则资源目录或者直接用File Import File System把.cga文件物理复制进当前工程的根目录导入后等Project Explorer自动刷新一遍再操作。我习惯导入完之后随手做一次Clean操作强制CityEngine重建索引避免缓存类问题。4.2 坑二森林生成到一半停了报递归深度上限现象场景里树生成到一半CGA控制台报Maximum recursion depth reached前面的树只长了一半后面的全部消失。原因规则内部存在循环调用。比较典型的写法是树干rule里又调用了树干rule并且没有设置终止条件。森林场景里经常有人为了让树冠更茂密在Crown规则里又写了一个对Crown的引用每调用一次规则深度加一层跑到上限就被CityEngine限流了。解决检查.cga文件里有没有自循环调用常见做法是给循环加一个层数上限attr比如depth每次递归用depth-1传递进去当depth小于1时返回NIL。也可以用Hidden和Range注解限制参数范围。改了以后重新Assign规则多数情况立刻恢复。如果是别人写的规则包优先找有没有循环计数器类的参数不要自己硬改规则源码。4.3 坑三树看起来像是悬浮在半空现象地形起伏较大的区域树长在坡面上但根部悬空或者树干陷进土里场景一眼看过去很假。原因地形匹配逻辑缺失。CGA里如果形状是凭空生成的默认y坐标是0不会自动贴合地形表面再加上有些规则包为了视觉效果好把模型底部抬高了偏移量坡度一变就露馅。解决在放树之前用terrain.height获取该点真实高程用t(0, terrain.height, 0)把形状落到地面上如果还是悬空用terrain.getNormal或IncludeTerrain之类的指令把形状贴合坡度。更稳妥的做法是先在平面上把树都生成好最后用CityEngine的Terrain工具把整体模型包到地面上这是我处理这种地形问题时最后的兜底方式——规则里写干净逻辑地形贴合交给地形引擎去算。4.4 坑四同一套规则两个结果随机对不上账现象昨天生成的森林和今天生成的不一样工程文件没改过但每次Assign出来的树木分布完全不同。原因seed没有固化。CGA的rand()基于随机种子但很多规则包没有把seed暴露成attr参数直接用系统默认种子。每次Assign时CityEngine会为形状分配新的种子结果自然对不上账。解决在规则顶部声明一个attr seed 0并让所有随机函数基于这个seed的派生序列计算。最省事的是在Inspector里找到Seed参数手动设置一个固定值并勾选Lock然后再Assign一次。这样无论跑多少遍结果都是一致的。BIM或规划项目里要对结果签字评审这一步不做等于给自己埋雷。4.5 坑五模型引用路径断掉树木缩成一团现象森林里偶尔出现几棵紫色的、或者缩放到接近0的树控制台报asset not found。原因i()引用的模型文件路径写错了常见是大小写不对、路径带空格或者引用了只在原始电脑上存在的绝对路径。CityEngine把找不到的资源按空模型处理形状直接塌缩。解决打开.cga文件搜索所有i(路径)调用逐一和assets目录比对。注意文件名大小写Windows下大小写不敏感但打包给其他平台用时大小写写错是稳定复现的坑。把这些引用统一改成相对路径并保证实际文件名完全一致。全部改完后再Assign紫色缩团现象就会消失。提示在把规则工程分发给别人之前先做一次“结构固化”保证Scenes、Assets、Rules这三个核心目录始终在同一层所有引用都用相对路径能避开一大半引用问题。5. 进阶让森林规则输出工程可用模型的做法规则在CityEngine里跑得再花最终还是要导出给外部渲染器或游戏引擎用。我分享一下我用Python脚本批量把森林规则生成结果导出成FBX的家常做法这个流程适合几十个地块的大场景。5.1 批量导出FBX的Python脚本CityEngine的Python接口里核心操作是先拿到场景里所有应用了规则的形状再对每个形状做导出。一个简化但能用的脚本是这样from scripting import * export_dir C:/CityEngineProjects/ForestRules/Export/ ce CE() shapes ce.getObjectsFrom(ce.scene, ce.isShape) for shp in shapes: if shp.getRule() ForestRule: ce.export(shp, export_dir shp.getName() .fbx)脚本先取到场景里所有Shape对象过滤掉规则名不是ForestRule的然后逐个导出FBX。注意两点export_dir末尾的斜杠必须写否则会拼成错误的文件路径getName()得到的名字如果有空格或中文建议先用replace把不合规字符去掉否则导入游戏引擎时可能出问题。实际项目里我不会直接导出原始结果而是先在CityEngine里做两步预处理第一步把规则生成的所有模型转换为静态模型也就是把树木实例“烘焙”成真正的几何体避免导出后丢实例第二步重新计算一下面朝向和碰撞再走导出。这样到Maya或UE里就不用二次修复了。5.2 效果验证密度、分布与随机性导出前最好在CityEngine里就把效果校准好。我看森林景观是否合格有三个习惯指标第一个是单位面积树木数量用density参数反推10米×10米的及格范围是0.05到0.3棵每平方米第二个是坡向分布打开坡度分析图层看阴坡和阳坡的树木数量比例是否介于1比1.2到1比1.8过于均匀说明地形匹配没有生效第三个是视觉随机性建几个采样框对比相邻区域的树高极差如果极差不足两米说明随机参数范围设得太窄。我每次跑完森林规则都会把seed锁定然后导出一张正交俯视图存起来下次调整参数时和基准图做对比。从那以后我每次调整随机参数都强制走一遍“锁定种子、截图、调整、再截图”的流程避免调参把好不容易调好的分布冲掉。这个习惯救了我很多次宁可多花两分钟也别把已经跑通的规则再推翻重来希望帮到你。本文还有配套的精品资源点击获取
简介面向CityEngine三维建模用户的一份森林景观程序化生成规则包适合城市环境设计、自然场景构建、规划评估等场景下的设计师与GIS开发者。压缩包共2000个文件以971个js脚本为主体配合obj模型、mtl材质、xml配置、png贴图、css样式及少量html、json等辅助文件另含大量留存的bak备份文件整体容量约193.71MB。规则覆盖植被类型定义针叶树、阔叶树、灌木等、随机化高度与冠幅、地形坡度适应性、季节色彩变化、光照阴影调节以及批量生成机制用户导入CityEngine后可直接使用也可通过图形界面拖拽参数实现快速调整无需深入编写程序化代码。包内文件结构清晰可作为规则语法参考与场景搭建模板。目前已有124人学习下载对希望提升程序化建模效率的进阶学习者有较好参考价值。1. 这份森林景观规则zip为什么说它是能“长”出树林的CityEngine工程包CityEngine做城市建筑模型很出名但真正折磨人的是自然景观一片几千棵的树林靠手工摆模型摆到下班也摆不完。我拿到这份Cityengine规则森林景观规则.zip时的第一反应是它和网上那些素材包不一样解压出来不是一堆OBJ模型而是围绕CGA规则写的工程文件还带一批.pydevproject.bak备份文件说明规则在开发阶段反复改过很多轮。这套规则解决的核心问题是让森林在CityEngine里按规则自动生长树该长在哪、长多高、密度多大、遇到坡地怎么避让都通过规则参数控制适合做城市规划视线分析、游戏场景地形原型或者单纯想研究CGA规则怎么写的人。2. 拆开规则工程.cga文件、Python项目与森林生成的底层逻辑拿到一个zip先别急着解压拖进CityEngine。CityEngine不识别压缩包它识别的是工程目录结构。这套压缩包和我见过的一些“规则合辑”不同它连.pydevproject都打包进来了这一点反而说明它的来源是正经开发工程而不是随手打包的散文件。2.1 为什么里面躺着Python项目文件CityEngine其实是个Eclipse壳CityEngine底层是Eclipse平台编辑器、项目树、调试器都在这套壳上。.pydevproject就是PyDev插件用来记录Python工程配置的文件里面写的是源码目录、Python解释器版本、PYTHONPATH这类信息。为什么森林规则工程里会需要Python因为CGA规则虽然能描述“哪里长什么树”但真要批量处理坐标点、批量遍历场景、把生成的几千棵树导出成FBX单靠CGA的写法会很吃力这时候就用CityEngine的Python脚本接口补一刀。这个包里出现的.pydevproject.bak1000、.bak1003、.bak1015这类编号是PyDev在用户每次保存时自动生成的备份文件。备份编号到1000以上说明这个规则工程经历过上千次有效保存规则和脚本都是迭代出来的不是一次性写好的雏形。如果你解压后要恢复工程直接以解压目录为工作区导入即可.pydevproject里记录的源码目录会被自动识别为Python脚本根目录。常见做法是把Python脚本放在工程根目录下的scripts或src文件夹里规则文件放在根目录或rules文件夹。导入时CityEngine的Project Explorer会按PyDev配置把脚本目录挂接好既能在规则属性里写Python脚本也能在控制台里跑自动化任务。如果你看到某个规则包解压后只有.cga没有.pydevproject那大概率只是给别人用的成品规则不是方便二次开发的完整工程。2.2 CGA规则的生成逻辑初始形状怎么“长”成一棵树森林规则的核心不是模型而是形状操作。CityEngine会把一个初始形状当作种子规则不断对形状做拆分、缩放、平移、旋转最后把终端形状替换成具体的3D模型。看一份简单的森林树规则代码骨架大概是这样StartRule Init -- s(20, 5, 20) center(xz) split(y) { ~0.6 : Trunk | ~4.2 : Crown } Trunk -- color(#5C4033) extrude(12) t(0, 12, 0) Crown -- color(#2E5A1E) s(rand(10, 16), rand(8, 14), rand(10, 16)) i(assets/pine.obj)这段代码的逻辑是先在xz平面上把初始形状缩放到20米×20米center(xz)把形状沿水平方向居中然后按y轴比例拆成树干和树冠两段。Trunk规则先把树干向上挤出12米再平移到树冠应该出现的高度Crown规则随机缩放树冠尺寸最后用i()把终端形状替换成外部模型文件。需要注意的参数是s()里的rand(10,16)它的作用是在10到16之间取随机值让每一棵树的树冠大小都不完全一样。如果去掉随机函数所有树长成一个模子看起来就像路灯队列而不是森林。split(y)里用了~而不是固定值意思是按比例分割而不是按绝对米数分割这样无论初始形状多高树冠和树干的比例都能保持稳定。2.3 随机化与地形匹配让森林避开“阅兵式”分布森林规则里最考功夫的部分是随机化和地形适应。CGA的随机函数不是瞎随机而是基于一个随机种子的确定性伪随机序列同一个种子跑出来的结构完全一致这在项目复现时很有用。经典的写法是给每棵树一个独立随机种子让高度、冠幅、倾斜角在合理范围内波动。再看一段处理地形坡度的规则Tree -- case terrain.slope 35 : NIL else : s(rand(2.5, 4), rand(10, 16), rand(2.5, 4)) r(0, rand(0, 360), 0) i(assets/oak.obj)当坡度超过35度规则直接返回NIL该处不生成树木坡度平缓的地方才放模型。r(0, rand(0,360), 0)让树木绕y轴随机旋转避免所有树木面向同一个方向。这样处理之后树木在阴坡和阳坡的分布密度肉眼能看出差别在山脊线上会稀疏在山谷里会密集基本符合自然植被的分布特征。这里要特别提醒CGA里terrain.slope取的是当前地形的真实坡度数值单位是度但它只能反映地形本身不能自动让树贴合地面。如果初始形状是浮空的树就会浮空。后面的避坑章节里我会专门说这个坑。3. 把森林规则跑起来导入、绑形与参数调优的完整链路这章写的是实战操作。我按一套完整的流程把规则包落地到场景里照着走可以少踩一半的坑。3.1 解压与导入路径是第一道坎先把zip解压这个操作没什么技术含量但路径很讲究。CityEngine对中文路径和目录带空格的容忍度很低解压到“D:\用户\张三\桌面\森林 规则”这种路径下规则里的纹理贴图和模型文件经常加载失败控制台报File not found但文件名看起来明明是对的。我一般会在D盘或C盘根目录建一个纯英文、无空格的目录比如C:\CityEngineProjects\ForestRules把解压出来的文件全部放到这个目录下。然后在CityEngine里执行File Import Existing Projects into Workspace选择这个目录作为导入根目录确认工程被识别出来。注意不要用Open File直接双击.cga那样只打开单个规则文件素材库和Python工程都不会挂载规则运行时缺文件是必然的。导入成功后在Project Explorer里应该能看到规则文件、assets目录和scripts目录。如果某个目录是空的或者.cga文件前面的图标带感叹号说明资源引用关系断了这时候要检查规则里引用的资产路径和实际路径是否一致。规则文件本身是纯文本可以先用文本编辑器打开看一眼前20行确认有没有类似i(assets/xxx.obj)的写法再去assets目录里核对文件名。我见过不少规则包文件名是pine_tree.obj规则里写的却是tree_pine.obj这种错误肉眼检查比等运行时报错更快。3.2 绑定初始形状并运行规则路径没问题之后进入生成环节。CityEngine的规则需要有一个初始形状作为入口比如矩形面、地块线或一条道路边线。对于森林规则最稳妥的初始形状是绘制一个足够大的Lot面或者直接用Terrain工具导入地形面。操作步骤是这样的先用Create Shapes工具在地形上画一个矩形或者选择已有地块然后在Inspector窗口里找到Rule File字段点击文件夹图标选择刚导入的.cga规则文件规则会自动匹配StartRule标注的规则作为入口如果工程里有多个StartRule需要手动指定入口规则名称。点击Assign把规则应用到形状后CityEngine会立即开始计算。这个过程是实时的规则里所有的split、extrude、i()替换都会在视口里逐步呈现。正常情况下几秒钟后就能看到矩形地块被规则切分成一堆树木模型的实例。如果规则一直没有输出按数字键7打开CGA控制台报错信息会直接显示在哪一步失败。最常见的问题是初始形状too small森林规则里的treeHeight默认10米以上如果初始形状画得太小split连一次分割都做不成规则直接静默退出。3.3 参数调整密度、树高、冠幅、随机种子导入成功后效果好不好全靠参数盘。森林规则包里一般会用attr定义一系列可调参数在Inspector里会以输入字段或滑块的形式显示。我按过手头多个城市景观项目的需求整理了一张常用参数对照表可以当参考。参数名作用建议范围备注density每平方米树木数量0.05 ~ 0.3越高越密也越卡treeHeight树干高度8 ~ 20影响空间感crownSize树冠直径3 ~ 10和树高保持比例更真实seed随机种子任意整数固定后结果可复现minSlope允许生树的最大坡度30 ~ 45超过就NILmaxTrees单地块树木上限1000 ~ 10000防止卡死调整参数的常见误操作是把density调大后森林密度还是没变化。这是因为规则里如果先做了一次split再放树density参数只管每个split块里的密度而split块的数量由形状长度决定。想提高整体密度要先看规则里split的步长把步长缩小而不是只调density。另一个容易忽略的是seed参数某些规则包把seed和每个形状的唯一编号绑定导致一个场景里每棵树都在用不同种子结果不可复现这个问题在下一章的坑里还会细说。4. CityEngine森林规则避坑记录五个真实翻车现场规则包能用和好用是两回事。这份包在干净环境下按常规流程跑基本不会出大问题但真要融入实际项目有几个坑我反复踩过写下来给同行当个参考。4.1 坑一规则导入后列表是空的现象把工程导入CityEngine左侧Project Explorer里能看到工程文件夹但.cga规则文件不显示或者双击打开只有空白内容。原因这个坑多半不是资源问题而是导入方式问题。CityEngine按工程导入时如果规则文件放在工程目录之外的Location里项目解析时不会把非工程文件索引进来。解决不要直接在文件系统里用拖拽方式打开.cga正确做法是先建一个空白工程再把规则文件所在的目录设置为工程内的规则资源目录或者直接用File Import File System把.cga文件物理复制进当前工程的根目录导入后等Project Explorer自动刷新一遍再操作。我习惯导入完之后随手做一次Clean操作强制CityEngine重建索引避免缓存类问题。4.2 坑二森林生成到一半停了报递归深度上限现象场景里树生成到一半CGA控制台报Maximum recursion depth reached前面的树只长了一半后面的全部消失。原因规则内部存在循环调用。比较典型的写法是树干rule里又调用了树干rule并且没有设置终止条件。森林场景里经常有人为了让树冠更茂密在Crown规则里又写了一个对Crown的引用每调用一次规则深度加一层跑到上限就被CityEngine限流了。解决检查.cga文件里有没有自循环调用常见做法是给循环加一个层数上限attr比如depth每次递归用depth-1传递进去当depth小于1时返回NIL。也可以用Hidden和Range注解限制参数范围。改了以后重新Assign规则多数情况立刻恢复。如果是别人写的规则包优先找有没有循环计数器类的参数不要自己硬改规则源码。4.3 坑三树看起来像是悬浮在半空现象地形起伏较大的区域树长在坡面上但根部悬空或者树干陷进土里场景一眼看过去很假。原因地形匹配逻辑缺失。CGA里如果形状是凭空生成的默认y坐标是0不会自动贴合地形表面再加上有些规则包为了视觉效果好把模型底部抬高了偏移量坡度一变就露馅。解决在放树之前用terrain.height获取该点真实高程用t(0, terrain.height, 0)把形状落到地面上如果还是悬空用terrain.getNormal或IncludeTerrain之类的指令把形状贴合坡度。更稳妥的做法是先在平面上把树都生成好最后用CityEngine的Terrain工具把整体模型包到地面上这是我处理这种地形问题时最后的兜底方式——规则里写干净逻辑地形贴合交给地形引擎去算。4.4 坑四同一套规则两个结果随机对不上账现象昨天生成的森林和今天生成的不一样工程文件没改过但每次Assign出来的树木分布完全不同。原因seed没有固化。CGA的rand()基于随机种子但很多规则包没有把seed暴露成attr参数直接用系统默认种子。每次Assign时CityEngine会为形状分配新的种子结果自然对不上账。解决在规则顶部声明一个attr seed 0并让所有随机函数基于这个seed的派生序列计算。最省事的是在Inspector里找到Seed参数手动设置一个固定值并勾选Lock然后再Assign一次。这样无论跑多少遍结果都是一致的。BIM或规划项目里要对结果签字评审这一步不做等于给自己埋雷。4.5 坑五模型引用路径断掉树木缩成一团现象森林里偶尔出现几棵紫色的、或者缩放到接近0的树控制台报asset not found。原因i()引用的模型文件路径写错了常见是大小写不对、路径带空格或者引用了只在原始电脑上存在的绝对路径。CityEngine把找不到的资源按空模型处理形状直接塌缩。解决打开.cga文件搜索所有i(路径)调用逐一和assets目录比对。注意文件名大小写Windows下大小写不敏感但打包给其他平台用时大小写写错是稳定复现的坑。把这些引用统一改成相对路径并保证实际文件名完全一致。全部改完后再Assign紫色缩团现象就会消失。提示在把规则工程分发给别人之前先做一次“结构固化”保证Scenes、Assets、Rules这三个核心目录始终在同一层所有引用都用相对路径能避开一大半引用问题。5. 进阶让森林规则输出工程可用模型的做法规则在CityEngine里跑得再花最终还是要导出给外部渲染器或游戏引擎用。我分享一下我用Python脚本批量把森林规则生成结果导出成FBX的家常做法这个流程适合几十个地块的大场景。5.1 批量导出FBX的Python脚本CityEngine的Python接口里核心操作是先拿到场景里所有应用了规则的形状再对每个形状做导出。一个简化但能用的脚本是这样from scripting import * export_dir C:/CityEngineProjects/ForestRules/Export/ ce CE() shapes ce.getObjectsFrom(ce.scene, ce.isShape) for shp in shapes: if shp.getRule() ForestRule: ce.export(shp, export_dir shp.getName() .fbx)脚本先取到场景里所有Shape对象过滤掉规则名不是ForestRule的然后逐个导出FBX。注意两点export_dir末尾的斜杠必须写否则会拼成错误的文件路径getName()得到的名字如果有空格或中文建议先用replace把不合规字符去掉否则导入游戏引擎时可能出问题。实际项目里我不会直接导出原始结果而是先在CityEngine里做两步预处理第一步把规则生成的所有模型转换为静态模型也就是把树木实例“烘焙”成真正的几何体避免导出后丢实例第二步重新计算一下面朝向和碰撞再走导出。这样到Maya或UE里就不用二次修复了。5.2 效果验证密度、分布与随机性导出前最好在CityEngine里就把效果校准好。我看森林景观是否合格有三个习惯指标第一个是单位面积树木数量用density参数反推10米×10米的及格范围是0.05到0.3棵每平方米第二个是坡向分布打开坡度分析图层看阴坡和阳坡的树木数量比例是否介于1比1.2到1比1.8过于均匀说明地形匹配没有生效第三个是视觉随机性建几个采样框对比相邻区域的树高极差如果极差不足两米说明随机参数范围设得太窄。我每次跑完森林规则都会把seed锁定然后导出一张正交俯视图存起来下次调整参数时和基准图做对比。从那以后我每次调整随机参数都强制走一遍“锁定种子、截图、调整、再截图”的流程避免调参把好不容易调好的分布冲掉。这个习惯救了我很多次宁可多花两分钟也别把已经跑通的规则再推翻重来希望帮到你。本文还有配套的精品资源点击获取
