Skip to content

Document "keep" for JPEG save quality option #6135

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hugovk merged 3 commits into from
Mar 31, 2022
Merged

Document "keep" for JPEG save quality option #6135

Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
0c4f11a
doc: document "keep" for JPEG save quality option.
carandraug Mar 14, 2022
1acc32d
Updated syntax
radarhere Mar 22, 2022
55852d5
Use consistent term
radarhere Mar 26, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 6 additions & 4 deletions docs/handbook/image-file-formats.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -364,10 +364,12 @@ 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
Expand Down