Cesium 水波材质教程

水波材质 ·Water Material· ▶ 在线运行案例

• 案例合集：三维可视化功能案例（threehub.cn）
• 开源仓库github地址：https://github.com/z2586300277/three-cesium-examples
• 400个案例代码：网盘链接

你将学到什么

• 水面反射/镜像材质

效果说明

本案例演示水波材质效果：基于 WebGL 实现「水波材质」可视化效果，附完整可运行源码；核心用到 水面反射/镜像材质。建议先打开文首在线案例查看动态画面，再对照下方源码逐步理解。

核心概念

• Viewer聚合 Scene、Camera、Clock 与渲染循环，是 Cesium 应用入口。
• 阅读下方完整源码时，建议从init/load/animate三条主线入手，再深入 shader 与工具函数。

实现步骤

• 创建 Viewer，配置地形/影像（若案例需要）并设置初始相机
• 在requestAnimationFrame循环中更新状态并 render（Cesium 为viewer.render或自动渲染）

• 代码要点

  import * as Cesium from 'cesium'
  const box = document.getElementById('box')
  const viewer = new Cesium.Viewer(box, {
  animation: false,//是否创建动画小器件，左下角仪表
  baseLayerPicker: false,//是否显示图层选择器，右上角图层选择按钮
  baseLayer: Cesium.ImageryLayer.fromProviderAsync(Cesium.ArcGisMapServerImageryProvider.fromUrl('https://server.arcgisonline.com/arcgis/rest/services/World_Imagery/MapServer')),
  fullscreenButton: false,//是否显示全屏按钮，右下角全屏选择按钮
  timeline: false,//是否显示时间轴
  infoBox: false,//是否显示信息框
  })
  // 添加水波纹效果 const positions = [-109.080842, 45.002073, -105.91517, 45.002073 , -104.058488, 46.996596]; // 示例坐标数组 const index = 1; // 示例索引
  const primitives = new Cesium.Primitive({ geometryInstances: new Cesium.GeometryInstance({ id: 'waterRipple' + index, geometry: new Cesium.PolygonGeometry({ polygonHierarchy: new Cesium.PolygonHierarchy(Cesium.Cartesian3.fromDegreesArray(positions)), height: 0, }), }), appearance: new Cesium.EllipsoidSurfaceAppearance({ material: new Cesium.Material({ fabric: { type: "Water", uniforms: { baseWaterColor: Cesium.Color.fromCssColorString('rgba(64,157,253,0.5)'), blendColor: Cesium.Color.fromCssColorString('rgba(64,157,253,0.3)'), normalMap: FILE_HOST + "images/drei/normal.jpg", frequency: 500.0, animationSpeed: 0.1, amplitude: 20, specularIntensity: 5 } } }), }), })
  viewer.scene.primitives.add(primitives);
  // 定位到水波纹位置 viewer.camera.flyTo({ destination: Cesium.Cartesian3.fromDegrees(-106.0, 44.5, 120000), // 提升高度可以看清水面效果 orientation: { heading: Cesium.Math.toRadians(0), pitch: Cesium.Math.toRadians(-45), // 斜视角度更容易看出波纹 roll: 0 }, duration: 1 });

  完整源码：GitHub

  小结

  • 本文提供水波材质完整 Cesium.js 源码与在线 Demo，建议先运行案例再改 uniform/参数做二次实验
  • 更多 Cesium.js 实战案例见 three-cesium-examples 合集 与 GitHub 开源仓库