diff --git a/docs/changelog.rst b/docs/changelog.rst index b16593f1d..7ef19871b 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -6,7 +6,7 @@ Changelog New features: -* :doc:`plugins/fetchart`: and :doc:`plugins/embedart`: Added a new ``quality`` +* :doc:`plugins/fetchart` and :doc:`plugins/embedart`: Added a new ``quality`` option that controls the quality of the image output when the image is resized. * :doc:`plugins/keyfinder`: Added support for `keyfinder-cli`_ diff --git a/docs/plugins/embedart.rst b/docs/plugins/embedart.rst index ece5e0350..defd3fa4b 100644 --- a/docs/plugins/embedart.rst +++ b/docs/plugins/embedart.rst @@ -58,13 +58,12 @@ file. The available options are: the aspect ratio is preserved. See also :ref:`image-resizing` for further caveats about image resizing. Default: 0 (disabled). -- **quality**: The quality level to use when encoding the image file when - downscaling to ``maxwidth``. Can be a number from 1-100 or 0 to disable. - Higher numbers result in better image quality while lower numbers will result - in smaller files. 65-75 is a good starting point. The default behaviour - depends on the method used to scale the images. ImageMagick tries to estimate - the input image quality and uses 92 if it cannot be determined. Pillow - defaults to 75. +- **quality**: The JPEG quality level to use when compressing images (when + ``maxwidth`` is set). This should be either a number from 1 to 100 or 0 to + use the default quality. 65–75 is usually a good starting point. The default + behavior depends on the imaging tool used for scaling: ImageMagick tries to + estimate the input image quality and uses 92 if it cannot be determined, and + PIL defaults to 75. Default: 0 (disabled) - **remove_art_file**: Automatically remove the album art file for the album after it has been embedded. This option is best used alongside the diff --git a/docs/plugins/fetchart.rst b/docs/plugins/fetchart.rst index 8c5d0eb7b..4441d4e30 100644 --- a/docs/plugins/fetchart.rst +++ b/docs/plugins/fetchart.rst @@ -42,10 +42,12 @@ file. The available options are: - **maxwidth**: A maximum image width to downscale fetched images if they are too big. The resize operation reduces image width to at most ``maxwidth`` pixels. The height is recomputed so that the aspect ratio is preserved. -- **quality**: The quality level to use when encoding the image file when - downscaling to ``maxwidth``. Can be a number from 1-100 or 0 to disable. - Higher numbers result in better image quality while lower numbers will result - in smaller files. 65-75 is a good starting point. +- **quality**: The JPEG quality level to use when compressing images (when + ``maxwidth`` is set). This should be either a number from 1 to 100 or 0 to + use the default quality. 65–75 is usually a good starting point. The default + behavior depends on the imaging tool used for scaling: ImageMagick tries to + estimate the input image quality and uses 92 if it cannot be determined, and + PIL defaults to 75. Default: 0 (disabled) - **enforce_ratio**: Only images with a width:height ratio of 1:1 are considered as valid album art candidates if set to ``yes``.