## Import Artwork

This function is used to import artwork from the file system.

You can specify the folder to be used as the source for the artwork. If the folder field is empty, a track's containing folder is assumed. The folder string is evaluated for every file being manipulated and may contain any of the escape sequences described in Escape Sequences. The resultant path may be absolute (/), relative to the Home folder (~/) or relative to the track's containing folder (./). Any path which does not exist or is invalid is ignored.

The picture type to be associated with the loaded artwork items must be specified. The description associated with an artwork item on a per track basis is taken from the description field which may contain any of the escape sequences described in Escape Sequences. Note: if Preferences-Artwork-Extract image type from file names is enabled, the specfied picture type will only be assigned if an image type is not extracted from the file name.

Note that artwork loaded by this function is not scaled. If you wish to scale the artwork make a subsequent call to a Scale Artwork / Change Type function.

When All Files is selected, an attempt is made to load every file with a jpg, jpeg and png filename extension from the specified or implied folder.

When Single File is specified and File is a pattern is not selected, you are looking for a particular file on a per track basic. The associated text must contain the name (including filename extension) that you are looking for. The file may specify any OS X image file. The field may contain any of the escape sequences described in Escape Sequences. When in this mode you can elect to search subfolders until the desired file is found. Note that the matching is always case insensitive.

When Single File and File is a pattern is selected, you are looking for a particular file, on a per track basis, matching a pattern. The specified file is treated as the pattern followed by a filename extension. For example image.jpg will match any file with a .jpg extension where the name of the file contains image. The field may contain any of the escape sequences described in Escape Sequences. When in this mode you can elect to search subfolders until the desired file is found. Note that the matching is always case insensitive.

As the field containing a filename or pattern can contain escape sequences, each track can be looking for a different image file. For example an specification of \[Album].jpg will look for a jpg file with the same name as the album if File is a pattern is not specified. If File is a pattern is selected, a jpg file whose name contains the album name will be matched.

While the function is valid for Grouped execution, it is far more efficient when executed stepwise where no artwork item will be processed more than once.