This statement is designed to get around an issue in the Music and TV applications where album artwork is not refreshed when files are saved. To be more exact, per track artwork is updated but the artwork displayed for an album or when playing tracks is not.
This function will work as expected if all tracks in an album have the same first artwork item or no artwork. Only linked tracks are processed.
You can elect to modify all linked tracks or only those where the default artwork item has been modified. In this case modified means the image has changed. Changes to an artwork item's picture type or description are not relevant.
PLEASE READ!
While avoiding one bug another is encountered. For linked selected tracks, the function causes all artwork items except the first to be removed in Music/TV! After calling this funtion the selected tracks will display zero or one artwork item in Music/TV. The artwork stored in the tracks as displayed in Yate will not be modified.
While not required the function works with iTunes as well. When used with iTunes the above discussed side effect does not occur.
If errors occur they will be placed in the Action Error Text named variable.
While this statement is valid for all execution modes it is far more efficient when run stepwise.