基于 HTML5 + WebGL 的 3D 风力发电场

原创 Hightopo 图扑软件

前言

风能是一种开发中的洁净能源，它取之不尽、用之不竭。当然，建风力发电场首先应考虑气象条件和社会自然条件。近年来，我国海上和陆上风电发展迅猛。海水、陆地为我们的风力发电提供了很好地质保障。正是这些场地为我们的风力提供了用之不竭的能源。现在我们正在努力探索这些领域。

本文章实现了风力发电场的整体流程。能让大家能够看到一套完整风力发电预览体系。

需要注意的是，本次项目是使用 Hightopo 的 HT for Web 产品来搭建的。

预览地址：

https://hightopo.com/demo/wind-power-station/

大致流程

下面是整个项目的流程图。我们从首页可以进入到场区分布页面和集控页面。

场区分布页面又包括两个不同的 3D 场景，分别是陆地风机场和海上风机场。点击两个 3D 风机场最终都会进入到 3D 风机场景。

预览效果

首页:

1. 世界地图效果

2. 中国地图效果

3. 城市地图效果

集控中心页面（没有动画效果）：

场区分布页面（没有动画效果）：

陆地风机场：

海上风机场：

代码实现

我们可以看到，首页的地球有三种视角状态，世界地图、中国地图、城市地图。点击每个状态相机就会转到对应的位置。在这之前我们要先预先存一下对应的 center 和 eye 。

我们最好新建一个 data.js 文件，专门用来提供数据。

相关伪代码如下：

// 记录位置var cameraLocations = {    earth: {        eye: [-73, 448, 2225],        center: [0, 0, 0]    },
    china: {        eye: [-91, 476, 916],        center: [0, 0, 0]    },
    tsankiang: {        eye: [35, 241, 593],        center: [0, 0, 0]    }};

好了，有了数据之后。我们接下来该监听事件了。我们可以点击按钮，也可以点击高亮区域（世界地图只有按钮可以点击）进入到中国地图视角。

我们可以这样先获取这两个节点，然后对它们的点击事件进行相同的处理。但是，我觉得这种方式可以进行优化，更换一种思考方式。

我们可以先将事件进行过滤，我们创建两个数组，一个保存着类似 click、onEnter 这样可以执行的事件，一个保存着所有可以触发事件的节点。这样可以有利于我们维护，也可以使结构更加清晰。

下图，我们可以看到，如果当前节点没有事件权限或者当前事件本身就没有权限的话，就会被过滤掉。如果都可以正确返回，则执行对应的事件。

相关伪代码如下：

// 权限事件this.eventMap = {    clickData: true,    onEnter: true,    onLeave: true}
// 权限节点this.nodeMap = {    outline: true,    outline2: true,    earth: true,    bubbles: true,    circle: true}
/**  * 监听事件  */function initMonitor() {    var gv = this.gv　　 var self = this
    var evntFlow = function (e) {        var event = e.kind        var tag = e.data && e.data.getTag()
         // 检查当前事件或者节点是否能够被执行         if (!self.eventMap[event] && !self.nodeMap[tag]) return false
         self.nodeEvent(event, tag)    }
    gv.mi(eventFlow)}

只要我们当前要执行的节点符合要求，我们就会把 event (当前执行的事件) 和 tag (节点标签) 传给执行函数 nodeEvent 执行。这样就不会浪费资源去处理那些无效的事件或者节点了。

我们接下来来看看 nodeEvent 怎么处理吧！

相关伪代码如下：

/** * 气泡事件 * @param { string } event 当前事件 * @param { string } propertyName 当前节点标签 */bubblesEvent(event, propertyName) {    var dm = this.dm    var account = dm.getDataByTag('account')    var currentNode = dm.getDataByTag(propertyName)    var self = this
    var clickData = function() {        // 执行清除动作        self.clearAction()    }
    var onEnter = function() {       // do something    }
    var onLeave = function() {　　　　// do something    }
    var allEvent = { clickData, onEnter, onLeave }
    allEvent[event] && allEvent[event]()}

可以看到，我们可以利用 propertyName(节点标签) 字符串拼接组成一个方法名。比如当前拿到的节点标签是 bubbles ， this[`${ properName }Event`] 之后，拿到就是 this['bubblesEvent'] 这个方法。当然，这个方法是我们事先定义好的。

在具体的节点方法里面，我们创建了对应的事件函数。根据传过来的 event 来判断是否拥有对应的方法。如果有的话执行，否则返回 false 。这样做的好处是：解耦、结构简洁、出现问题能够快速定位。

但是，如果我们仔细想想，我们点击世界地图和中国地图的时候，功能都差不多！如果我们可以将他们合并的话，就会方便很多了！！我们来改造一下代码。

相关伪代码如下：

/**  * 执行节点事件  */function nodeEvent(event, propertyName) {    // 过滤是否有可以合并的事件    var filterEvents = function(propertyName) {        var isCombine = false　　　　　var self = this        if (['earth', 'china'].includes(propertyName)) {            self.changeCameraLocaltions(event, propertyName)            isCombine = true        }
        return !isCombine    }   var eventFun = this[`${propertyName}Event`]   // 执行对应的节点事件   filterEvents(propertyName) &&   eventFun &&   eventFun(event, propertyName)}

我们事先判断当前事件是否能合并，如果能的话返回 false ，不再执行下面的代码，然后执行自己的函数。

这时候，我们就可以通过对应的节点标签，从 data.js 的 cameraLocations 变量中取到对应的 center、eye 。

相关伪代码如下：

/** * 移动镜头动画 * @param { object } config 坐标对象 */function moveCameraAnim(gv, config) {　　var eye = config.eye　　var center = config.center　　// 如果动画已经存在，进行清空   if(globalAnim.moveCameraAnim) {      globalAnim.moveCameraAnim.stop()　　　 globalAnim.moveCameraAnim = null   }
   var animConfig = {   　　duration: 2e3   }
   globalAnim.moveCameraAnim = gv.moveCamera(eye, center, animConfig)}
// 需要改变相机位置changeCameraLocaltions(event, properName) {    var config = cameraLocations[properName]
    // 移动相机    this.moveCameraAnim(this.gv, config)}

移动镜头动画使用到了 gv 的 moveCamera 方法，该方法接受 3 个参数，eye (相机)，center (目标)，animConfig (动画配置) 。然后我们把当前动画返回给 globalAnim 的 moveCameraAnim 属性，方便我们进行清理。

接下来，就是切换页面了，这点需要非常小心谨慎。因为一旦没有把某个属性清除的话，将会导致内存泄漏等问题，性能会越来越慢。将会导致页面卡死的情况！

所以我们需要一个专门用来清除数据模型的函数 clearAction 。我们应该把所有的动画对象放到一个对象或者数组中。这样方便切换页面的时候清理掉。

相关伪代码如下：

/** * 清除动作 */clearAction(index) {    var { dm, gv } = this    var { g3d, d3d } = window
    allListener.mi3d && g3d.umi(allListener.mi3d)    allListener.mi2d && gv.umi(allListener.mi2d)    dm.removeScheduleTask(this.schedule)
    dm && dm.clear()    d3d && d3d.clear()
    window.d3d = null    window.dm = null
    for (var i in globalAnim) {        globalAnim[i] && globalAnim[i].pause()        globalAnim[i] = null    }
    // 清除对应的 3D 图纸    ht.Default.removeHTML(g3d)
    gv.addToDOM()    ht.Default.xhrLoad(`displays/HT-project_2019/风电/${index}.json`, function (text) {        let json = ht.Default.parse(text)        gv.deserialize(json, function(json, dm2, gv2, datas) {            if (json.title) document.title = json.title
            if (json.a['json.background']) {                let bgJSON = json.a['json.background']                if (bgJSON.indexOf('scenes') === 0) {                    var bgG3d
                    if (g3d) {                        bgG3d = g3d                    } else {                        bgG3d = new ht.graph3d.Graph3dView()                    }
                    var bgG3dStyle = bgG3d.getView()                    bgG3dStyle.className = index === 1 ? '' : index === 3 ? 'land' : 'offshore'
                    bgG3d.deserialize(bgJSON, function(json, dm3, gv3, datas) {                        init3d(dm3, gv3)                    })
                    bgG3d.addToDOM()                    gv.addToDOM(bgG3dStyle)                }                gv.handleScroll = function () {}            }
            init2d(dm2, gv2)        })    })}

首先我们需要把 dm(数据模型) 和 gv(图纸) 清除掉。还要注意：mi(监听函数)、schedule(调度任务) 应该在 dm.clear() 之前 remove。所有的动画进行 stop() 操作，然后将其值设为 null 。这里需要注意的是，执行 stop 之后，会调用一次 finishFunc 回调函数。

当我们的 2D 图纸里面包含 3D 背景的情况下，需要判断是否已经存在了 3D 的实例，如果存在不需要再次创建。有兴趣可以了解一下 webGL 的应用内存泄漏问题。

当进入两个 3D 场景场景的时候，我们需要一个开场动画，如开头效果 gif 图一样。所以我们，需要把两个开场动画的 center 和 eye 都存到我们已经定义好的 cameraLocations 中。

// 记录位置var cameraLocations = {    earth: {        eye: [-73, 448, 2225],        center: [0, 0, 0]    },    china: {        eye: [-91, 476, 916],        center: [0, 0, 0]    },    tsankiang: {        eye: [35, 241, 593],        center: [0, 0, 0]    },    offshoreStart: {        eye: [-849, 15390, -482],        center: [0, 0, 0]    },    landStart: {        eye: [61, 27169, 55],        center: [0, 0, 0]    },    offshoreEnd: {        eye: [-3912, 241, 834],        center: [0, 0, 0]    },    landEnd: {        eye: [4096, 4122, -5798],        center: [1261, 2680, -2181]    }}

offshoreStart、offshoreEnd、landStart、landEnd 表示海上和陆上发电场的开始位置和结束位置。

我们需要判断当前加载的是海上发电场还是陆上发电场。我们可以在加载对应图纸的时候添加 className 。

我们在 clearAction 这个函数已经定义了 index 这个参数，如果点击的是陆地发电场传的就是数字3，如果是海上发电场的话，就是数字4。

比如我需要加载陆地发电场，那么就可以通过判断 g3d.className = index === 3 ? 'land' : 'offshore' 来添加 className 。

然后在 init 里面进行初始化的判断。

相关伪代码如下：

function init() {    var className = g3d.getView().className
    // 执行单独的事件    this.selfAnimStart(className)
    this.initData()
    // 监听事件    this.monitor()}

我们拿到对应的 className ，传入相对应的类型并且执行对应的初始化事件，通过我们已经定义好的 moveCameraAnim 函数进行相机的动画。

相关伪代码如下：

/**  * 不同风电场的开场动画  */function selfAnimStart(type) {    var gv = this.gv    var { eye, center } = cameraLocations[`${type}End`]    var config = {            duration: 3000,            eye,            center,         }
    this.moveCameraAnim(gv, config)}

总结

这个项目让我们更加了解了风力发电。不管是风力发电场的地区优势，还是风机的结构、运转原理。

做完这个项目，自己得到了很多的成长和感悟。对于技术快速成长的一个好方法就是去不断的抠细节。项目是一件艺术品，需要不断对其进行打磨，要做到自己满意为止。每个细微的点都会影响后面的性能。所以，我们应该以匠人的精神去做任何事。

当然，我也希望一些伙伴能够勇于探索工业互联网领域。我们能够实现的远远不止于此。这需要发挥我们的想象力，为这个领域增添更多好玩的、实用的 demo。而且还能学到很多工业领域的知识。

继续滑动看下一个