Collection Element (Deep Zoom File Format Schema)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

The root element when defining a collection of images for Deep Zoom.

<Collection 
  MaxLevel="max pyramid level"
  TileSize="size of tiles"
  Format="file format"
  Quality="0|1" >
  <Items> ... </Items>
</Collection>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute

Description

MaxLevel

Required unsignedByte attribute.

The maximum pyramid level the tiles are stored at. This must be less than or equal to log2(TileSize) — typically equal to this value or one less.

TileSize

Required unsignedLong attribute.

The size of the tiles. Note they have to be square. This is true for both images and collections. However, for collections, the TileSize also has to be a power of 2 (e.g., 128, 256, 512, etc.).

Format

Required string attribute.

This defines the file format of the tiles.

NoteNote:
Deep Zoom image pyramids only support the image files supported by the BitmapImage class.

Quality

Optional float attribute with a default value of 1.

Used when creating thumbnail tiles, from 0 to 1. 1 is highest quality, 0 is lowest. Generally this value should be 0.8 or higher; however, for Deep Zoom this does not matter because collections are read-only.

NextItemId

Required unsignedLong attribute.

Gets the count of items in the collection; however for Deep Zoom this does not matter because collections are read-only

Child Elements

Element

Description

Items

Contains the items in the collection.

Parent Elements

None.

Remarks

If you are defining a collection, this element is the root element.

minOccurs="1"

maxOccurs="1"

Element Information

Namespace

Empty

Schema name

Deep Zoom Schema

Validation file

deepzoom.xsd

Can be empty

No