This function is used to extract information about the artwork in one or more files. The information is saved to a 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 following information can be extracted:
- Artwork Count
- When executing groupwise, the number of artwork items in the current track will be returned. When executing stepwise, the number of unique artwork items will be returned
- Default artwork width x height
- When executing groupwise, the width x height of the default (first) artwork item will be returned. If there are no artwork items, 0 x 0 will be returned. When executing stepwise, 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 artwork width x height
- The width x height of the 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.
- Largestest artwork width x height
- The width x height of the 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.
- Default artwork pixel count
- When executing groupwise, the pixel count (width*height) of the default (first) artwork item will be returned. If there are no artwork items, 0 will be returned. When executing stepwise, 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 artwork pixel count
- The pixel count (width*height) of the 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.
- Largest artwork pixel count
- The pixel count (width*height) of the 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.