Application icon

Crop Artwork

This function provides the ability to crop 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.

The function is typically only useful when known offsets can be acquired for an image.

All text fields may contain any of the sequences described in Escape Sequences. However when running stepwise they are evaluated only once based on the first file. This is due to the fact that only one crop function is performed when run stepwise.

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 action test state is set to true if an artwork item was cropped.

Note that all fields are evaluated only at runtime. Each offset field must resolve to be a positive integer which is the offset to be applied to the respective edge. If the index field, or any offset field is invalid at runtime, no attempt will be made to crop the image. If all four offsets resolve to be 0, no attempt will be made to crop an image. Note also, that the resultant width and height must be no smaller than 32 or no attempt will be made to do the crop function.