兔年首文迎新春-Cesium橘子洲烟花礼赞

兔年新春

今天是兔年大年初二，神州大地，在经历了疫情的三年后迎来开放的一个春节。大家都沉浸在欢乐幸福的春节气氛中。玉兔迎新春，祝福齐送到：白兔祝你身体安康，黑兔祝你薪水高涨，灰兔送你梦想如意，花兔愿你早日高升，公兔祈祷你名利双收，母兔称赞你家和万事兴，只有兔崽崽最淘气，鞭炮连连，让你欢乐一整年。祝各位技术同仁在新的一年里，发量比Bug多，他/她比最帅/最靓的明星更亮，RMB把钱包撑破。

一、橘子洲头

大家对《沁园春.长沙》想必都非常熟悉。词的内容，上阙为描写湘江、橘子洲、岳簏山生机盎然的秋景，下阙为怀念同学少年的生活，抒发救世济民的远大理想，洋溢着激流奋进的壮志和豪情。现在，诗词碑已成为橘洲景区的标志性景点之一。词中，橘子洲头、看万山红遍、层林尽染、万江碧透、百舸争流，描述的就是橘子洲头的景象。恰同学少年，风华正茂，书生意气，挥斥方遒。表达了伟人当时的远大理想和壮志豪情，每次登临岳麓山，到岳麓书院，于橘子洲头，感受到流传下来的气魄，因此，这山和水也便被赋予了精神。

作为旅游城市，橘子洲的烟花表演一直是以前很多来星城必须要进行的一项打卡活动，同时也是湖南烟花对外展示的一个窗口。当然，烟花燃放的污染物排放一直是人们关注的首个重点目标，而现在浏阳烟花也是不断的改进烟花燃放工艺，争取减少污染区的排放。而随着疫情的爆发，也加上对排污治理的整治，橘子洲烟花与人们的邂逅机会就越来越少，曾几何时，橘子洲烟花是一周一次，后面变成了逢重大活动才燃放，一般在一年4次左右。下面来几张曾经的橘子洲烟花的燃放盛况，供大家观赏吧，图片来源于网络供图（百家号和影像湖南）。

虽然现在难得遇到一次橘子洲头的烟花燃放，但作为技术人，可以充分利用WebGL技术，结合时空地理地图，地形数据来一场实时可见的烟花燃放盛况。在这里遇见岳麓山、遇见橘子洲头，山水洲城的盛宴。在本文中基于Cesium开源框架，采用开源WebGL技术，叠加全国影像地图（本地私有化），标签路网数据、地形数据，采用粒子系统，实现烟花燃放的效果。先来一张效果图开胃吧。

二、Cesium烟花实现

由于采用Cesium开源实现，因此基础的依赖于Cesium.js，感兴趣的朋友可以自行在github（cesium github）或者官方网站（cesium）上下载相关依赖。Cesium可以基于原生的html5和javascript来进行运行，也支持和现代流程框架React和Vue等前端框架进行集成开发。可以根据自己的技术栈来合理选型。

将下载之后的Cesium编译后的js文件复制到工程的Build目录下，如下所示：

在上一层的Documentation目录中是同版本对应的API文档，您可以直接打开html页面，这是最全的API介绍文档。

在cesiumdemo或者任意目录下新建fireworks2.html，关键代码如下所示：

    大展宏兔，大吉大利

      @import url(Build/Cesium/Widgets/widgets.css);
      html,
      body,
      #cesiumContainer {
        width: 100%;
        height: 100%;
        margin: 0;
        padding: 0;
        overflow: hidden;
      }

在上面的代码中通过引入Cesium.js，并且在页面中创建了一个div用于渲染展示cesium地球组件。但这是还未将cesium和页面元素进行绑定，也没有加载加载相应的底图和地形数据。

下面将通过UrlTemplateImageryProvider对象来进行Cesium的底图对象定义，示例代如下所示：

//加载影像底图
var imageryProvider = new Cesium.UrlTemplateImageryProvider({
    url: "http://localhost:8086/data/basemap_water/{z}/{x}/{y}.png",
    tilingScheme: new Cesium.WebMercatorTilingScheme(),
    fileExtension: 'png',
    minimumLevel: 1,
    maximumLevel: 16
});

var labelProvider = new Cesium.UrlTemplateImageryProvider({
    url: "http://localhost:8086/data/basemap_nowater/1-10label/{z}/{x}/{y}.png",
    tilingScheme: new Cesium.GeographicTilingScheme(),//投影方式为经纬度直投，否则路网不对
    fileExtension: 'png',
    minimumLevel: 1,
    maximumLevel: 10
 });

//加载本地地形数据
var terrainLayer = new Cesium.CesiumTerrainProvider({
    url: "http://localhost:8086/data/hunanterrain",
    // 请求照明
    requestVertexNormals: true,
    // 请求水波纹效果
    requestWaterMask: false
});

上面的代码定义了地形数据，同时使用如下的代码将地形数据、底图数据都添加到Cesium的视图对象中，并且将标签图层也添加到对象中。用于系统，同时将cesium的展示视角初始调整为橘子洲的经纬度坐标。

var viewer = new Cesium.Viewer('cesiumContainer',{
    imageryProvider:imageryProvider,
    terrainProvider: terrainLayer,
    baseLayerPicker:false,
    homeButton: true,
    baseLayerPicker: false,
    animation: false,
    timeline: false,
    navigationHelpButton: false,
    geocoder: false,
    sceneModePicker: false,
    shouldAnimate: true,
});

// 设置相机初始位置
var homeCameraView = {
        destination: Cesium.Cartesian3.fromDegrees(112.955074,28.16843,507.0480578185452),
            orientation: {
                heading:5.656571359006588,
                pitch: -0.28428181994862656,
                roll: 0
            },
        };

viewer.camera.setView(homeCameraView);

viewer.imageryLayers.addImageryProvider(labelProvider);
// 隐藏版权信息
viewer._cesiumWidget._creditContainer.style.display = "none";

viewer.scene.globe.enableLighting = false;//关闭光照

粒子系统是WebGL中的一个非常重要的组成部分，通过粒子系统可以实现很多的特效。粒子系统是一种模拟复杂物理效应的图形技术。粒子系统是小图片的集合，当放到一起观察它们时，会形成一个更复杂的”模糊”对象，例如火、烟雾、气候，或者烟火（fireworks）。通过使用例如初始位置、速度和寿命属性来指定单个粒子的行为，可以控制这些复杂的效果。这里推荐一篇介绍粒子系统比较简单同时讲解比较清楚的入门博客Cesium中文教程-粒子系统介绍(Introduction to Particle Systems)和cesium粒子系统介绍，更多的关于粒子系统的说明，可以上WebGL知识去深入学习，这里不做特别深入的讲解（因为博主也学得不深）。本文结合代码来简要说明粒子系统的一些知识。

模拟图片源，粒子系统可以理解是多个小图片的集合整体渲染。所以可以基于外部图片的渲染，比如爆炸的效果，同时作为烟花的特效，这里采用模拟图片实现。关键代码如下：

let particleCanvas;

function getImage() {
  if (!Cesium.defined(particleCanvas)) {
        particleCanvas = document.createElement("canvas");
        particleCanvas.width = 30;
        particleCanvas.height = 30;
        const context2D = particleCanvas.getContext("2d");
        context2D.beginPath();
        context2D.arc(10, 10, 10, 0, Cesium.Math.TWO_PI, true);
        context2D.closePath();
        context2D.fillStyle = "rgb(255, 255, 255)";
        context2D.fill();
       }
   return particleCanvas;
}

粒子系统在Cesium被进行了简单封装，开发者通过API进行简单调用即可。

new Cesium.ParticleSystem({
    image: getImage(),
    startColor: color,
    endColor: color.withAlpha(0.0),
    particleLife: life,
    speed: 30.0,
    imageSize: particlePixelSize,
    emissionRate: 0,
    emitter: new Cesium.SphereEmitter(1.8),
    bursts: bursts,
    lifetime: lifetime,
    updateCallback: force,
    modelMatrix: modelMatrix,
    emitterModelMatrix: emitterModelMatrix,
   })
);

最后通过循环和一些随机坐标偏移来实现烟花的位置随机展示，在粒子播放的时候，会进行回归调用。

const xMin = -100.0;
const xMax = 150.0;
const yMin = -80.0;
const yMax = 150.0;
const zMin = -50.0;
const zMax = 50.0;

const colorOptions = [
{
minimumRed: 0.75,
green: 0.0,
minimumBlue: 0.8,
alpha: 1.0,
},
{
red: 0.0,
minimumGreen: 0.75,
minimumBlue: 0.8,
alpha: 1.0,
},
{
red: 0.0,
green: 0.0,
minimumBlue: 0.8,
alpha: 1.0,
},
{
minimumRed: 0.75,
minimumGreen: 0.75,
blue: 0.0,
alpha: 1.0,
},
];

for (let i = 0; i < numberOfFireworks; ++i) {
     const x = Cesium.Math.randomBetween(xMin, xMax);
     const y = Cesium.Math.randomBetween(yMin, yMax);
     const z = Cesium.Math.randomBetween(zMin, zMax);
     const offset = new Cesium.Cartesian3(x, y, z);
     const color = Cesium.Color.fromRandom(
          colorOptions[i % colorOptions.length]
     );

      const bursts = [];
      for (let j = 0; j < 5; ++j) {
            bursts.push(
              new Cesium.ParticleBurst({
                time: Cesium.Math.nextRandomNumber() * lifetime,
                minimum: burstSize,
                maximum: burstSize,
              })
            );
      }

    createFirework(offset, color, bursts);
}

下面给一个最终的效果图，一个在橘子洲头的动态烟花效果，真诚的祝福大家新年快乐，兔年大吉。

这里给的Cesium.js是编译之后的，所以对于debug不太友好，如果需要源码调试可以使用开发版本，可以观察到更深入的调用过程。对于理解粒子系统更加有帮助，调试起来吧。

以上就是本文的所有内容，本文首先介绍了橘子洲头的一些相关知识，它与伟人的渊源，与烟花的关系。最主要的是介绍了基于Cesium的电子烟花的展示播放技术，重点介绍了在Cesium中如何进行集成，粒子系统的创建过程以及加载技术。最后祝所有的技术人都能一飞冲天，炫彩夺目。

Original: https://blog.csdn.net/yelangkingwuzuhu/article/details/128753215
Author: 夜郎king
Title: 兔年首文迎新春-Cesium橘子洲烟花礼赞