Cesium 中computeViewRectangle的使用场景
Cesium 中computeViewRectangle的使用场景
一、背景:为什么“看得见”如此重要
在数字孪生、城市信息模型(CIM)或空三展示场景里,几十万甚至上百万条实体同时加载到 Cesium 场景是常态。
如果一股脑全部渲染,GPU 和 CPU 都会被浪费在“镜头背后”的对象上。
因此,“相机视域剔除(Frustum Culling)”就成了首道性能护城河。
Cesium 官方提供了两种高层接口:
viewer.camera.getPixelSize—— 适合判断“实体在屏幕上占多少像素”;viewer.camera.computeViewRectangle—— 直接给出“当前镜头在地表上的外包矩形”。
本文要聊的,就是如何用 7 行代码,借助第 2 种接口完成“实体是否在地表可见区域”的极速判断。
二、7 行代码逐行拆解
1
// 1. 取出实体在“当前时刻”的位置
2
const position = entity.position?.getValue(Cesium.JulianDate.now());
3
if (!position) return; // 2. 位置无效直接短路
4
5
// 3. 计算相机当前视域在地表上的外包矩形(WGS84 弧度坐标)
6
let rectangle = viewer.camera.computeViewRectangle();
7
if (!rectangle) return []; // 4. 矩形无效(常见于地下/太空视角)直接返回
8
9
// 5. 把笛卡尔坐标转成弧度
10
const cartographic = Cesium.Cartographic.fromCartesian(position);
11
12
// 6. 判断点是否在矩形内
13
const show = Cesium.Rectangle.contains(rectangle, cartographic);
14
15
// 7. 根据布尔值决定实体显隐(或数据层筛选)
16
entity.show = show;
三、核心 API 行为细节
1. computeViewRectangle 的“坑”
- 返回类型:
Cesium.Rectangle(西/南/东/北,单位弧度)。 - 如果相机朝上看或完全离地心太远,会返回
undefined——此时建议回退到camera.getPixelSize或BoundingSphere做体积剔除。 - 对地下相机、VR 模式、 Columbus View 同样可能失效,务必做空保护。
2. fromCartesian 的“高度”维度
Cartographic.fromCartesian 会解析出 (longitude, latitude, height)。
但 Rectangle.contains 只比较二维 (lon, lat),高度被完全忽略。
也就是说,即使实体在相机“正上方 10 km”,只要经纬度落在矩形内,也会被判为 true。
需要高度剔除时,可额外判断:
1
const camHeight = viewer.camera.positionCartographic.height;
2
if (cartographic.height > camHeight + 1000) show = false; // 举例:高于相机 1 km 就隐藏
四、结语
“看得见才渲染”是 3D 大屏场景的生存法则。
Cesium 已经把复杂的空间几何运算封装成一行 Rectangle.contains,
剩下的,就是你在数据层把它用对、用稳、用快。
相关文章
查看同分类文章使用cesium设置第一视角
在 Cesium 中,借助结合合理的视角偏移设置,可以方便地实现第一视角跟随模型移动的效果。这一功能在众多地理空间可视化、模拟仿真等应用场景中都有着重要的价值,通过进一步的优化和扩展,还能够满足更加多样化和复杂的交互需求,为用户提供简单而强大的第一视角观察体验。随着对 Cesium 功能的深入挖掘和应用场景的不断拓展,相信会解锁更多基于第一视角的创新应用方式。
1190 浏览
`ConstantPositionProperty` 的使用与应用
是 Cesium 中用于表示实体位置的属性类。它表示一个实体在三维空间中的位置是固定的,不会随时间变化。与动态位置属性(如 )不同, 适用于那些位置不会变化的实体。 通常用于以下场景:以下是一个使用 设置实体位置的示例: 4. 与动态位置属性的对比 和动态位置属性(如 )的主要区别在于:通过使用 ,可以高效地表示固定位置的实体,避免不必要的性能开销。
496 浏览
cesium中的CallbackProperty
是一个属性(Property),其值由一个回调函数延迟计算。这意味着,每当属性被访问时,都会调用一个函数来计算其值。这种机制使得我们可以实时地改变实体的状态,而不需要频繁地重新设置整个属性。
1908 浏览
在Cesium中,将点击的位置转换为经纬度
这样,当用户在Cesium场景中点击时,控制台就会输出点击位置的经纬度和高度信息。方法来获取点击位置的笛卡尔坐标(Cartesian3)。方法将笛卡尔坐标转换为地理坐标(Cartographic)。对象,如果点击的位置在地球表面之外,则返回。方法将地理坐标的经度和纬度转换为度数。:当用户点击场景时,使用。
778 浏览