This repo contains the OpenWanderer JavaScript API. The core API is present, in addition to various add-ons.
This is in the core
directory, here
At present, the following classes exist:
OpenWanderer.Viewer
- a viewer class. A thin wrapper around the PhotoSphereViewer.Viewer
class from photo-sphere-viewer
. Allows addition of markers and polylines using WGS84 lat/lon and elevation in metres. These are internally converted to spherical coordinates.
OpenWanderer.Navigator
- a class allowing navigation from one pano to the next. Designed to be modular; not specifically coupled to one navigation system (e.g. pano sequences or OSM-based navigation). See comments in the class for more detail.
Please see the relevant packages for build instructions:
At present two add-ons are available, the transitions
API containing transitions developed by Eesger Toering, and the openwanderer-app
API, which allows you to create a complete OpenWanderer application widget featuring navigation, panorama and map mode, login, upload and ability to move and rotate panoramas.
These produce a nice transition effect when moving from one pano to another. Note that currently there are some artefacts if point markers (representing pano locations) are present on your panorama, though polylines (representing the route of a sequence) are OK.
See the transitions
directory, here
Again, include with unpkg. You also need jQuery but this is now bundled with the transitions API.
See the owapp
directory, here
Examples can be found in the examples
directory within core
. Currently there are two basic demos, one showing usage of OpenWanderer.Viewer
and the other showing usage of OpenWanderer.Navigator
. These are now accompanied by a walkthrough guide.