经纬志
首页 / Cesium / 使用示例

CZML 盒子

盒子的尺寸写在 box.dimensions 里,单位米;orientation 用四元数,方便把盒子摆成任意姿态。

CesiumJS 1.121 · 更新 2026-10-28
源码与运行效果
运行效果

尺寸与位置

position 是盒心,dimensions 是长宽高,两者都按米算。CZML 里的尺寸是全尺寸,写 200 就是 200 米,不是半长。

朝向怎么给

orientation 用 unitQuaternion,[0, 0, 0, 1] 表示正北正上。示例给其中一个盒子一个绕竖直轴旋转的四元数,两个盒子并排就能看出差别。

可以直接改的地方

位置改什么效果
box.dimensions[x, y, z]盒子尺寸
box.material.solidColor.colorrgba 数组颜色
box.outlinetrue描边

朝向的坐标系:盒子默认按地心坐标系摆放,想让底面贴地要在外面套一层 orientation。