CityEngine规则文件(.cga)实战指南用代码构建动态建筑立面的艺术当你第一次打开CityEngine的CGA规则文件时那种面对空白编辑器的茫然感我深有体会——就像站在乐高积木箱前却不知从哪块开始拼起。但别担心本文将带你用程序员和设计师的双重视角重新理解这些看似复杂的代码如何变成千变万化的建筑立面。我们不会枯燥地罗列语法而是通过一个可即时反馈的建筑立面生成器示例让你体验参数化建模的创作快感。1. 从积木思维理解CGA规则架构CGA规则的本质是将建筑设计分解为可复用的逻辑模块。想象你在用代码搭积木基座是第一块积木中间楼层是重复堆叠的相同积木块屋顶则是最后封顶的特殊积木。这种模块化思维是掌握CGA编程的关键突破点。1.1 规则文件的基本结构每个CGA规则文件都遵循特定的结构框架// 版本声明 version 2023.1 // 属性参数定义 attr buildingHeight 50 attr floorCount 5 // 起始规则定义 StartRule Lot -- extrude(buildingHeight) splitFloor(floorCount)关键组件解析version声明规则语法版本确保兼容性attr定义可调节的参数变量StartRule标记模型生成的入口规则--规则操作符读作转换为1.2 建筑元素的模块化拆分典型建筑立面可分解为元素模块功能描述对应代码逻辑基座建筑底部结构初始extrude操作主体楼层重复的中间层splitrepeat组合顶部处理屋顶或檐口条件判断特殊形状立面装饰窗户/阳台等面片细分纹理映射这种分块方式让复杂建筑的构建变得像拼装预制件一样直观。2. 核心操作符的创意应用CityEngine提供了一组功能强大的操作符掌握它们就像获得了不同形状的积木块。让我们通过具体案例看看如何组合使用这些积木。2.1 空间分割的艺术split操作split是创建立面层次的核心工具它允许我们在三维空间中进行精确切割// 垂直方向分割示例创建基座、主体和屋顶 Lot -- split(y){ 5: Base | { ~5: MainBody } | 3: Roof } // 水平方向分割示例创建建筑开间 MainBody -- split(x){ 2: Tower | 6: CentralSection | 2: Tower }实用技巧使用{ }定义相对比例分割~符号表示自适应剩余空间结合scope操作获取当前分割块的尺寸信息2.2 立体构建extrude与offset这两个操作符负责将2D轮廓转化为3D体量// 基础挤出 Base -- extrude(10) // 带偏移的复杂挤出 Tower -- offset(-0.5) extrude(30) offset(0.5)提示offset常用于创建退台或悬挑效果正值扩大面域负值收缩面域2.3 纹理映射的智能控制为不同建筑部位分配材质时set操作符提供了精细控制// 材质定义 materials brick brick_texture.tex glass glass_texture.tex // 材质应用 CentralSection -- setupProjection(0, scope.xy, 1, 1) set(material.brick) split(y){ 0.2: nil | { ~1: split(f){ 0.7: Window | 0.3: Wall } } | 0.1: nil } Window -- set(material.glass) color(#aaccff)3. 参数化设计的动态调节真正的设计魔力来自于将静态代码转化为可交互的参数。以下是实现动态控制的几种方式3.1 属性参数的灵活运用// 可调节参数定义 attr floorHeight 3.5 attr windowRatio 0.4 attr roofType flat // 可选: flat, gable, hip // 参数应用示例 MainBody -- split(y){ floorHeight: Floor }* Window -- split(f){ windowRatio: Glass | { ~1: Frame } }3.2 条件逻辑实现风格变化通过条件判断实现建筑风格的动态切换Roof -- case roofType gable: GableRoof case roofType hip: HipRoof else: FlatRoof GableRoof -- comp(f){ top: RoofFace | side: RoofEave } RoofFace -- roofGable(30)3.3 随机化设计元素引入随机性创造自然变化attr variationSeed 42 Lot -- srand(variationSeed) split(y){ 5: Base | { ~1: split(y){ rand(2.8,3.2): Floor }* } | 3: Roof } Floor -- split(f){ rand(0.3,0.5): Window | { ~1: Wall } }4. 高级技巧从单体到街区的设计升级当掌握了基础建筑生成后可以进一步探索街区尺度的设计方法。4.1 批量处理建筑群// 地块分组处理 District -- group(byStreet){ all: Block } Block -- group(adjacent){ all: BuildingCluster } BuildingCluster -- case lotArea 500: HighRiseGroup else: MidRiseGroup4.2 上下文感知设计让建筑根据周边环境自动调整attr setbackFront 5 attr setbackSide 3 Lot -- setback(setbackFront){ front: Footprint | else: nil } setback(setbackSide){ side: Footprint | else: nil } Footprint -- extrude(attr.height)4.3 性能优化策略处理大规模场景时的实用技巧LOD控制attr detailLevel 1 // 1-3 HighRiseGroup -- case detailLevel 1: SimpleVolume case detailLevel 2: BasicFacade else: DetailedFacade实例化重复元素Window -- primitiveCube() s(0.9,1,0.2) t(0,0,0.5) instance动态加载规则// 根据视距切换规则细节 LOD_Controller -- case distanceToCamera 50: HighDetailRule case distanceToCamera 200: MediumDetailRule else: LowDetailRule5. 工作流优化与调试技巧高效的工作流程能大幅提升创作效率以下是我在实际项目中总结的实用方法。5.1 实时预览调试CityEngine提供了强大的交互式调试功能标记调试法DebugStep -- color(#ff0000) // 用红色标记当前步骤 ... color(#00ff00) // 用绿色标记完成步骤控制台输出attr debugMode true Floor -- case debugMode: print(Floor height: scope.sy) ...5.2 模块化规则组织大型项目的代码组织建议/规则文件结构 rules/ ├── core.cga # 基础规则 ├── facade/ # 立面样式库 │ ├── modern.cga │ ├── classic.cga │ └── industrial.cga ├── roof/ # 屋顶库 └── assets/ # 材质资源使用import语句实现模块化import facade/modern.cga import roof/gable.cga StartRule Lot -- ModernFacade GableRoof5.3 版本控制集成虽然CGA是专有格式但仍可应用现代开发实践使用Git管理规则文件变更为重要参数添加注释说明// [参数说明] // 单位米 // 范围3.0-5.0 // 默认4.2 attr floorHeight 4.2采用语义化版本控制规则集// 规则版本 v1.2.3 // 主版本.次版本.修订号 version 1.2.36. 从规则到艺术设计思维转换技术只是工具真正的创意来自于如何运用这些工具。以下是提升设计表现力的关键思路。6.1 建筑语汇的数字转化将传统设计元素转化为参数设计元素参数化表达代码示例韵律感重复间隔split(x){2:Column层次感垂直分段split(y){1:Base虚实对比开窗率attr windowRatio0.4材质对比材质混合comp(f){front:Stone6.2 风格系统的建立定义可复用的风格系统// 现代风格参数组 attr style_modern { windowRatio 0.6, material_main concrete, roofType flat, color_palette [#ffffff,#cccccc,#666666] } // 古典风格参数组 attr style_classic { windowRatio 0.4, material_main brick, roofType gable, color_palette [#cc9966,#993333,#663300] }6.3 环境响应式设计让建筑自动适应不同环境条件// 根据地块朝向调整立面 attr sunDirection 180 // 南向 Facade -- case sunDirection 90 sunDirection 270: SouthFacade(glassRatio0.5) else: NorthFacade(glassRatio0.3) // 根据气候条件调整屋顶 attr climateZone temperate // 可选: tropical, arid, cold Roof -- case climateZone tropical: PitchedRoof(angle45) case climateZone arid: FlatRoof(parapet1) else: MediumPitchedRoof(angle30)7. 实战案例可变立面生成系统让我们将这些概念整合到一个完整的示例中创建一个可根据参数动态变化的建筑立面系统。7.1 完整规则框架version 2023.1 /* 全局参数控制 */ attr { // 尺寸控制 buildingWidth 30 buildingDepth 20 floorHeight 3.2 floorCount 8 // 立面样式 style modern // modern, classic, industrial windowPattern grid // grid, vertical, horizontal // 随机种子 designSeed 42 } /* 材质库 */ materials { concrete concrete_01.tex glass glass_blue.tex brick brick_red.tex metal metal_panel.tex } /* 主规则链 */ StartRule Building -- srand(designSeed) setupProjection(0, scope.xy, 1, 1) extrude(floorHeight*floorCount) split(y){ 1: Base | { ~1: split(y){ floorHeight: Floor }* } | 1: Top } /* 组件规则 */ Base -- case style modern: ModernBase case style classic: ClassicBase else: IndustrialBase Floor -- case style modern: ModernFloor case style classic: ClassicFloor else: IndustrialFloor Top -- case style modern: ModernTop case style classic: ClassicTop else: IndustrialTop /* 现代风格组件 */ ModernBase -- offset(-0.3) extrude(4) set(material.concrete) ModernFloor -- split(f){ 0.7: ModernWindow | 0.3: ModernWall } ModernWindow -- case windowPattern grid: GridWindow case windowPattern vertical: VerticalWindow else: HorizontalWindow GridWindow -- split(x){ { ~1: split(y){ 0.3: Mullion | 0.7: GlassPane } }* } /* 古典风格组件 */ ClassicBase -- extrude(3) set(material.brick) split(x){ 0.1: nil | { ~1: split(y){ 0.2: Plinth | 0.8: BaseWall } } | 0.1: nil } /* 工业风格组件 */ IndustrialBase -- extrude(5) set(material.metal) comp(f){ front: MetalPanel | side: ConcreteWall }7.2 参数联动控制创建参数之间的智能关联// 自动计算建筑总高度 attr totalHeight floorHeight * floorCount 5 // 基座和屋顶额外高度 // 根据建筑高度自动调整细分数 attr facadeDivision case totalHeight 30: 3 case totalHeight 60: 5 else: 7 // 窗口尺寸随楼层变化 attr windowSizeVariation true Floor -- case windowSizeVariation: attr currentFloor split.index attr windowHeight lerp(1.8, 2.2, currentFloor/floorCount) split(y){ windowHeight: Window | { ~1: Spandrel } } else: split(y){ 2: Window | { ~1: Spandrel } }7.3 导出与交互将参数化系统与外部工具集成// 导出元数据 attr exportMetadata { designID: B2024-rand(1000,9999), author: Designer Name, created: date() } // 生成报告 Report -- print(Design Summary:) print( - Style: style) print( - Floors: floorCount) print( - Total Height: totalHeightm) print( - Window Pattern: windowPattern)在实际项目中我发现最有价值的往往不是最复杂的规则而是那些能够清晰表达设计意图同时保持足够灵活性的简单规则组合。比如一个精心设计的split操作加上有节制的随机性常常能产生既统一又富有变化的效果。
CityEngine规则文件(.cga)保姆级解读：如何像搭积木一样，用代码‘拼’出千变万化的建筑立面？
CityEngine规则文件(.cga)实战指南用代码构建动态建筑立面的艺术当你第一次打开CityEngine的CGA规则文件时那种面对空白编辑器的茫然感我深有体会——就像站在乐高积木箱前却不知从哪块开始拼起。但别担心本文将带你用程序员和设计师的双重视角重新理解这些看似复杂的代码如何变成千变万化的建筑立面。我们不会枯燥地罗列语法而是通过一个可即时反馈的建筑立面生成器示例让你体验参数化建模的创作快感。1. 从积木思维理解CGA规则架构CGA规则的本质是将建筑设计分解为可复用的逻辑模块。想象你在用代码搭积木基座是第一块积木中间楼层是重复堆叠的相同积木块屋顶则是最后封顶的特殊积木。这种模块化思维是掌握CGA编程的关键突破点。1.1 规则文件的基本结构每个CGA规则文件都遵循特定的结构框架// 版本声明 version 2023.1 // 属性参数定义 attr buildingHeight 50 attr floorCount 5 // 起始规则定义 StartRule Lot -- extrude(buildingHeight) splitFloor(floorCount)关键组件解析version声明规则语法版本确保兼容性attr定义可调节的参数变量StartRule标记模型生成的入口规则--规则操作符读作转换为1.2 建筑元素的模块化拆分典型建筑立面可分解为元素模块功能描述对应代码逻辑基座建筑底部结构初始extrude操作主体楼层重复的中间层splitrepeat组合顶部处理屋顶或檐口条件判断特殊形状立面装饰窗户/阳台等面片细分纹理映射这种分块方式让复杂建筑的构建变得像拼装预制件一样直观。2. 核心操作符的创意应用CityEngine提供了一组功能强大的操作符掌握它们就像获得了不同形状的积木块。让我们通过具体案例看看如何组合使用这些积木。2.1 空间分割的艺术split操作split是创建立面层次的核心工具它允许我们在三维空间中进行精确切割// 垂直方向分割示例创建基座、主体和屋顶 Lot -- split(y){ 5: Base | { ~5: MainBody } | 3: Roof } // 水平方向分割示例创建建筑开间 MainBody -- split(x){ 2: Tower | 6: CentralSection | 2: Tower }实用技巧使用{ }定义相对比例分割~符号表示自适应剩余空间结合scope操作获取当前分割块的尺寸信息2.2 立体构建extrude与offset这两个操作符负责将2D轮廓转化为3D体量// 基础挤出 Base -- extrude(10) // 带偏移的复杂挤出 Tower -- offset(-0.5) extrude(30) offset(0.5)提示offset常用于创建退台或悬挑效果正值扩大面域负值收缩面域2.3 纹理映射的智能控制为不同建筑部位分配材质时set操作符提供了精细控制// 材质定义 materials brick brick_texture.tex glass glass_texture.tex // 材质应用 CentralSection -- setupProjection(0, scope.xy, 1, 1) set(material.brick) split(y){ 0.2: nil | { ~1: split(f){ 0.7: Window | 0.3: Wall } } | 0.1: nil } Window -- set(material.glass) color(#aaccff)3. 参数化设计的动态调节真正的设计魔力来自于将静态代码转化为可交互的参数。以下是实现动态控制的几种方式3.1 属性参数的灵活运用// 可调节参数定义 attr floorHeight 3.5 attr windowRatio 0.4 attr roofType flat // 可选: flat, gable, hip // 参数应用示例 MainBody -- split(y){ floorHeight: Floor }* Window -- split(f){ windowRatio: Glass | { ~1: Frame } }3.2 条件逻辑实现风格变化通过条件判断实现建筑风格的动态切换Roof -- case roofType gable: GableRoof case roofType hip: HipRoof else: FlatRoof GableRoof -- comp(f){ top: RoofFace | side: RoofEave } RoofFace -- roofGable(30)3.3 随机化设计元素引入随机性创造自然变化attr variationSeed 42 Lot -- srand(variationSeed) split(y){ 5: Base | { ~1: split(y){ rand(2.8,3.2): Floor }* } | 3: Roof } Floor -- split(f){ rand(0.3,0.5): Window | { ~1: Wall } }4. 高级技巧从单体到街区的设计升级当掌握了基础建筑生成后可以进一步探索街区尺度的设计方法。4.1 批量处理建筑群// 地块分组处理 District -- group(byStreet){ all: Block } Block -- group(adjacent){ all: BuildingCluster } BuildingCluster -- case lotArea 500: HighRiseGroup else: MidRiseGroup4.2 上下文感知设计让建筑根据周边环境自动调整attr setbackFront 5 attr setbackSide 3 Lot -- setback(setbackFront){ front: Footprint | else: nil } setback(setbackSide){ side: Footprint | else: nil } Footprint -- extrude(attr.height)4.3 性能优化策略处理大规模场景时的实用技巧LOD控制attr detailLevel 1 // 1-3 HighRiseGroup -- case detailLevel 1: SimpleVolume case detailLevel 2: BasicFacade else: DetailedFacade实例化重复元素Window -- primitiveCube() s(0.9,1,0.2) t(0,0,0.5) instance动态加载规则// 根据视距切换规则细节 LOD_Controller -- case distanceToCamera 50: HighDetailRule case distanceToCamera 200: MediumDetailRule else: LowDetailRule5. 工作流优化与调试技巧高效的工作流程能大幅提升创作效率以下是我在实际项目中总结的实用方法。5.1 实时预览调试CityEngine提供了强大的交互式调试功能标记调试法DebugStep -- color(#ff0000) // 用红色标记当前步骤 ... color(#00ff00) // 用绿色标记完成步骤控制台输出attr debugMode true Floor -- case debugMode: print(Floor height: scope.sy) ...5.2 模块化规则组织大型项目的代码组织建议/规则文件结构 rules/ ├── core.cga # 基础规则 ├── facade/ # 立面样式库 │ ├── modern.cga │ ├── classic.cga │ └── industrial.cga ├── roof/ # 屋顶库 └── assets/ # 材质资源使用import语句实现模块化import facade/modern.cga import roof/gable.cga StartRule Lot -- ModernFacade GableRoof5.3 版本控制集成虽然CGA是专有格式但仍可应用现代开发实践使用Git管理规则文件变更为重要参数添加注释说明// [参数说明] // 单位米 // 范围3.0-5.0 // 默认4.2 attr floorHeight 4.2采用语义化版本控制规则集// 规则版本 v1.2.3 // 主版本.次版本.修订号 version 1.2.36. 从规则到艺术设计思维转换技术只是工具真正的创意来自于如何运用这些工具。以下是提升设计表现力的关键思路。6.1 建筑语汇的数字转化将传统设计元素转化为参数设计元素参数化表达代码示例韵律感重复间隔split(x){2:Column层次感垂直分段split(y){1:Base虚实对比开窗率attr windowRatio0.4材质对比材质混合comp(f){front:Stone6.2 风格系统的建立定义可复用的风格系统// 现代风格参数组 attr style_modern { windowRatio 0.6, material_main concrete, roofType flat, color_palette [#ffffff,#cccccc,#666666] } // 古典风格参数组 attr style_classic { windowRatio 0.4, material_main brick, roofType gable, color_palette [#cc9966,#993333,#663300] }6.3 环境响应式设计让建筑自动适应不同环境条件// 根据地块朝向调整立面 attr sunDirection 180 // 南向 Facade -- case sunDirection 90 sunDirection 270: SouthFacade(glassRatio0.5) else: NorthFacade(glassRatio0.3) // 根据气候条件调整屋顶 attr climateZone temperate // 可选: tropical, arid, cold Roof -- case climateZone tropical: PitchedRoof(angle45) case climateZone arid: FlatRoof(parapet1) else: MediumPitchedRoof(angle30)7. 实战案例可变立面生成系统让我们将这些概念整合到一个完整的示例中创建一个可根据参数动态变化的建筑立面系统。7.1 完整规则框架version 2023.1 /* 全局参数控制 */ attr { // 尺寸控制 buildingWidth 30 buildingDepth 20 floorHeight 3.2 floorCount 8 // 立面样式 style modern // modern, classic, industrial windowPattern grid // grid, vertical, horizontal // 随机种子 designSeed 42 } /* 材质库 */ materials { concrete concrete_01.tex glass glass_blue.tex brick brick_red.tex metal metal_panel.tex } /* 主规则链 */ StartRule Building -- srand(designSeed) setupProjection(0, scope.xy, 1, 1) extrude(floorHeight*floorCount) split(y){ 1: Base | { ~1: split(y){ floorHeight: Floor }* } | 1: Top } /* 组件规则 */ Base -- case style modern: ModernBase case style classic: ClassicBase else: IndustrialBase Floor -- case style modern: ModernFloor case style classic: ClassicFloor else: IndustrialFloor Top -- case style modern: ModernTop case style classic: ClassicTop else: IndustrialTop /* 现代风格组件 */ ModernBase -- offset(-0.3) extrude(4) set(material.concrete) ModernFloor -- split(f){ 0.7: ModernWindow | 0.3: ModernWall } ModernWindow -- case windowPattern grid: GridWindow case windowPattern vertical: VerticalWindow else: HorizontalWindow GridWindow -- split(x){ { ~1: split(y){ 0.3: Mullion | 0.7: GlassPane } }* } /* 古典风格组件 */ ClassicBase -- extrude(3) set(material.brick) split(x){ 0.1: nil | { ~1: split(y){ 0.2: Plinth | 0.8: BaseWall } } | 0.1: nil } /* 工业风格组件 */ IndustrialBase -- extrude(5) set(material.metal) comp(f){ front: MetalPanel | side: ConcreteWall }7.2 参数联动控制创建参数之间的智能关联// 自动计算建筑总高度 attr totalHeight floorHeight * floorCount 5 // 基座和屋顶额外高度 // 根据建筑高度自动调整细分数 attr facadeDivision case totalHeight 30: 3 case totalHeight 60: 5 else: 7 // 窗口尺寸随楼层变化 attr windowSizeVariation true Floor -- case windowSizeVariation: attr currentFloor split.index attr windowHeight lerp(1.8, 2.2, currentFloor/floorCount) split(y){ windowHeight: Window | { ~1: Spandrel } } else: split(y){ 2: Window | { ~1: Spandrel } }7.3 导出与交互将参数化系统与外部工具集成// 导出元数据 attr exportMetadata { designID: B2024-rand(1000,9999), author: Designer Name, created: date() } // 生成报告 Report -- print(Design Summary:) print( - Style: style) print( - Floors: floorCount) print( - Total Height: totalHeightm) print( - Window Pattern: windowPattern)在实际项目中我发现最有价值的往往不是最复杂的规则而是那些能够清晰表达设计意图同时保持足够灵活性的简单规则组合。比如一个精心设计的split操作加上有节制的随机性常常能产生既统一又富有变化的效果。
