Du kan inte välja fler än 25 ämnen Ämnen måste starta med en bokstav eller siffra, kan innehålla bindestreck ('-') och vara max 35 tecken långa.

readme.md 3.1 KiB

12 år sedan
12 år sedan
10 år sedan
10 år sedan
12 år sedan
12 år sedan
10 år sedan
12 år sedan
12 år sedan
10 år sedan
12 år sedan
10 år sedan
12 år sedan
12 år sedan
12 år sedan
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960
  1. # Pannellum
  2. ## About
  3. 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 13kB gzipped, and then embedded into pages as an `<iframe>`. A configuration utility is included to generate the required code for embedding.
  4. ## How to use
  5. 1. Upload `build/pannellum.htm` and a full equirectangular panorama to a web server.
  6. * 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.
  7. 2. Use the included multi-resolution generator (`utils/multires/generate.py`) or configuration tool (`utils/config/configuration.htm`).
  8. 3. Insert the generated `<iframe>` code into a page.
  9. ### Using `generate.py` to create multires panoramas
  10. To be able to create multiresolution panoramas, you need to have the `nona` program installed, which is available as part of [Hugin](http://hugin.sourceforge.net/), as well as Python with the [Pillow](https://pillow.readthedocs.org/) package. Then, run
  11. ```
  12. python generate.py pano_image.jpg
  13. ```
  14. 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`.
  15. ## Examples
  16. Examples using both the minified version and the version in the `src` directory are included in the `examples` directory.
  17. ## Browser Compatibility
  18. Since Pannellum is built with emerging web standards, it requires a modern browser to function.
  19. #### Full support (with appropriate graphics drivers):
  20. * Firefox 10+
  21. * Chrome 15+
  22. * Safari 8+
  23. * Internet Explorer 11+
  24. #### Almost full support (no full screen):
  25. * Firefox 4+
  26. * Chrome 9+
  27. #### Partial support (WebGL support must first be enabled in preferences)
  28. * Safari 5.1+
  29. #### No support:
  30. Internet Explorer 10 and previous
  31. ## Building
  32. 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.
  33. ## License
  34. Pannellum is distributed under the MIT License. For more information, read the file `COPYING` or peruse the license [online](https://github.com/mpetroff/pannellum/blob/master/COPYING).
  35. In the past, parts of Pannellum were based on [three.js](https://github.com/mrdoob/three.js) r40, which is licensed under the [MIT License](https://github.com/mrdoob/three.js/blob/44a8652c37e576d51a7edd97b0f99f00784c3db7/LICENSE).
  36. The panoramic image provided with the examples is licensed under the [Creative Commons Attribution-ShareAlike 3.0 Unported License](http://creativecommons.org/licenses/by-sa/3.0/).
  37. ## Credits
  38. * [Matthew Petroff](http://mpetroff.net/), Original Author
  39. * [three.js](https://github.com/mrdoob/three.js) r40, Former Underlying Framework