Cesium快速入门17:与entity和primitive交互

上节课我们学会了"一个图元里塞多个物体"。

新问题来了:鼠标随便点一下,我怎么知道到底点中了谁?能不能像 Three.js 那样"指谁打谁"?

答案当然是可以,套路还是那条老路------屏幕射线拾取(pick) 。

Cesium 已经把鼠标事件封装得服服帖帖,我们直接拿来用就行。

下面分三步:

  1. 先建"鼠标监听器";

  2. 再拿屏幕坐标去拾取;

  3. 拾到谁,就改谁的颜色,给它一个"被选中的"反馈。


一、创建鼠标监听器

Cesium 贴心地提供了 ScreenSpaceEventHandler,专门对付鼠标、触摸、键盘组合键。

它能监听左键按下、抬起、双击、右键、中键滚轮等十几种事件,今天咱们只关心"左键单击"。

复制代码
/* 1. 在 canvas 上布一个监听器 */
const handler = new Cesium.ScreenSpaceEventHandler(viewer.scene.canvas);

二、监听左键单击

监听器建好后,给它注册一个回调:

只要用户在地球任意处"咔哒"一下,我们就把鼠标位置拿出来做拾取。

复制代码
/* 2. 注册左键单击事件 */
handler.setInputAction((movement) => {
  console.log(movement);                       // 先打印看一眼结构,心里有底
  const pick = viewer.scene.pick(movement.position); // 核心:拾取函数
  /* 3. 如果拾到东西,并且是个带 id 的实例,就换颜色 */
  if (Cesium.defined(pick) && typeof pick === 'object' && Object.hasOwn(pick, 'id')) {
    rectPrimitive.getGeometryInstanceAttributes(pick.id).color =
      Cesium.ColorGeometryInstanceAttribute.toValue(Cesium.Color.ORANGE);
  }
}, Cesium.ScreenSpaceEventType.LEFT_CLICK);

代码讲解:

  • movement.position 就是屏幕二维坐标(左上角为原点)。

  • viewer.scene.pick(...) 会返回一个对象,若没点中则返回 undefined。

  • 点中 Primitive 里的某个实例时,返回的对象自带 id 字段,内容就是我们当初在 GeometryInstance 里填的字符串 id。

  • 拿到 id 后,用 getGeometryInstanceAttributes(id) 就能直接改颜色,无需重建 Primitive。


三、拾取结果长啥样

复制代码
{
  position: Cartesian2 {x: 1234, y: 567}, // 屏幕坐标
  // 可能还有 ctrlKey、shiftKey 等组合键标志
}

{
  id: 'ellipsoid',          // 我们之前写的实例 id
  primitive: rectPrimitive, // 所属图元
  // 其余内部字段略
}

只要 pick.id 是字符串,就能确定"点中的是 Primitive 里的某个实例",后续想高亮、隐藏、改大小,都照这个套路来。


四、小结

  • 任何鼠标交互,先上 ScreenSpaceEventHandler。

  • 想拾取,就 scene.pick(屏幕坐标),返回对象里自带 id。

  • 拾到后,实例属性随便改,颜色、显隐、矩阵都能实时生效。

  • 同一套代码既适用于 Primitive,也适用于 Entity,只是字段略有差异,下节课再展开。

把这条"监听 → 拾取 → 改属性"的流水线记住,后面做点击高亮、弹窗、属性编辑,全都照搬即可。

相关推荐
weixin_460443563 小时前
2026年新修订《网络安全法》实施:Java私有化考试系统如何做好SBOM、漏洞治理与安全升级?
java·开发语言·在线考试系统·企业培训考试系统·宏远培训考试系统·国企培训考试系统·国产化培训系统
子兮曰4 小时前
把 649 种文件格式塞进一个网页里:一个「文件不出浏览器」的预览器
前端·javascript·后端
Cc.Y7 小时前
Java零基础入门:可变字符串与包装类:StringBuilder、StringBuffer 与 通讯录管理系统实战
java·开发语言·python
paopaokaka_luck7 小时前
基于springboot+vue的智慧家政管理系统(AI问答、 WebSocket实时沟通、ECharts运营分析、订单规则与服务追踪)
java·javascript·spring boot·数据分析·echarts·mybatis
sm_926787057 小时前
RFID 标签打印的技术实现要点与二次开发实践
java·大数据·前端·c++·编辑器
阿森_dev7 小时前
2027 届毕设选题怎么选:30 个 Java 方向选题的实现难度排序
java·开发语言·spring boot·毕业设计·课程设计
by209997 小时前
C++ 多态:同一个基类接口,调用不同的函数
开发语言·c++·经验分享·多态
笔墨登场说说7 小时前
flink bin/start-cluster.sh 帮我做成开机启动
开发语言·python
Sarvartha7 小时前
Lambda 表达式和函数式接口
java·开发语言
IMPYLH7 小时前
HTML 的 <video> 元素
前端·html