Application icon

Indexed Artwork

The Artwork Information function provides the ability to perform various operations on artwork items in a position independent manner. This function provides access to various functionality on a single artwork item at a specified index. Note that the indexes are zero based. Index zero represents the default artwork item in any file.

All text fields may contain any of the sequences described in Escape Sequences.

The following functions are currently available:

Set description
Set the artwork item's description field to the specified data.
Set picture type
Set the artwork item's picture type to the specified data. The data must either be one of the well defined picture types or an integer value representing the index of the picture type. If the data is not valid the picture type will be set to Other. A value picker is supplied as a convenience.
Get description
Set the specified variable to the artwork item's description field.
Get index of picture type
Set the destination variable to the index of the artwork item's picture type.
Get picture type
Set the destination variable to the the textual representation of the artwork item's picture type.
Get mime type
Set the destination variable to the artwork item's mime type.
Get width x height
Set the destination variable to the artwork item's dimensions.
Get pixel count
Set the destination variable to the artwork item's pixel count.
Get data size
Set the destination variable to the size of the artwork data in bytes.
Set as Default
The artwork item at the specified index is moved to index 0 and as such becomes the default artwork.

The action test state is set to true if the index is valid, otherwise it is set to false.

When an action is running grouped, an index is valid if it is in the range of zero to the number of artwork items-1.

When an action is running stepwise, an index is only valid if it represents exactly the same artwork item in all files.

The following list describes the supported picture types and their associated indexes.

  1. Other
  2. 32x32 pixels 'file icon' PNG only
  3. Other file icon
  4. Cover (front)
  5. Cover (back)
  6. Leaflet page
  7. Media (CD label)
  8. Lead artist/lead performer/soloist
  9. Artist/performer
  10. Conductor
  11. Band/Orchestra
  12. Composer
  13. Lyricist/text writer
  14. Recording Location
  15. During recording
  16. During performance
  17. Movie/video screen capture
  18. A bright coloured fish
  19. Illustration
  20. Band/artist logotype
  21. Publisher/Studio logotype