Adapters

Adapters are small pieces of code responsible to load the panorama texture(s) in the Three.js scene.

The supported adapters are:

• equirectangular: the default adapter, used to load full or partial equirectangular panoramas
• equirectangular tiles: used to load tiled equirectangular panoramas
• equirectangular video: used to load equirectangular videos
• cubemap: used to load cubemaps projections (six textures)
• cubemap tiles: used to load tiled cubemap panoramas
• cubemap video: used to load cubemap video

Import an adapter

Official adapters are available in the the main photo-sphere-viewer package inside the dist/adapters directory.

Example for the Cubemap adapter:

<!-- base imports of PSV and dependencies -->

<script src="https://cdn.jsdelivr.net/npm/photo-sphere-viewer@4/dist/adapters/cubemap.min.js"></script>

new PhotoSphereViewer.Viewer({
  adapter: [PhotoSphereViewer.CubemapAdapter, {
    // optional adapter config
  }],
  panorama: // specific to the adapter,
});

import { CubemapAdapter } from 'photo-sphere-viewer/dist/adapters/cubemap';

new Viewer({
  adapter: [CubemapAdapter, {
    // optional adapter config
  }],
  panorama: // specific to the adapter,
});