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.
,;:{}()
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.
*basicSwatchSet**swatchItem**[',' *swatchItem*]*swatchItem**imageId*[';' *swatch*]*swatch**swatchId`**imageId**swatchId**solidColorSpecifier*'{0x' *rrggbb* [ *label*]'}'*rrggbb**label*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).
*hierarchicalSwatchSet**hierarchicalSwatchItem* *[ ',' *hierarchicalSwatchItem* ]*hierarchicalSwatchItem**swatchItem`**basicSwatchSetId*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.
*2dSpinItem**2dSpinSet* *2dSpinItem* *[ ',' *2dSpinItem* ]*2dSpinItem**imageId`**basicSpinSetId*Page Sets
Each item in a page set can consist of up to three-page images separated with colons.
*pageSet**pageItem* *[ , *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.
*mediaSet**item* *[ , *item* ]*item*{ *videoItem`**videoItem**video* ; *swatchId**recutItem**recut* ; *swatchId**imageItem**imageId* ; [ *swatchId* ]*setItem*{ *setId`**ID**swatchId**video**recut**imageId**setId**inlineSet**reserved*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
None.
See Also section-4c99c44f99074aa0a4ed90ba183bbc25
req=imageset , attribute::RootPath, Object Id Translation , Text String Localization , Image Serving Viewers Documentation