Photo Sphere Viewer 是一款基于 Three.js 的 360X180 度全景图预览 js 插件。该 js 插件可以 360 度旋转查看全景图,也可以上下 180 度查看图片。使用该插件的唯一要求是浏览器支持 canvas 或 WebGL。
使用该全景图插件时要引入 three.min.js 和 photo-sphere-viewer.min.js 文件。
<script src="js/three.min.js"></script>
<script src="js/photo-sphere-viewer.min.js"></script>
可以创建一个空的<div>来放置全景图,通过 CSS 来设置它的尺寸。
<div id="container"></div>
要初始化该全景图插件,可以创建一个新的 PhotoSphereViewer 对象,然后在这个对象中插入一个参数对象,有两个参数是必须设置的:
var PSV = new PhotoSphereViewer({
// Path to the panorama
panorama: '1.jpg',
// Container
container: div
});
下面是该全景图插件的所有可用配置参数:
panorama:必填参数,全景图的路径
container:必填参数,放置全景图的 div 元素
autoload:可选,默认值为 true,true 为自动调用全景图,false 为在后面加载全景图(通过.load()方法)
usexmpdata:可选,默认值为 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:可选,默认值为 PI/360,mouse/touch 移动时每像素经过的经度值
lat_offset:可选,默认值为 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。当全景图准备就绪并且第一张图片显示时的回调函数
演示地址 | 下载地址 |
专业提供WordPress主题安装、深度汉化、加速优化等各类网站建设服务,详询在线客服!