← 返回函数库

rotate

Transformations Rotation 已实现

CityEngine 官方语法

rotate(rx, ry, rz)
rotate(abs, scope, rx, ry, rz)
rotate(rel, scope, rx, ry, rz)

参数说明

参数类型默认值说明
rx, ry, rzfloat0绕 X/Y/Z 轴的旋转角度（度）。
modeselectorabs旋转模式：abs（绝对）或 rel（相对）。
coordSystemselectorscope坐标系：scope 或 world。

描述

旋转当前形状。与 r 不同，rotate 支持模式和坐标系参数，可以更精确地控制旋转行为。

绝对模式（abs）将旋转设置为指定角度；相对模式（rel）在当前旋转基础上累加。

官方示例

绝对旋转 45°：

Mass --> rotate(0, 45, 0) Rotated

相对旋转（在当前角度上累加）：

Mass --> rotate(rel, scope, 0, 15, 0) Tilted

代码编辑器自动补全

枚举值自动补全：输入 rotate( 时，补全列表显示带模式的条目：
rotate(rx, ry, rz) rotate(abs, scope, rx, ry, rz) rotate(rel, scope, rx, ry, rz)
可直接选择对应的重载形式。

实现说明

CGA.js 中的 rotate 实现基于 CityEngine 2025.1 官方文档。

🎨 3D 预览 — 旋转

@StartRule
Lot --> primitiveCube(4, 4, 4)
        rotate(0, 45, 0)
        color(0.6, 0.7, 0.8)