插件描述
Photo Sphere Viewer是一款基于Three.js的360X180度全景圖預(yù)覽js插件。該js插件可以360度旋轉(zhuǎn)查看全景圖,也可以上下180度查看圖片瘫寝。使用該插件的唯一要求是瀏覽器支持canvas或WebGL。(demo不再服務(wù)器里面演示的話請使用火狐瀏覽器)
demo下載
鏈接:https://pan.baidu.com/s/1QS-ieA7pqUDosNRhgL26Cw
提取碼:owat
使用方法
使用該全景圖插件時要引入three.min.js和photo-sphere-viewer.min.js文件扮碧。
<script src="js/three.min.js"></script>
<script src="js/photo-sphere-viewer.min.js"></script>
HTML結(jié)構(gòu)
可以創(chuàng)建一個空的<div>來放置全景圖白华,通過CSS來設(shè)置它的尺寸。
<div id="container"></div>
初始化插件
要初始化該全景圖插件椭豫,可以創(chuàng)建一個新的PhotoSphereViewer對象耻瑟,然后在這個對象中插入一個參數(shù)對象,有兩個參數(shù)是必須設(shè)置的:
var PSV = new PhotoSphereViewer({
// Path to the panorama
panorama: '1.jpg',
// Container
container: div
});
配置參數(shù)
下面是該全景圖插件的所有可用配置參數(shù):
panorama:必填參數(shù)赏酥,全景圖的路徑喳整。
container:必填參數(shù),放置全景圖的div元素裸扶。
autoload:可選框都,默認(rèn)值為true,true為自動調(diào)用全景圖呵晨,false為在后面加載全景圖(通過.load()方法)魏保。
usexmpdata:可選,默認(rèn)值為true摸屠,如果Photo Sphere Viewer必須讀入XMP數(shù)據(jù)則為true谓罗。
default_position:可選,默認(rèn)值為{}季二,定義默認(rèn)的位置檩咱,及用戶看見的第一個點,例如:{long: Math.PI, lat: Math.PI/2}胯舷。
min_fov:可選刻蚯,默認(rèn)值為30,觀察的最小區(qū)域桑嘶,單位degrees炊汹,在1-179之間。
max_fov:可選不翩,默認(rèn)值為90兵扬,觀察的最大區(qū)域麻裳,單位degrees,在1-179之間器钟。
allow_user_interactions:可選津坑,默認(rèn)值為true,設(shè)置為false則禁止用戶和全景圖交互(導(dǎo)航條不可用)傲霸。
tilt_up_max:可選疆瑰,默認(rèn)值為Math.PI/2,向上傾斜的最大角度昙啄,單位radians穆役。
tilt_down_max:可選,默認(rèn)值為Math.PI/2梳凛,向下傾斜的最大角度耿币,單位radians。
zoom_level:可選韧拒,默認(rèn)值為0淹接,默認(rèn)的縮放級別,值在0-100之間叛溢。
long_offset:可選塑悼,默認(rèn)值為PI/360,mouse/touch移動時每像素經(jīng)過的經(jīng)度值楷掉。
lat_offset:可選厢蒜,默認(rèn)值為PI/180,mouse/touch移動時每像素經(jīng)過的緯度值烹植。
time_anim:可選斑鸦,默認(rèn)值為2000,全景圖在time_anim毫秒后會自動進(jìn)行動畫刊橘。(設(shè)置為false禁用它)
theta_offset:過時的選項鄙才,可選颂鸿,默認(rèn)值為1440促绵,自動動畫時水平方向的速度。
anim_speed:可選嘴纺,默認(rèn)值為2rpm败晴,動畫的速度,每秒/分鐘多少radians/degrees/revolutions栽渴。
navbar:可選值尖坤,默認(rèn)為false。顯示導(dǎo)航條闲擦。
navbar_style:可選值慢味,默認(rèn)為{}场梆。導(dǎo)航條的自定義樣式。下面是可用的樣式列表:
backgroundColor:導(dǎo)航條的背景顏色纯路,默認(rèn)值為rgba(61, 61, 61, 0.5)或油。
buttonsColor:按鈕的前景顏色,默認(rèn)值為transparent驰唬。
activeButtonsBackgroundColor:按鈕激活狀態(tài)的背景顏色顶岸,默認(rèn)值為rgba(255, 255, 255, 0.1)。
buttonsHeight:按鈕的高度叫编,單位像素辖佣,默認(rèn)值為20。
autorotateThickness:autorotate圖標(biāo)的厚度搓逾,單位像素卷谈,默認(rèn)值為1。
zoomRangeWidth:縮放的范圍霞篡,單位顯示雏搂,默認(rèn)值50。
zoomRangeThickness:縮放的范圍的厚度寇损,單位像素凸郑,默認(rèn)值1。
zoomRangeDisk:縮放范圍的圓盤直徑矛市,單位像素芙沥,默認(rèn)值為7。
fullscreenRatio:全屏圖標(biāo)的比例浊吏,默認(rèn)值為3/4而昨。
fullscreenThickness:全屏圖標(biāo)的厚度,單位像素找田,默認(rèn)值為2歌憨。
loading_msg:可選,默認(rèn)值為Loading…墩衙,圖片加載時的提示文字务嫡。
loading_img:可選,默認(rèn)值為null漆改,在加載時顯示的圖片的路徑心铃。
size:可選,默認(rèn)值null挫剑,全景圖容器的最終尺寸去扣。例如:{width: 500, height: 300}。
onready:可選值樊破,默認(rèn)值為null愉棱。當(dāng)全景圖準(zhǔn)備就緒并且第一張圖片顯示時的回調(diào)函數(shù)唆铐。