|
| 1 | +.. MusicBrainz Picard Documentation Project |
| 2 | +
|
| 3 | +:index:`Cover Art Processing <pair: configuration; cover art>` |
| 4 | +=============================================================== |
| 5 | + |
| 6 | +.. image:: images/options-cover-processing.png |
| 7 | + :width: 100 % |
| 8 | + |
| 9 | +Picard can filter and process the images downloaded from the providers. Image processing can differentiate between images |
| 10 | +embedded into tags and images saved as a separate file. More filters and processors can be added by `plugins |
| 11 | +<https://picard.musicbrainz.org/plugins/>`_. |
| 12 | + |
| 13 | +**Discard images if below the given size** |
| 14 | + |
| 15 | + This filter will discard any image with its width or its height lower than the given values. With some providers, |
| 16 | + like the Cover Art Archive, the image is discarded before it is downloaded. |
| 17 | + |
| 18 | +**Resize images to the given size** |
| 19 | + |
| 20 | + Images can be scaled to the given dimensions. You can also choose whether to allow images to increase in size, though |
| 21 | + at a loss of image quality. There are a few options as to how images are resized: |
| 22 | + |
| 23 | + * **Maintain aspect ratio**: Scale the source image so that it fits within the target dimensions. One of the final |
| 24 | + image dimensions may be less than the target dimension if the source image and target dimensions have different aspect |
| 25 | + ratios. |
| 26 | + |
| 27 | + * **Scale to width**: Scale the width of the source image to the target width while keeping aspect ratio. |
| 28 | + |
| 29 | + * **Scale to height**: Scale the height of the source image to the target height while keeping aspect ratio. |
| 30 | + |
| 31 | + * **Crop to fit**: Scale the source image so that it completely fills the target dimensions in both directions. |
| 32 | + If the source image and target dimensions have different aspect ratios, then there will be overflow in one direction which |
| 33 | + will be (center) cropped. |
| 34 | + |
| 35 | + * **Stretch to fit**: Stretch the image to exactly fit the specified dimensions, distorting it if necessary. |
| 36 | + |
| 37 | +**Convert images to the given format** |
| 38 | + |
| 39 | + Images can be converted to the given format. The available formats are JPEG, PNG, WebP, and TIFF. |
| 40 | + |
0 commit comments