photoshere.js: Projected Spherical Image

Displays a rotating projection of a spherical image.

How to include the script

The stylesheet is best included in the header of the document.

<link rel="stylesheet" href="css/photosphere.css"/>

This include can be added to the header or placed inline before the script is invoked.

<script src="lib/three.js"></script>
<script src="lib/CanvasRenderer.js"></script>
<script src="lib/Projector.js"></script>
<script src="js/photosphere.js"></script>

Or use Require.js.

requirejs([
	"lib/three.js"
], function(Three) {
	window.THREE = Three;
	requirejs([
		"js/photosphere.js",
		"lib/CanvasRenderer.js",
		"lib/Projector.js"
	], function(Photosphere) {
		...
	});
});

Note that the three.js library has to be imported in two stages to avoid order of execution concflicts.

Or import into an MVC framework.

var Three = require('lib/three.js');
var CanvasRenderer = require('lib/CanvasRenderer.js');
var Projector = require('lib/Projector.js');
var ImageFallback = require('js/photosphere.js');

How to start the script

new PhotoSphere({
	// target elements
	'elements': document.querySelectorAll('#photosphere a'),
	// restrict the popup to a container
	'container' : document.body,
	// optional webservice for acquiring sized images
	'slicer' : 'php/imageslice.php?src={src}&{size}',
	// rotation speed when idle
	'idle': 0.002
});

'elements' : {array} - A collection of target elements.

'container' : {element} - Restrict the popup to a container.

'slicer' : {string} - Optional web-service for resizing images. An example is provided as ./php/imageslice.php.

idle : {float} - The steps in radians to rotate when idle.

How to build the script

This project uses three.js from https://threejs.org/

This project uses node.js from http://nodejs.org/

This project uses gulp.js from http://gulpjs.com/

The following commands are available for development:

• npm install - Installs the prerequisites.
• gulp import - Re-imports libraries from supporting projects to ./src/libs/ if available under the same folder tree.
• gulp dev - Builds the project for development purposes.
• gulp dist - Builds the project for deployment purposes.
• gulp watch - Continuously recompiles updated files during development sessions.
• gulp serve - Serves the project on a temporary web server at http://localhost:8500/.
• gulp php - Serves the project on a temporary php server at http://localhost:8500/.

License

This work is licensed under a MIT License. The latest version of this and other scripts by the same author can be found on Github and at WoollyMittens.nl.