Application icon

Artwork Information

This function is used to extract information about the artwork in one or more files. The information is saved to a track variable field or a named variable. If a named variable is specified, it may contain any of the escape sequences described in Escape Sequences.

The functions return results for a single file or for all files. The determination is made as follows:

The following information can be extracted:

Artwork Count
When the mode is for a single file, the number of artwork items in each track will be returned. When the mode is for all files, the number of unique artwork items across all files will be returned. Note that the number of unique artwork items is not the same as the number of leading common artwork items used by Indexed Artwork when determining the validity of an index. To get the number of leading common artwork items do a Multi Item Field List Enumerator of the artwork items and then a Count Items of the produced list.

Default width x height
When the mode is for a single file, the width x height of each track's default (first) artwork item will be returned. If there are no artwork items, 0 x 0 will be returned. When the mode is for all files, if all files share a common default artwork item, its width x height will be returned. If there are no artwork items or there is no common default artwork item, 0 x 0 will be returned.

Smallest width x height
When the mode is for a single file, the width x height of each track's smallest artwork item will be returned. If there are no artwork items, 0 x 0 will be returned. Smallest is defined as the artwork item with the smallest width * height value. When the mode is for all files, the value returned represents width x height of the smallest artwork item across all files.

Largestest width x height
When the mode is for a single file, the width x height of each track's largest artwork item will be returned. If there are no artwork items, 0 x 0 will be returned. Largest is defined as the artwork item with the largest width * height value. When the mode is for all files, the value returned represents the width x height of the largest artwork item across all files.

Default Pixel Count
When the mode is for a single file, the pixel count (width * height) of each track's default (first) artwork item will be returned. If there are no artwork items, 0 will be returned. When the mode is for all files, if all files share a common default artwork item, its pixel count will be returned. If there are no artwork items or there is no common default artwork item, 0 will be returned.

Smallest Pixel Count
When the mode is for a single file, the pixel count (width * height) of each track's smallest artwork item will be returned. If there are no artwork items, 0 will be returned. Smallest is defined as the artwork item with the smallest width * height value. When the mode is for all files, the value returned represents the pixel count of the smallest artwork item across all files.

Largest Pixel Count
When the mode is for a single file, the pixel count (width * height) of each track's largest artwork item will be returned. If there are no artwork items, 0 will be returned. Largest is defined as the artwork item with the largest width * height value. When the mode is for all files, the value returned represents the pixel count of the largest artwork item across all files.

Default Size
When the mode is for a single file, the size in bytes of each track's default (first) artwork item will be returned. If there are no artwork items, 0 will be returned. When the mode is for all files, if all files share a common default artwork item, its size will be returned. If there are no artwork items or there is no common default artwork item, 0 will be returned.

Smallest Size
When the mode is for a single file, the size in bytes of each track's smallest artwork item will be returned. If there are no artwork items, 0 will be returned. Smallest is defined as the artwork item with the smallest number of bytes in the artwork data. When the mode is for all files, the value returned represents the size of the smallest artwork item across all files.

Largest Size
When the mode is for a single file, the size in bytes of each track's largest artwork item will be returned. If there are no artwork items, 0 will be returned. Largest is defined as the artwork item with the largest number of bytes in the artwork data. When the mode is for all files, the value returned represents the size of the largest artwork item across all files.

Default Resolution
When the mode is for a single file, the resolution (PPI) of each track's default (first) artwork item will be returned. If there are no artwork items, 0 will be returned. When the mode is for all files, if all files share a common default artwork item, its resolution will be returned. If there are no artwork items or there is no common default artwork item, 0 will be returned.

Smallest Resolution
When the mode is for a single file, each track's smallest resolution (PPI) will be returned. If there are no artwork items, 0 will be returned. When the mode is for all files, the value returned represents the size of the smallest resolution (PPI) across all files.

Largest Resolution
When the mode is for a single file, each track's largest resolution (PPI) will be returned. If there are no artwork items, 0 will be returned. When the mode is for all files, the value returned represents the size of the largest resolution (PPI) across all files.