HTML5中Canvas的3D压力器反序列化

实践场景再现：

首先我们搭建一下这个例子的场景，熟悉的朋友可能已经看出来了，这个场景分为三个部分：左、右上以及右下。HT 通过 ht.widget.SplitView 可以很轻松地将场景分割，实现良好的页面布局，最后将这个分割组件添加进 html 的 body 体中：

//场景搭建
dataModel = new ht.DataModel();//数据容器
 
g3d = new ht.graph3d.Graph3dView(dataModel);//3D 组件
propertyView = new ht.widget.PropertyView(dataModel);// 属性组件
formPane = new ht.widget.FormPane();//表单组件
rightSplit = new ht.widget.SplitView(propertyView, formPane, 'v', 100);//分割组件
 
new ht.widget.SplitView(g3d, rightSplit, 'h', 0.65).addToDOM();

接下来就是向场景中添加图元，并把图元添加到 3D 场景中，这时我们可以向图元中添加各种属性和样式以及标签作为标记，本例中用到的图元是 3D 模型，利用 ht.Default.parseObj 函数对 obj 和 mtl 文件进行解析：

//添加模型
var params = {center: true};//JSON格式控制参数 传入 ht.Default.parseObj 函数中
var modelMap = ht.Default.parseObj(meter_obj, meter_mtl, params);//解析obj和mtl文件， 解析后返回的map结构json对象中，每个材质名对应一个模型信息

当然，前提是要已经声明了 meter_obj 以及 meter_mtl 两个文件，这里我们是将这两个部分分别放到 js 文件中，并在头部调用。

从上面的动图中我们可以看到，这个例子中需要变化的模型部分只有“指针”以及下面的“开关”两个部分，所以我们通过遍历的方式获取这两个 obj 模型的部分，并注册 3D 模型：

var array = [];
for(var name in modelMap){
 var model = modelMap[name];//modelMap 中的模型
 array.push(model);
 
 if(name === 'pointer'){//obj 文件中的一个模型 名称为 pointer
 model.mat = {//矩阵变化参数，可对模型进行矩阵变化后导入 
 func: function(data){
 var start = Math.PI * 0.736,
 range = Math.PI * 1.49, 
 angle = start - range * data.a('meter.value') / 4;//动态获取了 meter.value 的值
 return ht.Default.createMatrix([//将一组JSON描述的缩放、移动和旋转等操作转换成对应的变化矩阵
 { t3: [0, -82.5, 0] },
 { r3: [0, 0, angle] },
 { t3: [0, 82.5, 0] }
 ]);
 }
 }; 
 }
 if(name === 'switch'){//obj 文件中的一个模型 名称为 switch
 model.mat = {
 func: function(data){
 return ht.Default.createMatrix([
 { t3: [0, 48.5, 0] },
 { r3: [0, 0, data.a('meter.angle')] },
 { t3: [0, -48.5, 0] }
 ]);
 }
 }; 
 model.color = {
 func: function(data){
 if(data.a('meter.angle')){
 return 'rgb(186, 0, 0)';
 }else{
 return 'black';
 }
 }
 };
 }
}
ht.Default.setShape3dModel('meter', array);//注册3D模型，请参考modeling建模手册 第一参数为模型名称，第二参数为 JSON 类型对象

之后用户可以在需要用到的地方直接设置属性 shape3d 为这边注册过的 3D 模型名称，我们下面就创建 3 个节点，并将节点设置为此 3D 模型：

for(var i=0; i<3; i++){//创建3个节点 meter
 var node = new ht.Node();
 node.setTag(i);//设置 tag 标签
 node.setName('Meter - 00' + (i+1));//设置图元名称一般显示在图元的下方
 node.s({
 'label.color': 'white',
 'label.background': '#5271B8',
 'label.face': 'center',
 'label.position': 23,
 'label.scale': 2,
 'label.reverse.flip': true, 
 
 'note.scale': 1.5,//设置字体大小，这种方式不会碰到浏览器最小字体的问题
 'note.t3': [-30, -5, -90], 
 
 'note2.scale': 1.2,
 'note2.position': 17,
 'note2.t3': [0, -20, -30],
 'note2.color': 'black',
 'note2.background': 'yellow', 
 
 'shape3d': 'meter',//设置为前面注册的 meter 3D 模型
 'shape3d.scaleable': false,
 'wf.visible': 'selected',//选中图元时显示线框
 'select.brightness': 1
 });
 node.a({//自定义属性 下面会利用这些自定义属性进行数据绑定
 'meter.value': i+1,
 'meter.angle': i * Math.PI / 3
 });
 node.p3(i*200-200, params.rawS3[1]/2, i===1?100:-100); 
 node.r3(0, -Math.PI/6*(i-1), 0);
 node.s3(params.rawS3);//设置图元的大小为 rawS3 模型的原始尺寸
 dataModel.add(node); //向数据模型中添加节点 
}
dataModel.sm().ss(dataModel.getDataByTag(1));//设置默认选中 tag 标签为1的图元

我们在这边为节点添加两个标注，作为文字提示，可以通过重载 getNote/getNote2（HT 中一个节点支持双标注，所以提供了 note2 第二个标注） 函数重载 note 的命名方法，当然 HT 中其他类似的文字提示也可以通过这种途径来改变文字的显示信息，这里我们通过数据绑定获取 meter.value 以及 meter.angle 两个属性的动态数据：

g3d.getNote = function(data){//重载 getNote 方法
 return 'Value:' + data.a('meter.value').toFixed(2);
};
g3d.getNote2 = function(data){
 var value = Math.round(data.a('meter.angle') / Math.PI * 180);//获取了 meter.angle 属性，数据实时变化 
 return value ? 'Angle:' + value : 'Switch is off';
};

我们还在场景的显示部分使了一点小心机~通过改变实现 eye 和 center 的值来实现视线由远及近的效果：

var oldEye = g3d.getEye().slice(0),
oldCenter = g3d.getCenter().slice(0),
newEye = [200, 300, 650],
newCenter = [0, params.rawS3[1]/2, 0];

ht.Default.startAnim({//动画 
 duration: 1000,//持续时间
 easing: function(t){ //动画缓动函数，默认采用 ht.Default.animEasing
 return (t *= 2) < 1 ? 0.5 * t * t : 0.5 * (1 - (--t) * (t - 2)); 
 },
 action: function(k){//action 函数必须提供，实现动画过程中的属性变化 参数 k 代表通过 easing(t) 函数运算后的值
 g3d.setEye(
 oldEye[0] + (newEye[0] - oldEye[0]) * k,
 oldEye[1] + (newEye[1] - oldEye[1]) * k,
 oldEye[2] + (newEye[2] - oldEye[2]) * k
 );
 g3d.setCenter(
 oldCenter[0] + (newCenter[0] - oldCenter[0]) * k,
 oldCenter[1] + (newCenter[1] - oldCenter[1]) * k,
 oldCenter[2] + (newCenter[2] - oldCenter[2]) * k
 ); 
 } 
});

整个左边实现完成~接着该实现右上部分，属性值的显示以及控制，我们总共添加了四个属性：名称、meter.value、meter.angle以及旋转 rotation，通过数据绑定操作属性栏中的值来改变 3D 模型中的显示状态，数据绑定我们通过获取 accessType 以及 name 中的值来配合调用到这个属性：

propertyView.addProperties([//用 json 的数组参数方式批量添加属性信息
 {
 name: 'name',//属性名 这里不用设置 accessType，因为 accessType 默认的值为 setName/getName 这种格式 
 editable: true//设置为可编辑状态
 },
 {
 name: 'meter.value',//用于存取name属性，该属性结合accessType属性最终实现对Data属性的存取
 accessType: 'attr',//通过 getAttr/setAttr 获取或设置属性值
 editable: true,
 slider: {
 min: 0,
 max: 4
 }
 },
 {
 name: 'meter.angle',
 accessType: 'attr',
 editable: true,
 formatValue: function(value){//一般用于将数字转换更易读的文本格式
 return Math.round(value / Math.PI * 180);
 },
 slider: {
 min: 0,
 max: Math.PI,
 step: Math.PI/180*5,//每移动一下滑动的步进
 getToolTip: function(){//设置鼠标放在图元上的文字提示
 return Math.round(this.getValue() / Math.PI * 180);
 }
 }
 },
 {
 name: 'rotation',
 editable: true,
 formatValue: function(value){
 return Math.round(value / Math.PI * 180);
 },
 slider: {
 min: -Math.PI,
 max: Math.PI,
 step: Math.PI/180*5,
 getToolTip: function(){
 return Math.round(this.getValue() / Math.PI * 180);
 }
 }
 } 
]);

最后进行右下部分 formPane 表单面板的解析，formPane 通过 addRow 函数向表单中添加行，这个表单中总共两行，其中第一行有两个部分：

formPane.addRow([//向表单组件中添加行
 {
 id: 'export',
 button: {//按钮 
 label: 'Export JSON',
 onClicked: function(){//点击时触发的函数
 var json = dataModel.serialize();
 formPane.v('textArea', json);
 }
 }
 },
 {
 button: { 
 label: 'Import JSON',
 onClicked: function(){
 dataModel.clear();//清空数据模型
 dataModel.deserialize(formPane.v('textArea'));//将获取到的 textArea 中的数据反序列化，是下面一行的 id 值
 }
 }
 }
],
[0.1, 0.1]); //最后的参数是这行的宽度分配比例 小于1的值为比例，大于1为实际值 
formPane.addRow([
 {
 id: 'textArea',
 textArea: {
 }
 }
],
[0.1], 0.1);

这样，我们就可以根据修改属性栏中或者 JSON 文件，直接看到 3D 中我们修改的效果啦~怎么样？是不是很酷很快？