From 0c4f11a603a780231c12d5cdc8f8b6cf135b70fd Mon Sep 17 00:00:00 2001 From: David Miguel Susano Pinto Date: Mon, 14 Mar 2022 17:01:03 +0000 Subject: [PATCH] doc: document "keep" for JPEG save quality option. --- docs/handbook/image-file-formats.rst | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst index 17808dbc4..d5a898150 100644 --- a/docs/handbook/image-file-formats.rst +++ b/docs/handbook/image-file-formats.rst @@ -364,10 +364,13 @@ The :py:meth:`~PIL.Image.open` method may set the following The :py:meth:`~PIL.Image.Image.save` method supports the following options: **quality** - The image quality, on a scale from 0 (worst) to 95 (best). The default is - 75. Values above 95 should be avoided; 100 disables portions of the JPEG - compression algorithm, and results in large files with hardly any gain in - image quality. + + The image quality, on a scale from 0 (worst) to 95 (best), or the string + `"keep"`. The default is 75. Values above 95 should be avoided; 100 disables + portions of the JPEG compression algorithm, and results in large files with + hardly any gain in image quality. The value `"keep"` is only valid for JPEG + files and will retain the original image quality level, subsampling, and + quantization tables. **optimize** If present and true, indicates that the encoder should make an extra pass