# 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:

- When executing grouped there is only one file so the distinction is irrelevant.
- When executing stepwise and you are saving to a named variable, the results reflect all files.
- When executing stepwise and you are saving to a track variable, the per file setting determines the results stored.

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.