淘先锋技术网

首页 1 2 3 4 5 6 7

Photo Sphere Viewer  一款基于 three.js 的简易3D插件,方便,实用,友好,看到网上有些API有错误,所以自己写一个修正版的

该js插件可以360度旋转查看全景图,也可以上下180度查看图片。使用该插件的唯一要求是浏览器支持canvas或WebGL。

https://github.com/JeremyHeleine/Photo-Sphere-Viewer

DEMO:http://www.html5cn.org/article-8621-1.html

使用该全景图插件时要引入three.min.js和photo-sphere-viewer.min.js文件。

  1. <script src="js/three.min.js"></script>
  2. <script src="js/photo-sphere-viewer.min.js"></script>        
复制代码

 

HTML结构

可以创建一个空的<div> 来放置全景图,通过CSS来设置它的尺寸。

  1. <div id="container"></div>        
复制代码

初始化插件

要初始化该全景图插件,可以创建一个新的PhotoSphereViewer对象,然后在这个对象中插入一个参数对象,有两个参数是必须设置的:

  1. var PSV = new PhotoSphereViewer({
  2.     // 图片路径
  3.     panorama: 'images/photo.jpg',
  4.     // 容器
  5.     container: div
  6. });      
复制代码

配置参数

下面是该全景图插件的所有可用配置参数: 

  • panorama:必填参数,全景图的路径。
  • container:必填参数,放置全景图的div元素。
  • autoload:可选,默认值为true,true为自动调用全景图,false为在后面加载全景图(通过.load()方法)。
  • us empdata:可选,默认值为true,如果Photo Sphere Viewer必须读入XMP数据则为true。
  • default_position:可选,默认值为{},定义默认的位置,及用户看见的第一个点,例如:{long: Math.PI, lat: Math.PI/2}。
  • min_fov:可选,默认值为30,观察的最小区域,单位degrees,在1-179之间。
  • max_fov:可选,默认值为90,观察的最大区域,单位degrees,在1-179之间。
  • allow_user_interactions:可选,默认值为true,设置为false则禁止用户和全景图交互(导航条不可用)。
  • tilt_up_max:可选,默认值为Math.PI/2,向上倾斜的最大角度,单位radians。
  • tilt_down_max:可选,默认值为Math.PI/2,向下倾斜的最大角度,单位radians。
  • zoom_level:可选,默认值为0,默认的缩放级别,值在0-100之间。
  • long_offset:可选,默认值为 Math.PI/360,mouse/touch移动时每像素经过的经度值。
  • lat_offset:可选,默认值为 Math.PI/180,mouse/touch移动时每像素经过的纬度值。
  • time_anim:可选,默认值为2000,全景图在time_anim毫秒后会自动进行动画。(设置为false禁用它)
  • theta_offset:过时的选项,可选,默认值为1440,自动动画时水平方向的速度。
  • anim_speed:可选,默认值为2rpm,动画的速度,每秒/分钟多少radians/degrees/revolutions。
  • navbar:可选值,默认为false。显示导航条。
  • navbar_style:可选值,默认为{}。导航条的自定义样式。下面是可用的样式列表:
  • backgroundColor:导航条的背景颜色,默认值为rgba(61, 61, 61, 0.5)。
  • buttonsColor:按钮的前景颜色,默认值为transparent。
  • activeButtonsBackgroundColor:按钮激活状态的背景颜色,默认值为rgba(255, 255, 255, 0.1)。
  • buttonsHeight:按钮的高度,单位像素,默认值为20。
  • autorotateThickness:autorotate图标的厚度,单位像素,默认值为1。
  • zoomRangeWidth:缩放的范围,单位显示,默认值50。
  • zoomRangeThickness:缩放的范围的厚度,单位像素,默认值1。
  • zoomRangeDisk:缩放范围的圆盘直径,单位像素,默认值为7。
  • fullscreenRatio:全屏图标的比例,默认值为3/4。
  • fullscreenThickness:全屏图标的厚度,单位像素,默认值为2。
  • loading_msg:可选,默认值为Loading…,图片加载时的提示文字。
  • loading_img:可选,默认值为null,在加载时显示的图片的路径。
  • size:可选,默认值null,全景图容器的最终尺寸。例如:{width: 500, height: 300}。
  • onready:可选值,默认值为null。当全景图准备就绪并且第一张图片显示时的回调函数。
  • 科普

    全景图共分为三种:

    1 球面全景图

    利用一张全景图围成一个球,自身位置位于球体内。由于图片是矩形,所以最上和最下的缝合处很明显就能够看得出来。
    
    球面全景图是最接近人眼的构建模式,若利用多个立面构建,拼接方法繁琐,性能消耗高。
    
    因此,本文介绍的是上述通过一张全景图构成的球面全景图。
    

    2 立方体全景图

    一个立方体,有六个面组成,所以就需要六张图片啦。自身的位置位于立方体中间。这也是最常见的全景图构建模式。
    

    3 柱状全景图

    这个则是前两种构建模式的结合版啦。
    

    准备

    在浏览器中实现3D全景浏览开发,首先需要几样东西:

    1 支持WebGL和canvas的浏览器

    2 Three.js

     这里就不介绍这个插件了,所以阅读本文需要Three.js简单的基础 O(∩_∩)O~
    
    下载地址:<https://github.com/mrdoob/three.js>
    
    

    3 photo-sphere-viewer.js

    这是基于Three.js开发的柱状全景图插件
    
    下载地址:<https://github.com/JeremyHeleine/Photo-Sphere-Viewer>
    
    

    4 全景图

     开始

    现在开始上代码啦!!!

    html部分:

    需要一个标签元素做为全景图的容器,并引入所需的两个插件。

    js部分:

    初始化插件,创建一个photosphereviewer对象。

    其中,前两个选项panorama和container是必须的,其他都为可选项。

    然后,3D全景效果就这样实现啦,简单吧。

    那接下来就介绍一下配置参数及方法吧。

    配置参数介绍

    panorama:(必选)全景图的路径。

    container:(必选)放置全景图的容器。

    autoload:(默认为true)true为自动加载全景图,false为迟点加载全景图(通.过load方法)。

    usexmpdata:(默认值为true)photo sphere viewer是否必须读入xmp数据,false为不必须。

    cors_anonymous:(默认值为true)true为不能通过cookies获得用户

    pano_size:(默认值为null)全景图的大小,是否裁切。

    default_position:(默认值为0)定义默认位置,用户看见的第一个点,例如:{long: math.pi, lat: math.pi/2}。

    min_fov:(默认值为30)观察的最小区域,单位degrees,在1-179之间。

    max_fov:(默认值为90)观察的最大区域,单位degrees,在1-179之间。

    allow_user_interactions:(默认值为true)设置为false,则禁止用户和全景图交互(导航条不可用)。

    allow_scroll_to_zoom:(默认值为true)若设置为false,则用户不能通过鼠标滚动进行缩放图片。

    tilt_up_max:(默认值为math.pi/2)向上倾斜的最大角度,单位radians。

    tilt_down_max:(默认值为math.pi/2)向下倾斜的最大角度,单位radians。

    min_longitude:(默认值为0)能够展示的最小经度。

    max_longitude:(默认值为2PI)能够展示的最大维度。

    zoome_level:(默认值为0)默认的缩放级别,值在0-100之间。

    long_offset:(默认值为PI/360)mouse/touch移动时每像素经过的经度值。

    lat_offset:(默认值为pi/180)mouse/touch移动时每像素经过的纬度值。

    time_anim(默认值为2000)全景图在time_anim毫秒后会自动进行动画。(设置为false禁用它)

    reverse_anim:(默认值为true)当水平方向到达最大/最小的经度时,动画方向是否反转(仅仅是不能看到完整的圆)。

    anim_speed:(默认值为2rpm)动画每秒/分钟多少的速度。

    vertical_anim_speed:(默认值为2rpm)垂直方向的动画每秒/分钟多少的速度。

    vertical_anim_target:(默认值为0)当自动旋转时的维度,默认为赤道。

    navbar:(默认为false)显示导航条。

    navbar_style:(默认值为false)导航条的样式。有效的属性:

    loading_msg:(默认值为Loading...)加载信息。

    loading_img:(默认值 为null)loading图片的路径。

    loading_html:(默认值 为null)html加载器(添加到容器中的元素或字符串)。

    size:(默认值为null)全景图容器的最终尺寸,例如{width: 500, height: 300}。

    onready:(默认值为null)全景图准备好并且第一张图片展示出来后的回调函数。

    方法介绍

    addAction():添加事件(插件没有提供执行事件的方法,似乎是提供给插件内部使用的)。

    fitToContainer():调整全景图容器大小为指定大小。

    getPosition():获取坐标经纬度。

    getPositionInDegrees():获取经纬度度数。

    getZoomLevel():获取缩放级别。

    load():加载全景图()。

    moveTo(longitude, latitude):根据经纬度移动到某一点。

    rotate(dlong, dlat):根据经纬度度数移动到某一点。

    toggleAutorotate():是否开启全景图自动旋转。

    toggleDeviceOrientation():是否开启重力感应方向控制。

    toggleFullscreen():是否开启全景图全屏。

    toggleStereo():是否开启立体效果(可用于WebVR哦)。

    zoom(level):设置缩放级别。

    zoomIn():放大。

    zoomOut():缩小。