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.
88 Commits
2 Branches
220 MiB
 
 
 
 
 
 
Tree: 28826c1006
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '28826c1006'
${ noResults }
 ZIP  TAR.GZ
Matthew Petroff 28826c1006 Added basic hot spot support. 12 years ago
artwork-src Switched about box to right click. 12 years ago
build Bumped version number and updated build. 12 years ago
doc Fixed typo in projection documentation. 12 years ago
examples Added preview image example. 12 years ago
src Added basic hot spot support. 12 years ago
utils Changed URLs from Bitbucket to Github. 12 years ago
.hgignore Added .hgignore to repository. 12 years ago
.hgtags Added tag 1.2 for changeset a778d467c181 12 years ago
COPYING Bumped copyright year. 12 years ago
NEWS Changed URLs from Bitbucket to Github. 12 years ago
VERSION Updated version number to development version number. 12 years ago
configuration.htm Replaced Three.js with libpannellum as renderer. Added partial panorama support. 12 years ago
readme.md Replaced Three.js with libpannellum as renderer. Added partial panorama support. 12 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 18kB 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.
  2. Use the included configuration tool (configuration.htm).
    • Pannellum Location is the address of pannellum.htm and can be either a full or relative path (relative to the page containing the <iframe>).
    • Panorama URL is the address of the panorama image file and can be either a full or relative path (relative to pannellum.htm).
    • Basic Information is optional. If provided, it is displayed in the bottom left corner.
    • Embed Size is the dimensions of the <iframe>.
    • Include Pannellum Logo includes the Pannellum logo in the upper right corner with a link to the project’s website.
    • Auto Load loads the panorama when the page is loaded. If left unchecked, the user must click to load the panorama.
    • Selecting a Creative Commons License inserts a banner for the appropriate license next to the author’s name.
    • Generate creates the embed code that can then be copied wherever desired.
  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)

Almost full support (no full screen):

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

No support:

Internet Explorer (all versions)

Building

The utils folder contains the required build tools, with the exception of Python 2.x 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