ImageSet imageset

Image set data. Provides a mechanism to define sorted sets of images and control attributes used by the Dynamic Media viewers.

An image set consists of a sorted, comma-separated list of items. Each item consists of one or more subitems (image ids, swatch ids, media file paths, labels, and so on), separated by semi-colons, or colons, or both.

Curly braces { } and parentheses ( ) may be used to delimit certain content (such as color values) or indicate nested sets. Braces or parentheses used this way must not be encoded and must always appear as matched pairs, otherwise a catalog parsing error occurs.

The following characters are used as set delimiters and must be HTTP-encoded when they appear in the set as part of id or string values:
  • ,
  • ;
  • :
  • {
  • }
  • (
  • )

Refer to the Image Serving Viewers documentation for additional details regarding the structure and use of image sets.

The server returns the contents of this field without modification in response to a req=imageset request.

Standard Sets section-5ecc8ffee7224668b63f601383665564

The following set definitions are natively supported by Image Serving, and access with certain viewers involves server-side parsing, validation, and processing of the set. Each set type can be identified by specifying the corresponding value in catalog::AssetType.

Basic Swatch Sets

Each item in a basic swatch set consists of a reference to an image record and an optional separate reference to an image record used as a swatch.

*swatchItem**[',' *swatchItem*]
*imageId*[';' *swatch*]
IS image reference (catalog/id)
IS image reference (catalog/id)
'{0x' *rrggbb* [ *label*]'}'
Packed 6-digit hex RGB color value for solid color swatches
Optional text label for solid color swatches

Hierarchical Swatch Sets

Each item in a hierarchical swatch set can consist of a basic swatch item or a reference to a swatch set record (swatches are required for such items).

*hierarchicalSwatchItem* *[ ',' *hierarchicalSwatchItem* ]
IS reference (catalog/id) to a catalog record defining a basic swatch set

Basic Spin Sets

A basic spin set consists of a simple list of image IDs.

basicSpinSet imageId *[ ';' imageId ]

Two-Dimensional Spin Sets

Each item in a two-dimensional spin set can consist of a simple image, a reference to a basic spin set, or an in-line basic spin set delimited by curly braces. Parentheses may be used instead of curly braces.

*2dSpinSet* *2dSpinItem* *[ ',' *2dSpinItem* ]
IS reference (catalog/id) to a catalog record defining a basic spin set

Page Sets

Each item in a page set can consist of up to three-page images separated with colons.

*pageItem* *[ , *pageItem* ]
*imageId* [ : *imageId* [ : *imageId* ] ]

Media Sets

Each item in a media set can consist of an image, basic swatch set, hierarchical swatch set, basic spin set, two-dimensional spin set, page set, or video asset. Each media set item can also contain an optional swatch and type identifier.

*item* *[ , *item* ]
{ *videoItem`*
*video* ; *swatchId*
*recut* ; *swatchId*
*imageId* ; [ *swatchId* ]
{ *setId`*
`media type identifier [ img
IS image id
Video/animation file path or static catalog id
Recut definition XML file path or static catalog id
IS image id
IS reference to image, spin, or ecatalog set
Inlined image, spin, or ecatalog set
Reserved for future use

Video Sets

A video set consists of a simple list of video ids where each id references an entry in the static content catalog.

videoSet videoId *[ , videoId ]

Properties section-17c731e5c46646aa90ac21f39bb693ca

Text string. Comma-separated list of catalog::Id values, absolute Image Server file paths, or file paths relative to attribute::RootPath. The same image may be referenced more than once in the set. The defining catalog record may appear in the set at any location.

This field participates in text string localization. In addition to label strings (part of the solidColorSpecifier) all delimited fields are localized if they include at least one ’ ^loc=…^’ localization token. Refer to Text String Localization in the HTTP Protocol Reference for details.

Default section-c3a60e360393478284f0f2d2da5b963b


See Also section-4c99c44f99074aa0a4ed90ba183bbc25

req=imageset , attribute::RootPath, Object Id Translation , Text String Localization , Image Serving Viewers Documentation