This section describes working with the Panoramic Image viewer to render spherical panoramic images for an immersive 360° viewing experience of a room, property, location, or landscape.
See also Managing Viewer Presets.
For an uploaded asset to qualify as a spherical panorama image that you intend to use with the Panoramic Image viewer, the asset must have either one or both of the following:
- An aspect ratio of 2.
You can override the default aspect ratio setting of 2 in CRXDE Lite at the following:
- Tagged with the keywords equirectangular, or spherical and panorama, or spherical and panoramic. See Using Tags.
Both the aspect ratio and keyword criteria apply to panoramic assets for the asset details page and the "Panoramic Media" WCM component.
To upload assets for use with the Panoramic Image viewer, see Uploading Assets.
For the Panoramic Image viewer to work properly within AEM, you must synchronize the Panoramic Image viewer presets with Dynamic Media Classic (Scene7) and Dynamic Media Classic (Scene7)-specific metadata so the viewer presets get updated in the JCR. To accomplish this, configure Dynamic Media Classic (Scene7) in the following manner:
Under the Request Attributes heading, locate Reply Image Size Limit. Then, in the associated Width and Height fields, increase the maximum allowable image size for panoramic images.
Dynamic Media Classic (Scene7) has a limit of 25,000,000 pixels. The maximum allowable size for images with a 2:1 aspect ratio is 7000 x 3500. However, for typical desktop screens, 4096 x 2048 pixels is sufficient.
Only images that fall within the maximum allowable image size are supported. Requests for images that are above the size limit will result in a 403 response.
If you dropped an image into the Panoramic Media component in your WCM and the component placeholder collapsed, you may want to troubleshoot the following:
- If you experience a 403 Forbidden error, it may have been caused by the requested image size being too large. Review the Reply Image Size Limit settings in Configuring Dynamic Media Classic (Scene7).
- For an "Invalid lock" on the asset or "Parsing error" displayed on the page, check Request Obfuscation Mode and Request Locking Mode to ensure they are disabled.
- For a tainted canvas error, setup a Rule Set Definition File Path and Invalidate CTN for the previous requests for the image asset.
- If image quality becomes very low after an image request with sizing above the supported limit, check that the JPEG Encoding Attributes > Quality setting is not empty. A typical setting for the Quality field is 95. You can find the setting on the Image Server Publish page. To access the page, see Configuring Dynamic Media Classic (Scene7).
See Previewing Assets.
See Publishing Assets.