SphereViewer.js
Displays photo spheres created with Ricoh Theta or Google Photosphere app on mobile and desktop browsers.
Features
- customizable through config
- image preloading for slower connection
- displays spinner while loading images
- can hide the triopod by displaying custom logo at the sphere bottom
- can display user instructions (PNG image)
- configurable
- supports vanilla JavaScript and AMD
- supports UV mapping customization
Live Demo
Live demo is available on CodePen.io http://codepen.io/knee-cola/pen/vxQYNL
Documentation
There is none ... you can figure it out from example provided below and live example at CodePen
Installation
NPM installation
To install it via NPM run:
npm i -D --save-dev sphere-viewer
Old school linking from HTML
If you use the Vanilla JavaScript, link the lib in from HTML like this (the code bellow includes links to dependencies):
<script src="//code.jquery.com/jquery-3.2.1.slim.js"></script>
<script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/three.js/84/three.min.js"></script>
<script type="text/javascript" src="//cdn.rawgit.com/knee-cola/SphereViewer/13f4e3aa/dist/sphereViewer.min.js"></script>
If you want to store files localy on yout server, you can download the minified file from GitHub repository.
Dependencies
SphereViewer was build with:
Usage example
var config = {
logo:'img/logo.png',
hint: isMobile ? 'img/sphere-icon-mobile.png' : 'img/sphere-icon-desktop.png',
control: {
autoRotate: true
},
spinner: {
groupRadius: 20
},
};
var picUrls = ['img/sphere/preloader.jpg', 'img/sphere/hd.jpg']
var viewer = new SphereViewer.Viewer(picUrls, controlConfig);
viewer.addEventListener('close', function() { console.log('sphere closed'); });
License
SphereViewer is licensed under the MIT License.