DocumentationDynamic Media Image Serving and Rendering API

imageprops

Last update: July 12, 2021
  • Topics:
  • Dynamic Media Classic,SDK/API

CREATED FOR:

  • Developer
  • User

Source image properties. Returns selected properties of the image file or catalog entry specified in the URL path.

req=imageprops[,text|javascript|xml|{json[&id= *reqId*]}]

reqIdUnique request identifier.

The HTTP response is cacheable with the TTL based on attribute::NonImgExpiration.

Other commands in the request string are ignored.

Requests that support JSONP response format lets you specify the name of the JS callback handler using the extended syntax of req= parameter:

req=...,json [&handler = reqHandler ]

<reqHandler> is the name of the JS handler that is present in the JSONP response. Only a-z, A-Z, and 0-9 characters are allowed. Optional. Default is s7jsonResponse.

The following properties are returned:

PropertyTypeDescription
image.anchorint,intcatalog::Anchor or the default anchor point
image.expirationdoublecatalog::Expiration or the default time to live
image.heightintegerFull resolution image height in pixels
image.iccProfilestringName/description of the profile associated with this image
image. embeddedIccProfileboolean1 if the associated profile is embedded in the image
image.embedded PhotoshopPathsboolean1 if the image includes Photoshop path data
image. embeddedXmpDataboolean1 if the image includes XMP data
image.maskenum0 for no mask, 1 for premultiplied alpha, 2 for non-premultiplied alpha, and 3 for a separate mask image
image.modifierstringcatalog::Modifier or empty if not a catalog entry
image. photoshopPathNamesstringComma-separated list of the names of all Photoshop paths associated with this image
image.pixTypstringImage type, may be 'CMYK', 'RGB' or 'BW' (for gray-scale images)
image.postModifierstringattribute::PostModifier or empty if not a catalog entry
image.printResrealdefault print resolution in pixels/inch
image.resolutionrealcatalog::Resolution or the default object resolution
image.timeStampstringModification date/time (from catalog::TimeStamp or the image file)
image.thumbResrealcatalog::ThumbRes or the default thumbnail resolution
image.thumbTypeenumcatalog::ThumbType or the default thumbnail type
image.widthintegerFull resolution image width in pixels
image.translatedIdstringCatalog ID to which the object specified in the path is resolved (see Object Id Translation).
recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49