基于 HTML5 的 3D 工控隧道案例

隧道的项目我目前是第一次接触，感觉做起来的效果还蛮赞的，所以给大家分享一下。这个隧道项目的主要内容包括：照明、风机、车道指示灯、交通信号灯、情报板、消防、火灾报警、车行横洞、风向仪、COVI、微波车检以及隧道紧急逃生出口的控制。这个例子我主要讲一下风向仪、排风以及逃生出口的动画设置， 还有就是点击交通信号灯，弹出窗口可以选择当前信号灯的信息等内容。

本例效果：

我是用  做的整个例子，首先创建 3D 场景，HT 有 3D 组件，可以直接通过 new ht.graph3d.Graph3dView 3D 组件来创建一个实例，然后通过 getView() 函数获取组件的底层 div，既然是 div，那位置显示控制就容易得多了：

dm = new ht.DataModel();//数据容器，可以将显示在界面上的所有数据通过 dataModel.add 存储在数据容器中 g3d = new ht.graph3d.Graph3dView(dm);//3D 组件 g3d.addToDOM();//将 3D 组件的底层 div 添加到 body 中

HT 的组件一般都会嵌入 BorderPane、SplitView 和 TabView 等容器中使用，而最外层的 HT 组件则需要用户手工将 getView() 返回的底层 div元素添加到页面的 DOM 元素中，这里需要注意的是，当父容器大小变化时，如果父容器是 BorderPane 和 SplitView 等这些HT预定义的容器组件，则HT的容器会自动递归调用孩子组件 invalidate 函数通知更新。但如果父容器是原生的 html 元素， 则HT组件无法获知需要更新，因此最外层的 HT 组件一般需要监听 window 的窗口大小变化事件，调用最外层组件 invalidate 函数进行更新。

为了最外层组件加载填充满窗口的方便性，HT 的所有组件都有 addToDOM 函数，其实现逻辑如下，其中 iv 是 invalidate 的简写：

addToDOM = function(){ var self = this,
        view = self.getView(), //获取组件的底层 div style = view.style;
    document.body.appendChild(view); //将组件的底层 div 添加进 body 中  style.left = '0';//HT 组件默认设置 position 样式属性为 absolute 绝对定位方式 style.right = '0';
    style.top = '0';
    style.bottom = '0';      
    window.addEventListener('resize', function () { self.iv(); }, false);            
}

最让我开心的应该是我的开发基本上跟设计部分完全分离了，因为 HT 可以通过 ht.Default.xhrLoad 函数直接加载 json 文件的场景，这样我跟设计师就是双进程了，非常开心呢~加载场景有三个步骤，如下：

ht.Default.xhrLoad('scenes/隧道.json', function(text){//加载 json 场景 var json = ht.Default.parse(text);//转义 json 文件 dm.deserialize(json);//将 json 内容反序列化到场景中 //可以在这个里面任意操作 datamodel 数据容器中的数据了 }

我在场景中添加了一些功能，包括前面提到过的一些动画操作，HT 封装好的 dataModel.addScheduleTask(task) 通过操作数据容器 dataModel 来控制加载动画，动画部分在参数 task 中声明，task 为 json 对象，可指定如下属性：

• interval：间隔毫秒数，默认值为 10
  
• enabled：是否启用开关，默认为 true
  
• action：间隔动作函数，该函数必须设置

 我的动画一共三个，两个隧道中各有一个风扇、一个风向仪以及一个卷闸门。设置这三个图元变化即可，我在 json 中分别将这三个图元的 tag 设置为 feng、feng2 以及 door，在代码中我就可以直接调用这三个图元的 tag 属性：

var task = {
    action: function(data){ if(!data.getTag()) return; var tag = data.getTag();//获取图元的 tag 属性 if(tag === 'feng'){
        data.r3(0, (data.r3()[1]+Math.PI/12), 0);//r3 为 3d 中的旋转，这里 y 轴在原来的基础上再旋转 Math.PI/12 角度
    }else if(tag === 'feng2'){
        data.r3(0, 0, data.r3()[2]+Math.PI/12);
    }else if(tag === 'door'){ if(data.getTall() > 0){//获取图元的 tall 属性，高度 data.setTall(data.getTall()-20);//设置高度为当前高度减去20  }
        }
    }
}
dm.addScheduleTask(task);//在数据容器 dataModel 中添加调度任务

接着是创建 form 表单，在表单上添加一些信息，比如交通灯的切换等等，场景默认显示的右上角的 form 表单我们这里不做解释，内容跟点击交通灯出现的 form 表单差不多，所以我们主要说明一下点击交通灯时出现的表单：

表单中重复的部分比较多，我挑出三个部分来解释一下：文本部分、“当前状态”显示的图标以及下面“修改状态”中的图标点击选择部分：

form.addRow([//addRow 添加一行 我这个部分是添加一个标题  {
        element: '交通灯控制',//这一行第一部分的显示文本 align: 'center',//文本对齐方式 color: 'rgb(0,210,187)',//文本颜色 font: 'bold 16px arial, sans-serif'//文本字体  }
], [0.1]);//记得要设置这行的宽度 form.addRow([ //这行中有两个部分，一个“设备描述”，一个 文本“0”，所以要设置两个宽度，宽度要放在一个数组中  '设备描述:',//第一部分 {//第二部分 element: '0',
        color: 'rgb(0,210,187)' }
],[80, 0.1], 34);//addRow 函数第二个参数为宽度设置，将上面内容的宽度依次放进这个数组中。第三个参数为高度 form.addRow([ '当前状态:',
    {//也可以将数组中的某个部分设置为空字符串，占据一些宽度，这样比例比较好调 element: '' },
    {
        id: '105',//id唯一标示属性，可通过formPane.getItemById(id)获取添加到对应的item对象 button: {//按钮，设置了该属性后HT将根据属性值自动构建ht.widget.Button对象，并保存在element属性上 icon: 'symbols/隧道用图标/light.json',//按钮上的显示图标 background: 'rgba(0,7,26,0.60)',//按钮背景 borderColor: 'rgb(0, 7, 26)',//按钮边框颜色 clickable: false//是否可点击  }
    }
],[80, 0.1, 84], 30);
form.addRow([//如果和上面一行的距离差别与其它行间距不同，可以通过增加一行空行，设置高度即可  '',
    {
        element: '' }
], [200, 0.1], 10);
form.addRow([ '修改状态:',
    {
        element: '' },
    {
        button: {
            icon: 'symbols/隧道用图标/light.json',//设置按钮的图标 background: 'rgba(0,7,26,0.60)',
            borderColor: 'rgb(0, 7, 26)',
            groupId: 'btn',//通过getGroupId和setGroupId获取和设置组编号，属于同组的togglable按钮具有互斥功能。后面的三个按钮也是设置了同一个 groupId onClicked: function(e){//点击后的回调函数 btnClick('light'); 
            }
        }
    }
],[80, 0.1, 84], 30);

这个 form 表单的背景只是设置了一张图片而已：

background: url('assets/控制.png') no-repeat;

上面还有一个部分没有提及，就是点击按钮后调用的 btnClick 函数：

function btnClick(imageName){ if(flag === 1){//做的判断是根据3d的事件来处理的，等下会提 dm.getDataByTag('light').s({//通过getDataByTag获取节点，设置节点的style样式 'back.image': 'symbols/隧道用图标/'+imageName+'.json',//设置图元的背面图片 'front.image': 'symbols/隧道用图标/'+imageName+'.json'//设置图元你的前面图片  });
    }else if(flag === 2){
        dm.getDataByTag('light1').s({ 'back.image': 'symbols/隧道用图标/'+imageName+'.json', 'front.image': 'symbols/隧道用图标/'+imageName+'.json' });
    }else{}
    form.getViewById(105).setIcon('symbols/隧道用图标/'+imageName+'.json');//设置id为105的item内容显示的图标为form表单上点击的交通灯的按钮的图标 }

最后就是点击事件了，一个是点击 3D 中的交通灯后出现交通灯控制的 form 表单，还有一个就是点击 form 表单上的“修改状态”中的图标事件：

g3d.mi(function(e){//addInteractorListener 函数 监听场景中的事件 form.getView().style.display = 'none';//所有的点击图元事件都先将form隐藏 if(e.kind === 'clickData'){//点击图元 if(e.data.getTag() === 'light'){//如果图元是正面的隧道的灯 form.getView().style.display = 'block';//显示form表单 form.iv();//刷新form表单，不然界面无法获知此时需要刷新form显示上面的内容，必须手动操作 flag = 1;
        }else if(e.data.getTag() === 'light1'){//背面的隧道的灯，点击切换隧道中的灯的显示，另外一个隧道中的灯不可能一起改变，所以要区分开 form.getView().style.display = 'block';
            form.iv();
        flag = 2;
    }else if(e.data.getTag() === 'wall'){//隧道墙体  e.data.s({ 'shape3d.transparent': true,//打开设置透明的开关 'shape3d.opacity': 0.2,//设置透明度 '3d.selectable': false//点击后就不可选中隧道了  });
    }
    }else if(e.kind === 'doubleClickBackground'){//点击空白处 设置隧道墙体不透明 dm.getDatas().forEach(function(data){//遍历dataModel if(data.getTag() === 'wall'){
            data.s({ 'shape3d.transparent': false,//关闭设置透明的开关，这样可以不用控制透明度 '3d.selectable': true//双击空白处可以使得隧道变得可选中  });
        }
    });
    }
});

本文例子地址：