规则文件编写基础
在城市仿真软件中，规则文件是定义城市和建筑生成逻辑的核心文件。通过编写规则文件，用户可以控制城市模型的生成过程，包括建筑的外观、位置、高度、材质等各个方面。本节将详细介绍规则文件的基本概念、语法结构以及如何编写简单的规则文件。
规则文件概述
规则文件通常以.cga为扩展名，使用 CGA（Computer Generated Architecture）语言编写。CGA 是一种基于规则的建模语言，专门用于生成复杂的建筑模型和城市景观。规则文件包含了一系列的生成规则，这些规则定义了如何从简单的几何形状逐步构建出复杂的建筑和城市模型。
规则文件的作用
生成建筑模型：通过定义建筑的基本形状和生成逻辑，规则文件可以自动生成符合特定风格的建筑。
控制城市布局：规则文件可以定义城市的街道布局、地块划分等，确保生成的城市模型符合现实世界的规划。
材质和纹理：规则文件可以指定建筑的材质和纹理，使得生成的模型更加真实和美观。
参数化设计：通过设置参数，规则文件可以灵活地生成不同规模和风格的城市模型。
规则文件的结构
一个典型的规则文件包含以下几个部分：
导入语句：用于导入所需的库文件和资源。
规则定义：定义生成模型的具体规则。
初始规则：指定模型生成的起点。
参数定义：定义生成模型所需的参数。
导入语句
导入语句用于引入外部的库文件和资源，使得规则文件可以使用这些资源中的函数和材质。导入语句通常位于规则文件的顶部。
常见的导入语句
import "lib://standard library"：导入标准库，包含常用的建模函数。import "res://my_library.cga"：导入自定义的库文件。import "res://materials/my_materials.txt"：导入材质文件。
示例
// 导入标准库 import "lib://standard library" // 导入自定义库文件 import "res://my_library.cga" // 导入材质文件 import "res://materials/my_materials.txt"规则定义
规则定义是规则文件的核心部分，用于指定如何生成建筑模型。每个规则定义包含一个规则名称和一系列的操作步骤。
规则语法
rule_name ::= shape -> { statement_list }rule_name：规则的名称，用于标识该规则。shape：规则应用的几何形状。statement_list：一系列的操作步骤，每一步定义如何对当前形状进行变换。
基本操作步骤
变形操作：如
extrude、scale、rotate等，用于改变几何形状的大小、位置和方向。分割操作：如
split、divide等，用于将几何形状分割成多个部分。赋材质操作：如
material，用于指定几何形状的材质。调用规则操作：如
rule_name，用于调用其他规则。
示例
假设我们要生成一个简单的立方体建筑模型，可以定义如下规则：
// 定义一个生成立方体的规则 CuboidBuilding = shape -> { // 向上拉伸50米，生成立方体 extrude(50) // 为立方体表面赋材质 material("my_materials.txt", "concrete") }初始规则
初始规则是规则文件的入口点，定义了模型生成的起点。初始规则通常包含一个简单的几何形状，如平面或多边形，通过调用其他规则逐步生成复杂的模型。
初始规则语法
initial_rule ::= shape -> { rule_call }shape：初始的几何形状。rule_call：调用的规则，用于生成模型。
示例
假设我们要生成一个简单的城市模型，可以定义如下初始规则：
// 导入标准库 import "lib://standard library" // 定义一个生成立方体的规则 CuboidBuilding = shape -> { // 向上拉伸50米，生成立方体 extrude(50) // 为立方体表面赋材质 material("my_materials.txt", "concrete") } // 定义初始规则 initial_rule ::= shape -> { // 调用CuboidBuilding规则生成建筑 CuboidBuilding() }参数定义
参数定义用于设置生成模型所需的参数，使得规则文件更加灵活。参数可以在规则文件中定义，也可以在外部文件中定义并在规则文件中引用。
参数定义语法
parameter ::= @param name default_valuename：参数的名称。default_value：参数的默认值。
示例
假设我们要生成一个高度可变的立方体建筑模型，可以定义如下参数：
// 导入标准库 import "lib://standard library" // 定义一个高度参数 @param buildingHeight 50 // 定义一个生成立方体的规则 CuboidBuilding = shape -> { // 向上拉伸buildingHeight米，生成立方体 extrude(buildingHeight) // 为立方体表面赋材质 material("my_materials.txt", "concrete") } // 定义初始规则 initial_rule ::= shape -> { // 调用CuboidBuilding规则生成建筑 CuboidBuilding() }在这个例子中，buildingHeight参数可以在运行时进行调整，从而生成不同高度的立方体建筑。
高级规则操作
除了基本的操作步骤，规则文件还支持一些高级操作，如条件判断、循环、分支等，使得生成模型的逻辑更加复杂和灵活。
条件判断
条件判断用于根据某些条件选择不同的生成路径。语法如下：
if (condition) { statement_list } else if (condition) { statement_list } else { statement_list }示例
假设我们要生成一个根据地块面积决定建筑高度的规则，可以定义如下：
// 导入标准库 import "lib://standard library" // 定义一个生成立方体的规则 CuboidBuilding = shape -> { // 获取地块面积 area = area() // 根据地块面积决定建筑高度 if (area > 1000) { extrude(100) } else if (area > 500) { extrude(75) } else { extrude(50) } // 为立方体表面赋材质 material("my_materials.txt", "concrete") } // 定义初始规则 initial_rule ::= shape -> { // 调用CuboidBuilding规则生成建筑 CuboidBuilding() }在这个例子中，根据地块面积的不同，建筑的高度也会有所不同。
循环操作
循环操作用于重复执行某些生成步骤。语法如下：
for (i = start; i < end; i = i + step) { statement_list }示例
假设我们要生成一个带有多个窗户的建筑模型，可以定义如下：
// 导入标准库 import "lib://standard library" // 定义一个生成带有窗户的规则 BuildingWithWindows = shape -> { // 向上拉伸50米，生成立方体 extrude(50) // 为立方体表面赋材质 material("my_materials.txt", "concrete") // 在立方体的正面生成窗户 split(y) { 10 : Window() 10 : Window() 10 : Window() 20 : {} } } // 定义生成窗户的规则 Window = shape -> { // 向内缩进1米 offset(-1) // 向外拉伸0.5米 extrude(0.5) // 为窗户表面赋材质 material("my_materials.txt", "glass") } // 定义初始规则 initial_rule ::= shape -> { // 调用BuildingWithWindows规则生成建筑 BuildingWithWindows() }在这个例子中，split(y)操作将立方体的正面分成多个部分，并在每个部分生成一个窗户。
分支操作
分支操作用于根据某些条件选择不同的生成路径。语法如下：
case (condition) { case_value1 : statement_list1 case_value2 : statement_list2 default : statement_list3 }示例
假设我们要生成一个根据建筑类型决定生成方式的规则，可以定义如下：
// 导入标准库 import "lib://standard library" // 定义一个生成住宅建筑的规则 ResidentialBuilding = shape -> { // 向上拉伸30米，生成住宅建筑 extrude(30) // 为住宅建筑表面赋材质 material("my_materials.txt", "brick") } // 定义一个生成商业建筑的规则 CommercialBuilding = shape -> { // 向上拉伸50米，生成商业建筑 extrude(50) // 为商业建筑表面赋材质 material("my_materials.txt", "glass") } // 定义一个生成不同类型的建筑的规则 Building = shape -> { // 获取建筑类型参数 @param buildingType "residential" // 根据建筑类型选择生成方式 case (buildingType) { "residential" : ResidentialBuilding() "commercial" : CommercialBuilding() default : ResidentialBuilding() } } // 定义初始规则 initial_rule ::= shape -> { // 调用Building规则生成建筑 Building() }在这个例子中，根据buildingType参数的不同，生成的建筑类型也会有所不同。
多规则组合
多规则组合可以使得生成模型的逻辑更加复杂和灵活。通过在一个规则中调用多个其他规则，可以实现多步骤的生成过程。
示例
假设我们要生成一个带有屋顶和窗户的建筑模型，可以定义如下：
// 导入标准库 import "lib://standard library" // 定义一个生成立方体的规则 CuboidBuilding = shape -> { // 向上拉伸50米，生成立方体 extrude(50) // 为立方体表面赋材质 material("my_materials.txt", "concrete") // 在立方体的正面生成窗户 split(y) { 10 : Window() 10 : Window() 10 : Window() 20 : {} } } // 定义生成窗户的规则 Window = shape -> { // 向内缩进1米 offset(-1) // 向外拉伸0.5米 extrude(0.5) // 为窗户表面赋材质 material("my_materials.txt", "glass") } // 定义生成屋顶的规则 Roof = shape -> { // 生成一个斜屋顶 roofHip(10, 5) // 为屋顶表面赋材质 material("my_materials.txt", "tile") } // 定义生成带有屋顶和窗户的建筑的规则 CompleteBuilding = shape -> { // 调用CuboidBuilding规则生成立方体建筑 CuboidBuilding() // 调用Roof规则生成屋顶 Roof() } // 定义初始规则 initial_rule ::= shape -> { // 调用CompleteBuilding规则生成建筑 CompleteBuilding() }在这个例子中，CompleteBuilding规则调用了CuboidBuilding和Roof规则，生成了一个带有窗户和屋顶的建筑模型。
规则文件的调试
调试规则文件是确保生成模型正确的重要步骤。城市仿真软件通常提供了一些调试工具，如日志输出、可视化调试等。
日志输出
日志输出用于在规则文件中输出调试信息，帮助用户了解生成过程中的状态。
log("调试信息")示例
假设我们在生成过程中需要输出地块面积和建筑高度，可以定义如下：
// 导入标准库 import "lib://standard library" // 定义一个生成立方体的规则 CuboidBuilding = shape -> { // 获取地块面积 area = area() // 输出地块面积 log("地块面积: " + area) // 向上拉伸50米，生成立方体 extrude(50) // 为立方体表面赋材质 material("my_materials.txt", "concrete") // 在立方体的正面生成窗户 split(y) { 10 : Window() 10 : Window() 10 : Window() 20 : {} } } // 定义生成窗户的规则 Window = shape -> { // 向内缩进1米 offset(-1) // 向外拉伸0.5米 extrude(0.5) // 为窗户表面赋材质 material("my_materials.txt", "glass") } // 定义生成屋顶的规则 Roof = shape -> { // 生成一个斜屋顶 roofHip(10, 5) // 为屋顶表面赋材质 material("my_materials.txt", "tile") } // 定义生成带有屋顶和窗户的建筑的规则 CompleteBuilding = shape -> { // 调用CuboidBuilding规则生成立方体建筑 CuboidBuilding() // 调用Roof规则生成屋顶 Roof() // 输出建筑高度 log("建筑高度: " + height()) } // 定义初始规则 initial_rule ::= shape -> { // 调用CompleteBuilding规则生成建筑 CompleteBuilding() }在这个例子中，使用log语句输出了地块面积和建筑高度，方便调试。
可视化调试
可视化调试用于在生成过程中查看模型的中间状态，帮助用户发现生成逻辑中的问题。
启用可视化调试：在规则文件中使用
show语句，可以在生成过程中显示当前的几何形状。查看中间状态：通过设置断点，可以在特定步骤查看模型的中间状态。
示例
假设我们在生成过程中需要查看立方体建筑的中间状态，可以定义如下：
// 导入标准库 import "lib://standard library" // 定义一个生成立方体的规则 CuboidBuilding = shape -> { // 向上拉伸50米，生成立方体 extrude(50) // 显示当前的几何形状 show() // 为立方体表面赋材质 material("my_materials.txt", "concrete") // 在立方体的正面生成窗户 split(y) { 10 : Window() 10 : Window() 10 : Window() 20 : {} } } // 定义生成窗户的规则 Window = shape -> { // 向内缩进1米 offset(-1) // 向外拉伸0.5米 extrude(0.5) // 为窗户表面赋材质 material("my_materials.txt", "glass") } // 定义生成屋顶的规则 Roof = shape -> { // 生成一个斜屋顶 roofHip(10, 5) // 为屋顶表面赋材质 material("my_materials.txt", "tile") } // 定义生成带有屋顶和窗户的建筑的规则 CompleteBuilding = shape -> { // 调用CuboidBuilding规则生成立方体建筑 CuboidBuilding() // 调用Roof规则生成屋顶 Roof() // 输出建筑高度 log("建筑高度: " + height()) } // 定义初始规则 initial_rule ::= shape -> { // 调用CompleteBuilding规则生成建筑 CompleteBuilding() }在这个例子中，使用show语句在生成立方体建筑后显示当前的几何形状，方便查看中间状态。
规则文件的优化
规则文件的优化可以提高生成模型的效率和质量。优化的方法包括减少重复代码、使用高效的操作步骤、合理设置参数等。
减少重复代码
通过定义通用的规则和函数，可以减少代码的重复，提高代码的可维护性。
示例
假设我们要生成多个不同高度的立方体建筑，可以定义一个通用的规则：
// 导入标准库 import "lib://standard library" // 定义一个生成立方体的通用规则 CuboidBuilding = shape -> { // 获取建筑高度参数 @param buildingHeight 50 // 向上拉伸buildingHeight米，生成立方体 extrude(buildingHeight) // 为立方体表面赋材质 material("my_materials.txt", "concrete") // 在立方体的正面生成窗户 split(y) { 10 : Window() 10 : Window() 10 : Window() 20 : {} } } // 定义生成窗户的规则 Window = shape -> { // 向内缩进1米 offset(-1) // 向外拉伸0.5米 extrude(0.5) // 为窗户表面赋材质 material("my_materials.txt", "glass") } // 定义生成屋顶的规则 Roof = shape -> { // 生成一个斜屋顶 roofHip(10, 5) // 为屋顶表面赋材质 material("my_materials.txt", "tile") } // 定义生成带有屋顶和窗户的建筑的规则 CompleteBuilding = shape -> { // 调用CuboidBuilding规则生成立方体建筑 CuboidBuilding() // 调用Roof规则生成屋顶 Roof() } // 定义初始规则 initial_rule ::= shape -> { // 调用CompleteBuilding规则生成建筑 CompleteBuilding() }
