Documentation Dynamic Media Viewers Reference Guide

ZoomView.enableHD

Last update: January 27, 2022

Topics:
Dynamic Media Classic,Viewers,SDK/API,Spin Sets

CREATED FOR:

Developer
User

[ZoomView.|<containerId>_zoomView.]enableHD=always|never|limit[, *number*]

always|never|limit

Enable, limit, or disable optimization for devices where devicePixelRatio is greater than 1, that is devices with high-density display like iPhone4 and similar devices. If active then the component limits the size of the IS image request as if the device only had a pixel ratio of 1 and that way reducing the bandwidth.

See example below.

number

If using the limit setting, the component enables high pixel density only up to the specified limit.

See example below.

Properties

Optional.

Default

limit,1500

Example

The following are the expected results when you use this configuration attribute with the viewer, and the viewer size is 1000 x 1000:

If the set variable equals	Result
always	The pixel density of the screen/device is always accounted for. If the screen pixel density = 1, then the requested image is 1000 x 1000. If the screen pixel density = 1.5, then the requested image is 1500 x 1500. If the screen pixel density = 2, then the requested image is 2000 x 2000.
never	It always uses a pixel density of 1 and ignores the device's HD capability. Therefore, the requested image requested is always 1000 x 1000.
limit<number>	A device pixel density is requested and served only if the resulting image is below the specified limit. The limit number applies to either the width or the height dimension. If the limit number is 1600, and the pixel density is 1.5, then the 1500 x 1500 image is served. If the limit number is 1600, and the pixel density is 2, then the 1000 x 1000 image is served because the 2000 x 2000 image exceeds the limit. Best practice: The limit number must work with the company setting for maximum size image. Therefore, set the limit number to equal the company maximum image size setting.

If the set variable equals

Result

always

The pixel density of the screen/device is always accounted for.

If the screen pixel density = 1, then the requested image is 1000 x 1000.
If the screen pixel density = 1.5, then the requested image is 1500 x 1500.
If the screen pixel density = 2, then the requested image is 2000 x 2000.

never

It always uses a pixel density of 1 and ignores the device's HD capability. Therefore, the requested image requested is always 1000 x 1000.

limit<number>

A device pixel density is requested and served only if the resulting image is below the specified limit.

The limit number applies to either the width or the height dimension.

If the limit number is 1600, and the pixel density is 1.5, then the 1500 x 1500 image is served.
If the limit number is 1600, and the pixel density is 2, then the 1000 x 1000 image is served because the 2000 x 2000 image exceeds the limit.

Best practice: The limit number must work with the company setting for maximum size image. Therefore, set the limit number to equal the company maximum image size setting.

recommendation-more-help