This function is used to search for artwork from Discogs.
The function is different from other artwork functions as it is based on Discogs Ids. Note that both Discogs releases and masters are searched.
If Discogs Release Ids are not available, but MusicBrainz Release Ids are, Yate will attempt to acquire the Discogs Release Ids ids from MusicBrainz. If Discogs Master Ids are not available, Yate will attempt to extract them from Discogs.
You specify which artwork types you'd like to import. Discogs artwork types are tagged as Primary (album cover) or Secondary. You specify which types of Discogs artwork you would like to import.
It seems as if some Discogs artwork lists are improperly tagged. To handle this case the following special semantics apply: If you only want to download Primary images and a list of artwork items does not have a Primary image, the first image is downloaded. If you only want to download Secondary images and a list of artwork items does not have a Primary image, the first image is not downloaded.
With the exception of error reporting, the function is silent. Testing the artwork count before and after execution is the only means of determining if anything was imported.
While this function is available in grouped execution mode, it is far more efficient when run stepwise. At all costs avoid doing individual applications of this function on tracks while grouped. When running stepwise no individual external access will be made more than once.
When the function completes, it will Normalize the artwork for the following artwork types: Cover (front), Other, Cover (back) and Media (CD label). Further if the resulting default image is of type Other, it will be changed to Cover (front).
When run in the batch processor, this statement is always silent. Otherwise, by default, a number of errors will be displayed in the UI. This can be useful for debugging purposes. The display of the errors can be suppressed by setting named variable Suppress Error Display to true or a non zero integer value.
If an error occurred, the description will be in named variable Action Error Text.