这是公司大神写的一个放官网上给用户学习的例子,我一开始真的不知道这是在干嘛,就只是将三个形状图元组合在一起,然后可以同时旋转、放大缩小这个三个图形,点击“Animate”就能让中间的那一个图元单独绕着某一个点旋转,表单最上方的“Axis”真的完全不知道拿来干嘛用的,觉得好累赘,而且是官网的demo,也没有解释。。。所以我今天得任务就是完全剖析这个例子!
本文例子:http://www.hightopo.cn/demo/3drotate/3d-rotate.html
首先让我们来看下这个案例:
我们来看看如何操作这个3d交互模型,可以直接滑动“Rotation”的滑动条,你会看到3d和左下角的2d上的图元都会旋转,接着点击“Axis”中的任意一个值,然后点击“Animate”,你会看到中间这个图元会旋转,同时滑动“Range”的滑动条,这是控制你旋转的幅度的,如果你调到“0”,那么就不会旋转,调到“30”就会旋转30度,以此类推。接着调整“Reset”你会发现,不是完全刷新这个界面,而是局部刷新两边的圆柱,根据这两个圆柱与中间节点之间的关联而重置的。
左下角的是整个3d场景内的俯视图,这样我们可以非常直观地看清图元的移动方向和位置。
可能你会好奇这个是怎么俯视图是怎么放上去的?如果3d中的图元变化,这个俯视图中的图元也会跟着变化么?如何把右上角的form表单和左下角的视图又是怎么放的?如何只移动3d二把这两个固定在这边?或者你可能还有别的问题,在这里我会尽量清楚地解答,实在找不到答案可以去我们的官网HT for Web查找你的问题。
好了,基础就是先布局,布3d场景,HT在提供方法方面算是非常细致的了,平时我们生成网格可能就要花费一段时间,又是基础代码,新手开发人员都能很快上手呢~短短几行代码就能创建一个3d场景,简直太快。。。
dm = new ht.DataModel(); g3d = new ht.graph3d.Graph3dView(dm); g3d.setGridVisible(true);//设置网格可视 g3d.setGridSize(m);//设置网格大小 g3d.setGridGap(w);//设置网格间距 g3d.setEye([-200, 150, 200]);//设置camera位置 g3d.getView().className = 'main'; document.body.appendChild(g3d.getView());
由于HT默认将所有组件都设置了style“position:absolute”,所以当我们初始化这个组件之后,一定要在style中写上位置,并且将这个组件添加进你想要添加进的标签中,这个例子中,form表单、2d组件和3d组件都互不依附,所以我们直接将这三个都添加进body中即可,还有一点值得注意的,所有HT组件的最根层都是一个div,是通过组件的getView()函数获得的。所以我们如果要添加进HTML标签中,肯定也要是HTML标签才行。
然后再界面的右上角放上form表单,放到右上角就直接设置style中的“top”“bottom”“left”“right”即可,2d图同理:
formPane = new ht.widget.FormPane(); formPane.setLabelAlign('right'); formPane.getView().className = 'formpane'; document.body.appendChild(formPane.getView()); formPane.addRow(['Rotation:', { id: 'rotation', slider: { min: -180, max: 180, value: 0, step: 1, onValueChanged: function(e){ node.setRotation(this.getValue() * Math.PI / 180); } } }], [60, 0.1]);
因为这个例子的form表单中的行数和内容比较多,所以我这边就只取了一个form表单自定义行的例子。这边的“id”只是为了能快速查找到这个元素,slider是HT form表单自定义的一个方法,滑动条功能,设置了该属性后HT将根据属性值自动构建ht.widger.Slider对象,具体参数可以参考HT for Web表单手册。
至于左下角的2d俯视图,这是通过跟3d共享同一个datamodel数据模型,只要我们绘制好了图形,然后添加进datamodel中去,不管是什么组件,只要调用了这个datamodel的都可以拥有datamodel中的所有数据:
g2d = new ht.graph.GraphView(dm); g2d.getView().className = 'g2d'; g2d.setEditable(true); document.body.appendChild(g2d.getView()); ht.Default.callLater(g2d.fitContent, g2d, [true, 50, true]);
ht.Default.callLater(func, scope, args, delay)获取全局下一个编号,其中 func指的是回调函数,scope指的是函数域,args指的是函数参数列表,delay则是延迟时间(毫秒)。这个函数可以在页面打开时回调g2d.fitContent函数,然后作用域仅在g2d中,这个函数参数列表是fitContent(anim, padding, notZoomIn)函数的参数,这三个参数分别代表“是否使用动画”,“缩放后图元区域与拓扑边缘的距离”,以及“是否将最小缩放值限定为1”。
接着将3d中的图元添加进去,这里我不截取全部代码,只取一个比较特别的有趣的图元,中间外层的透明图元:
shape = new ht.Shape(); shape.s({ 'all.reverse.cull': true, 'all.color': 'rgba(0, 255, 0, 0.5)', 'all.transparent': true }); shape.setThickness(2); dm.add(shape); var resetShape = function() { var cs = node.getCorners(10, 10); cs.push(cs[0]); shape.setPoints(cs); g3d.setBoundaries(ht.Default.toBoundaries(cs)); }; resetShape();
这边比较有趣的有几点:
1. 这边用了node.getCorners()这个方法,这个是获取四个点,对于2d来说就是左上、右上、右下、左下四个点;对于3d来说就是直接获取底面的四个“左上、右上、右下、左下”点,这个我反应了好一会儿才反应过来。。。并以这四个点为基础作为shape的points。
2. 这边还用了setBoundaries(boundaries)函数,借用ht.Default.toBoundaries函数来将不符合setBoundaries函数参数的格式转换成它需要的参数格式。虽然我认为这一行在这个例子中没有什么作用,但是还是让我好好学习了一把碰撞测试。
我们在碰撞测试的时候经常要设置g3d.setNear函数,我实在没搞懂这个函数是拿来干嘛的,结果这个例子让我注意到,如果“我”的视线的近端截面位置也就是setNear(1),那么我能看到的就是比表面跟进1的距离,这个函数默认设置为10,就算我们不设置这个值我们也能在3d中看到图元的内部去,刚刚我们介绍的getCorners()函数,其实它还有两个参数xpadding和ypadding,分别代表“水平方向padding”“垂直方向padding”,也就是说,在我们获取四个角的同时,我们还能设置这四个角和边之间的padding。只要将这个值设置得比setNear设置的大,我们就不会看到3d图元的内部中去了。
我们还注意到似乎是“废代码”的一行: cs.push(cs[0])。这个完全不是废代码啊,帮了很大忙呢!在HT中,用ht.Shape创建的图元,只要你不手动设置绘制关闭,那么就会停留在你最终绘制的位置,所以我把最后的一个点又和第一个点连起来,那么就是一个封闭的图形了,否则你会看到后面缺了一部分,像这样:
我在其他文章中也提到过HT封装了一些很方便的方法和事件,比如datamodel#md,监听数据的属性的变化,这边我们用了md方法来判断只有中间这个node能够绕着一个点旋转,具体参考HT for Web数据模型手册:
dm.md(function(e){ if(e.data === node){ if(e.property === 'rotation'){ formPane.v('rotation', 180 / Math.PI * e.newValue); } resetShape(); } });
这边我想要说一下“绕着一个点旋转”的功能,这边没有用我们自定义的anchor锚点,但是功能类似,通过获取我form表单上选择的“left、right、front、back”来设置旋转中心点,HT中form表单通过getValue(id)简写成v(id)根据id获取对应item元素值:
formPane.addRow([ { button: { label: 'Animate', onClicked: function(){ var dx = 0, dy = 0, range = formPane.v('range') * Math.PI / 180; if(formPane.v('left')){ dx = -node.getWidth()/2; } if(formPane.v('right')){ dx = node.getWidth()/2; } if(formPane.v('back')){ dy = -node.getHeight()/2; } if(formPane.v('front')){ dy = node.getHeight()/2; } animate(node, range, dx, dy); } } }, { button: { label: 'Reset', onClicked: function(){ node.setRotation(0); } } } ], [0.1, 0.1]);
看到这边你还是没懂?快去我们官网上从beginners重头开始学习吧!