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.