CityEngine案例系列（Tutorial_13facade-wizard）

CityEngine 立面向导：从一张图片到一套可复用规则

如果你已经会用 CityEngine 做基础街区建模，但每次想给建筑立面做细节，都卡在手动编写 CGA 规则、或者对着复杂的立面结构无从下手，这门课就是来补这个缺口的。它聚焦于 facade wizard（立面向导）这一功能，解决的核心问题是：如何把一张普通的建筑立面图像，快速分割成门窗、墙线、楼层等可识别元素，并自动生成对应 CGA 规则，从而批量生成风格一致的建筑模型。

适合的基础是：已经熟悉 CityEngine 基本操作，知道什么是 CGA 规则、如何把规则应用到形状上，但还没系统用过图像驱动的建模流程。如果你连“形状、规则、参数”这些概念都还没摸清，建议先补一下基础入门内容，再回来看这个案例。这门课默认你已经能看懂规则文件的基本结构，不需要会手写复杂 CGA，但至少要能理解“split 分割”“贴图映射”这类常见操作。

建议先看哪几块：按“理解—导出—复用”的顺序来

不要一上来就急着看最后生成建筑模型的部分。先看第一段“wizard 介绍与图像分割”，重点理解向导是如何识别图像里的颜色区域、把立面切分成不同部件的。这一步决定了后面生成的规则是否准确。接着看第二段“通过 wizard 制作的模型保存为 cga”，这里会讲清楚向导生成的临时模型如何变成可编辑的规则文件——这是整个流程的关键转换点，你学完应该能明白：图像分割的结果不是终点，而是 CGA 规则的起点。最后再看第三段“通过引入 cga 生产新的规则文件制作建筑模型”，它演示的是如何把上一段得到的规则文件应用到其他建筑形状上，实现“一套规则，多栋楼”的复用效果。建议按这个顺序看，每看完一段就暂停，把操作步骤在软件里跟着做一遍。

学完能独立做什么，以及怎么配合练习

学完这套案例，你应该能独立完成这样一件事：拿到一张建筑立面照片，用 facade wizard 做图像分割，调整分割范围和识别参数，把生成的模型导出为 CGA 规则文件，再把这个规则文件套用到新建的形状上，生成与照片风格一致的新建筑。你还能根据实际需求微调规则里的楼层高度、窗户尺寸、墙面色块等参数，而不必从零写代码。也就是说，你具备了一条从“参考图像”到“可复用规则”的完整工作流。

练习时，不要只看视频。资料包里通常会有配套的示例图像和初始工程文件，你要做的是：先用自己的素材试一次向导分割，对比自动生成和手动微调后的模型差异；然后把保存的 CGA 文件打开，找到分割产生的 split 语句，试着修改其中一个数字，观察模型变化；最后换一张不同风格的立面图，重复整个流程，看规则能否迁移。如果中途遇到分割不准确的情况，回到第一段，重新理解颜色阈值和区域合并的作用。这套案例的练习重点不是“照着做一遍”，而是“做完后能解释每一步为什么这么走”。