Panoramic Images

Last update: May 3, 2023

CREATED FOR:

  • User
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

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.

panoramic-image2

Uploading assets for use with the Panoramic Image viewer

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:

    /conf/global/settings/cloudconfigs/dmscene7/jcr:content

  • Tagged with the keywords equirectangular, or sphericaland 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 component.

To upload assets for use with the Panoramic Image viewer, see Uploading Assets.

Configuring Dynamic Media Classic

For the Panoramic Image viewer to work properly within AEM, you must synchronize the Panoramic Image viewer presets with Dynamic Media Classic and Dynamic Media Classic–specific metadata so the viewer presets get updated in the JCR. To accomplish this, configure Dynamic Media Classic in the following manner:

  1. Sign in to your Dynamic Media Classic desktop application for each company account.

  2. Near the upper-right corner of the page, click Setup > Application Setup > Publish Setup > Image Server.

  3. On the Image Server Publish page, from the Publish Context drop-down menu near the top, select Image Serving.

  4. On the same Image Server Publish page, locate the heading Request Attributes.

  5. 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 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.

    NOTE
    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.

  6. Under the [Request Attributes] heading, do the following:

    • Set Request Obfuscation Mode to Disabled.
    • Set Request Locking Mode to Disabled.

    These settings are necessary for using the Panoramic Media component in AEM.

  7. At the bottom of the Image Server Publish page, on the left side, tap Save.

  8. In the lower-right corner, tap Close.