cesium··约 4 分钟读完·311 次观看

Cesium 中computeViewRectangle的使用场景

本文介绍了Cesium中computeViewRectangle接口的使用场景和方法。该接口可获取相机视域在地表的外包矩形(WGS84弧度坐标),用于快速判断实体是否在可见区域。文章提供了7行核心代码实现该功能,并详细解析了API行为细节,包括空值处理、高度维度比较等注意事项。该方法适用于数字孪生、CIM等需要处理大量实体渲染的场景,通过视域剔除优化性能,避免无效渲染。最后强调在3D大屏场景中"看得见才渲染"的重要性。
javascript数码相机

Cesium 中computeViewRectangle的使用场景


一、背景:为什么“看得见”如此重要

在数字孪生、城市信息模型(CIM)或空三展示场景里,几十万甚至上百万条实体同时加载到 Cesium 场景是常态。
如果一股脑全部渲染,GPU 和 CPU 都会被浪费在“镜头背后”的对象上。
因此,“相机视域剔除(Frustum Culling)”就成了首道性能护城河。
Cesium 官方提供了两种高层接口:

  1. viewer.camera.getPixelSize —— 适合判断“实体在屏幕上占多少像素”;
  2. viewer.camera.computeViewRectangle —— 直接给出“当前镜头在地表上的外包矩形”。

本文要聊的,就是如何用 7 行代码,借助第 2 种接口完成“实体是否在地表可见区域”的极速判断。


二、7 行代码逐行拆解

js
      
        
          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。
需要高度剔除时,可额外判断:

js
      
        
          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 浏览

这篇文章对你有帮助吗?