H5实例教学--3D全景(ThreeJs全景Demo)

时间 2019-11-05

标签 h5 实例教学 3d 全景 threejs demo 繁體版

原文原文链接

前言

在如今市面上不少全景H5的环境下，要实现全景的方式有不少，能够用css3直接构建也能够用基于threeJs的库来实现，还有不少别的制做全景的软件使用
本教学适用于未开发过3D全景的工程狮css

若是以为内容太无聊能够直接跳到最后html

下载代码css3

理论

整个3D全景所用的相关理论就很少说了，就稍微讲一下本案例用到的相关理论canvas

相信程序猿们会更加关注代码实现的内容app

此次讲解的demo是用css3DRender来构建一个正方体的全景场景dom

想象一下，咱们须要作的就是构建一个正方体的盒子ide

而后把镜头放在如下这个正方体盒子里函数

每一个面都贴上咱们场景的一个面，那么当镜头转动时看到的就是置身其中的全景
post

详细理论的东西之后再说，此次先跑起来一个简单的demo吧this

demo解析

本教学用到两个库：
threeJS和基于它的CSS3DRender.js

代码是从官网上样例上扒下来作了一点调整。

<!DOCTYPE html>
<html>
<head>
    <title>three.js css3d - panorama</title>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
    <style>
        body {
            background-color: #000000;
            margin: 0;
            cursor: move;
            overflow: hidden;
        }
        .surface { width: 1026px; height: 1026px; background-size: cover; position: absolute; }
        .surface .bg { position: absolute; width: 1026px; height: 1026px; }
    </style>
</head>
<body>
<div>
    <div id="surface_0" class="surface">
        <img class="bg" src="images/posx.jpg" alt="">
    </div>
    <div id="surface_1" class="surface">
        <img class="bg" src="images/negx.jpg" alt="">
    </div>
    <div id="surface_2" class="surface">
        <img class="bg" src="images/posy.jpg" alt="">
    </div>
    <div id="surface_3" class="surface">
        <img class="bg" src="images/negy.jpg" alt="">
    </div>
    <div id="surface_4" class="surface">
        <img class="bg" src="images/posz.jpg" alt="">
    </div>
    <div id="surface_5" class="surface">
        <img class="bg" src="images/negz.jpg" alt="">
    </div>
</div>
<script src="js/three.min.js"></script>
<script src="js/CSS3DRenderer.min.js"></script>
<script src="js/index.js"></script>
</body>
</html>

html这边没什么特别的，首先把每一个面放进去，用div把每一个面的图片放进去。

没有用官网demo的实现方式是由于官网是create一个img插入到页面，咱们在对每一个面添加元素的时候不太方便

先把六个面定义好，若是要在每一个面上加入一些交互的元素，直接在html上添加dom就能够了

一共就引入了3个js，除了index另外两个都是压缩过的js，不用关心，看一下index.js的实现

camera = new THREE.PerspectiveCamera( 75, window.innerWidth / window.innerHeight, 1, 1000 );

scene = new THREE.Scene();

那么很明显这两行代码，字面上的意思就是建立了一个相机，建立了一个场景。

那这里稍微解释一下这两个类

PerspectiveCamera

如下是官网的解释

大概意思：
这是一个模仿人眼的投影模式，它是用于渲染3D场景最多见的投影模式。
总之这个类就是new一个镜头
下面是样例代码

这个类的构造函数接受四个参数

那么这四个参数具体是什么东西？

图片来源：https://isux.tencent.com/3d.html

分别表示的
镜头夹角，宽高比，最近焦距，最远焦距

Scene

接下来，用Scene类建立场景
如下官方说明

这东西建立了一个场景，这个场景容许你对某个东西某个位置经过threeJs渲染场景

建立了场景和相机，咱们须要往场景里面放入以前说的正方体

首先定义好六个面的数据，每一个面的位置，3D旋转的旋转角度。

position三个参数分别对应的x,y,z轴的位置
由于我选的面宽度是1024px
因此位置是基于中心点的正负1024/2

rotation的三个参数分贝对应xyz轴的旋转角度
Math.PI/2表明90度

var sides = [
    {
        position: [ -512, 0, 0 ],//位置
        rotation: [ 0, Math.PI / 2, 0 ]//角度
    },
    {
        position: [ 512, 0, 0 ],
        rotation: [ 0, -Math.PI / 2, 0 ]
    },
    {
        position: [ 0,  512, 0 ],
        rotation: [ Math.PI / 2, 0, Math.PI ]
    },
    {
        position: [ 0, -512, 0 ],
        rotation: [ - Math.PI / 2, 0, Math.PI ]
    },
    {
        position: [ 0, 0,  512 ],
        rotation: [ 0, Math.PI, 0 ]
    },
    {
        position: [ 0, 0, -512 ],
        rotation: [ 0, 0, 0 ]
    }
];

/**
 * 根据六个面的信息，new出六个对象放入场景中
 */
for ( var i = 0; i < sides.length; i ++ ) {

    var side = sides[ i ];

    var element = document.getElementById("surface_"+i);
    element.width = 1026; // 2 pixels extra to close the gap.多余的2像素用于闭合正方体

    var object = new THREE.CSS3DObject( element );
    object.position.fromArray( side.position );
    object.rotation.fromArray( side.rotation );
    scene.add( object );

}

CSS3DObject

那么这里有一个新出现的类CSS3DObject
不过这个类不属于官方类，而是咱们引用的3DRender库里的类

没有文档咱们看一下代码

THREE.CSS3DObject = function (element) {
    THREE.Object3D.call(this);
    this.element = element;
    this.element.style.position = 'absolute';
    this.addEventListener('removed', function (event) {
        if (this.element.parentNode !== null) {
            this.element.parentNode.removeChild(this.element);
            for (var i = 0, l = this.children.length; i < l; i++) {
                this.children[i].dispatchEvent(event)
            }
        }
    })
}
;
THREE.CSS3DObject.prototype = Object.create(THREE.Object3D.prototype);

能够看出这是一个继承于THREE.Object3D的类
将传入的element的postion改成绝对定位，而后加了个被移除时的事件。
没有定义什么别的特别的东西，那么咱们查一下官方Object3D的类

Object3D

这个类就是一个定义对象的基本类，其中new的对象包含如下两个属性

.position

The object's local position.

.rotation

Object's local rotation (see Euler angles), in radians.

分别表示对象的位置和旋转角度。
那么for循环就是定义六个对象加入场景中
好，咱们继续

renderer = new THREE.CSS3DRenderer();
renderer.setSize( window.innerWidth, window.innerHeight );
document.body.appendChild( renderer.domElement );

CSS3DRenderer

这是咱们引用的库里的类
这个类的主要功能是根据three中的场景和镜头的相关信息
使用dom元素和css3D的属性来渲染出来

在这里只是new了这个类和设置了宽高
可是CSS3DRender在这里尚未开始渲染页面

document.addEventListener( 'mousedown', onDocumentMouseDown, false );
document.addEventListener( 'wheel', onDocumentMouseWheel, false );

document.addEventListener( 'touchstart', onDocumentTouchStart, false );
document.addEventListener( 'touchmove', onDocumentTouchMove, false );

window.addEventListener( 'resize', onWindowResize, false );

这里的事件绑定就不详细说了
接下来解析一下渲染时的代码

animate();

function animate() {

    requestAnimationFrame( animate );

    // lat +=  0.1;
    lat = Math.max( - 85, Math.min( 85, lat ) );
    phi = THREE.Math.degToRad( 90 - lat );
    theta = THREE.Math.degToRad( lon );

    target.x = Math.sin( phi ) * Math.cos( theta );
    target.y = Math.cos( phi );
    target.z = Math.sin( phi ) * Math.sin( theta );

    camera.lookAt( target );
    /**
     * 经过传入的scene和camera
     * 获取其中object在建立时候传入的element信息
     * 以及后面定义的包括位置，角度等信息
     * 根据场景中的obj建立dom元素
     * 插入render自己本身建立的场景div中
     * 达到渲染场景的效果
     */
    renderer.render( scene, camera );

}

requestAnimationFrame( animate );
这个方法能够根据帧速率触发animate方法。

lat = Math.max( - 85, Math.min( 85, lat ) );
    phi = THREE.Math.degToRad( 90 - lat );
    theta = THREE.Math.degToRad( lon );

    target.x = Math.sin( phi ) * Math.cos( theta );
    target.y = Math.cos( phi );
    target.z = Math.sin( phi ) * Math.sin( theta );

    camera.lookAt( target );

这段代码根据现成的（经过手指滑动或鼠标滑动实时更新的）属性值，调整camera镜头的位置

renderer.render( scene, camera );

而后渲染........
由于render里面的代码比较多，这里就不贴代码了，大概总结一下render作的事情就是
首先render本身建立一个做为场景的div

经过传入的scene和camera

获取其中object在建立时候传入的element信息
以及后面定义的包括位置，角度等信息

根据场景中的obj建立dom元素（就是经过dom实现本应在canvas里的东西）

插入render自己本身建立的场景div中

当镜头方向变了，获取到的参数就变了，经过传入的对象身上带有的变化的参数改变页面上dom元素的位置。

达到渲染场景的效果

代码下载

连接: http://pan.baidu.com/s/1eR2Rlb8 密码: sdyt