浏览器中实现3D全景浏览

Posted 2020-08-09

如果你用过网页版的百度地图，你大概3D全景图浏览是一种怎样的酷炫体验：在一个点可以360度环顾周围的建筑、景色，当然也可以四周移动，就像身临其境。

科普

全景图共分为三种：

①球面全景图

   利用一张全景图围成一个球，自身位置位于球体内。由于图片是矩形，所以最上和最下的缝合处很明显就能够看得出来。

   球面全景图是最接近人眼的构建模式，若利用多个立面构建，拼接方法繁琐，性能消耗高。

   因此，本文介绍的是上述通过一张全景图构成的球面全景图。

②立方体全景图

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

③柱状全景图

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

   

准备

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

①支持WebGL和canvas的浏览器

②Three.js

   这里就不介绍这个插件了，所以阅读本文需要Three.js简单的基础 O(∩_∩)O~

   下载地址：https://github.com/mrdoob/three.js

③photo-sphere-viewer.js

   这是基于Three.js开发的柱状全景图插件

   下载地址：https://github.com/JeremyHeleine/Photo-Sphere-Viewer

④全景图

  像上图那样的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）全景图容器的最终尺寸，例如{width: 500, height: 300}。

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

方法介绍

addAction()

fitToContainer()

getPosition()

getPositionInDegrees()

getZoomLevel()

load()

moveTo()

rotate()

toggleAutorotate()

toggleDeviceOrientation()

toggleFullscreen()

toggleStereo()

zoom()

zoomIn()

zoomOut()