heuzef
/
pannellum
mirror of https://github.com/mpetroff/pannellum.git
1
0
Fork 0
Code Issues 0 Releases 22 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
259 Commits
2 Branches
1.8 GiB
 
 
 
 
 
 
Tree: bb3b6bd1e3
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'bb3b6bd1e3'
${ noResults }
 ZIP  TAR.GZ
Matthew Petroff bb3b6bd1e3 Bump copyright year. 10 years ago
doc Add preliminary equirectangular video support (no controls). 10 years ago
examples Made multires CSS 3D fallback optional. 10 years ago
src Bump copyright year. 10 years ago
utils Bump copyright year. 10 years ago
.gitignore Added .gitignore. 10 years ago
COPYING Bump copyright year. 10 years ago
VERSION Bump version number for development version. 10 years ago
changelog.md Updated changelog for 2.0.1. 10 years ago
readme.md Update readme. 10 years ago

readme.md

Pannellum

About

Pannellum is a lightweight, free, and open source panorama viewer for the web. Built using HTML5, CSS3, JavaScript, and WebGL, it is plug-in free. It can be deployed easily as a single file, just 11kB gzipped, and then embedded into pages as an <iframe>. A configuration utility is included to generate the required code for embedding.

How to use

  1. Upload build/pannellum.htm and a full equirectangular panorama to a web server.
    • Due to browser security restrictions, a web server must be used locally as well. With Python 2, one can use python -m SimpleHTTPServer, and with Python 3, one can use python -m http.server, but any other web server will work as well.
  2. Use the included multi-resolution generator (utils/multires/generate.py) or configuration tool (utils/config/configuration.htm).
  3. Insert the generated <iframe> code into a page.

Examples

Examples using both the minified version and the version in the src directory are included in the examples directory.

Browser Compatibility

Since Pannellum is built with emerging web standards, it requires a modern browser to function.

Full support (with appropriate graphics drivers):

  • Firefox 10+
  • Chrome 15+
  • Safari 5.1+ (WebGL support must first be enabled in preferences)
  • Internet Explorer 11+

Almost full support (no full screen):

  • Firefox 4+
  • Chrome 9+
  • Opera 12+ (WebGL support must first be enabled in preferences)

No support:

Internet Explorer 10 and previous

Building

The utils folder contains the required build tools, with the exception of Python 3.2+ and Java installations. To build a minified version of Pannellum, run either build.sh or build.bat depending on your platform.

License

Pannellum is distributed under the MIT License. For more information, read the file COPYING or peruse the license online.

In the past, parts of Pannellum were based on three.js r40, which is licensed under the MIT License.

The panoramic image provided with the examples is licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported License.

Credits