CityEngine CGA 官方操作函数实现文档

创建四边形平面，默认适配当前 scope 的 x/z 尺寸。

// 创建一个 2x3 的平面
Lot --> primitiveQuad(2, 3) color("red")

创建圆盘（圆形平面），默认适配 scope 的 x/z 最大值的一半作为半径。

// 创建半径为 1.5 的圆盘
Lot --> primitiveDisk(1.5, 32)

创建圆锥体，默认适配当前 scope。

// 创建圆锥
Lot --> primitiveCone(1, 2, 16) color("blue")

创建四棱锥（金字塔），手动构建 5 个顶点（底面 4 点 + 顶点）和 6 个面。

// 创建金字塔
Lot --> primitivePyramid(2, 2, 1.5)

四坡屋顶。提取 footprint 边界，生成向内收缩的顶部平顶 + 斜面。

// 四坡屋顶
Lot --> extrude(2) roofHip(1)

人字屋顶（三角顶）。沿 footprint 的 X 轴方向创建脊线。

// 人字屋顶
Lot --> primitiveCube(3, 2, 3) roofGable(1.2)

金字塔屋顶。所有边界顶点连接到 footprint 中心上方的顶点。

// 金字塔屋顶（适合方形 base）
Lot --> primitiveCube(2, 2, 2) roofPyramid(1.5)

脊线屋顶。在 footprint 中心上方创建一条脊线，两侧坡度对称。

// 脊线屋顶
Lot --> primitiveCube(4, 2, 3) roofRidge(1)

单坡屋顶。中心一点高，所有边界连接到中心顶点形成单一坡度。

// 单坡屋顶
Lot --> primitiveCube(2, 2, 2) roofShed(1)

将所有面沿法线方向平移指定距离，生成"外壳"几何体。

锥化/包络操作。根据角度参数将上部顶点向中心收缩。

清理几何体，合并重合顶点。

凸化几何体。用当前 bounding box 替代原几何体。

删除内部孔洞面。识别共享边数 > 2 的内部面并移除。

反转所有面的法线方向。

重新计算面法线和顶点法线。

软化法线，使光照过渡平滑。

矫正几何体为轴对齐包围盒。

简化几何体，按百分比减少面数。

重置几何体为当前 scope 的轴对齐包围盒。

删除面积过小的退化面。

为当前几何体添加标签。

删除当前几何体的所有标签。

沿指定轴镜像几何体。

提取当前几何体在 XZ 平面的投影（bounding box 底面）。

将 scope 的旋转重置为与世界坐标轴对齐。

将 scope 对齐到第一个面的法线方向。

将 scope 的 pivot 设为几何体 bounding box 中心，旋转重置。

绕各轴旋转 scope（角度制）。

设置 pivot 点到指定世界坐标。

沿指定轴镜像 scope 变换矩阵。

空操作，不产生任何几何输出。

设置纹理名称。

设置纹理投影模式和轴向。

平移 UV 坐标。

缩放 UV 坐标。

旋转 UV 坐标。

重置 UV 到标准状态（无平移、无缩放、无旋转）。

UV 平铺（同 scaleUV 的语义包装）。

插入（调用）指定名称的规则。同 CityEngine 的 i() 操作。

i() 的完整名称别名。

将 footprint 向内收缩指定距离后执行 body。

Lot --> setback(0.5) { color("red") }

将 footprint 分割为 L 形（前条 + 左条）。

Lot --> shapeL(1, 1) { front: color("red") | left: color("blue") }

将 footprint 分割为 U 形（前条 + 左条 + 右条）。

将 footprint 分割为 O 形（四边条状）。

在 footprint 内部生成一个内缩矩形并执行 body。

沿多边形周长分割并退缩。根据指定的 lengths 将面的周长分割成多个部分，然后对每个部分进行退缩。

Lot --> splitAndSetbackPerimeter(6)
  { 40 : 5 : Yellow |
    20 : 10 : Blue }
  { remainder : Grey }

在 footprint 范围内随机散布指定数量的小几何体并执行 body。

Lot --> scatter(10) { primitiveCone(0.1, 0.2) }