Application icon

Load Artwork Viewer

This statement is used to load an image file or artwork contained in an audio file into the Artwork Viewer. It can also load the artwork contained at a specific index in a loaded audio file.

The supplied file path may contain any of the escape sequences described in Escape Sequences. The escaped path must be absolute.

If the path field contains an integer, it must be a valid index into the current list of artwork items. When running stepwise, the first file is used. See the Indexed Artwork statement for additional information on artwork indexes.

If the path field does not contain an integer and it is empty or does not start with a / character, the artwork viewer will be closed. Otherwise it is treated as the path to the file containing the artwork.

Errors are silently ignored.

The statement is only run once regardless of the execution mode.