Photo Sphere Viewer 全景图

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，全景图容器的最终尺寸。例如：{ 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 全景图

  

  像上图那样的360度全景图，最好是左右能够完美拼接的，这样环顾时才自然。
  
  现在也有能够生成全景图的工具，这里就不介绍啦。
  
  全景图素材站点：<http://www.tupian114.com/tupian/quanjing.html>
  

  　开始

  现在开始上代码啦！！！

  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）导航条的样式。有效的属性：

                    backgroundColor：导航条背景色（默认值rgba(61, 61, 61, 0.5)）；
  
                    buttonsColor：按钮前景色（默认值 rgba(255, 255, 255, 0.7)）；
  
                    buttonBackgroundColor：按钮激活时的背景色（默认值 rgba(255, 255, 255, 0.1)）；
  
                    buttonsHeight：按钮高度，单位px（默认值 20）；
  
                    autorotateThickness：自动旋转图片的层（默认值 1）；
  
                    zoomRangeWidth：缩放游标的宽度，单位px（默认值 50）；
  
                    zoomRangeThickness：缩放游标的层（默认值 1）；
  
                    zoomRangeDisk：缩放游标的放大率，单位px（默认值 7）；
  
                    fullscreenRatio：全屏图标的比例（默认值 4/3）；
  
                    fullscreenThickneee：全屏图片的层，单位px（默认值 2）
  

  loading_msg：（默认值为Loading...）加载信息。

  loading_img：（默认值 为null）loading图片的路径。

  loading_html：（默认值 为null）html加载器（添加到容器中的元素或字符串）。

  size：（默认值为null）全景图容器的最终尺寸，例如{ 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()：缩小。