Matthew Petroff 35b21e84a5 | 6 年前 | |
---|---|---|
doc | 6 年前 | |
examples | 8 年前 | |
src | 6 年前 | |
utils | 6 年前 | |
.gitignore | 6 年前 | |
.npmignore | 8 年前 | |
COPYING | 6 年前 | |
VERSION | 6 年前 | |
changelog.md | 6 年前 | |
package.json | 6 年前 | |
readme.md | 6 年前 |
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 15kB gzipped, and then embedded into pages as an <iframe>
. A configuration utility is included to generate the required code for embedding.
build/pannellum.htm
and a full equirectangular panorama to a web server.
python -m SimpleHTTPServer
, and with Python 3, one can use python -m http.server
, but any other web server will work as well.utils/multires/generate.py
) or configuration tool (utils/config/configuration.htm
).<iframe>
code into a page.generate.py
to create multires panoramasTo be able to create multiresolution panoramas, you need to have the nona
program installed, which is available as part of Hugin, as well as Python with the Pillow package. Then, run
python generate.py pano_image.jpg
in the utils/multires
directory. This will generate all the image tiles and the config.json
file in the ./output
folder by default. For this to work, nona
needs to be on the system path; otherwise, the location of nona
can be specified using the -n
flag, e.g. python generate.py -n /path/to/nona pano_image.jpg
.
Examples using both the minified version and the version in the src
directory are included in the examples
directory.
Since Pannellum is built with recent web standards, it requires a modern browser to function.
Internet Explorer 10 and previous
Mobile / app frameworks are not officially supported. They may work, but they’re not tested and are not the targeted platform.
All user-facing strings can be changed using the strings
configuration parameter. There exists a third-party respository of user-contributed translations that can be used with this configuration option.
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.
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.