Commit Graph

484 Commits

Author SHA1 Message Date
Andrew Murray
d93a5ad70b
Merge pull request #7553 from bgilbert/jpeg-rgb
Add `keep_rgb` option when saving JPEG to prevent conversion of RGB colorspace
2024-01-01 23:55:37 +11:00
Benjamin Gilbert
a72b5963d7 Document JPEG 2000 support for writing YCbCr and reading subsampled color
Read support for subsampled RGB and YCbCr color channels was added in
4f4c3b34f8 and not documented at the time.  Write support for YCbCr
appears to date to 61fb89ec54, the original commit.

Retain the existing language about YCbCr input conversion to RGB, even
though it's not completely correct.  OpenJPEG through 2.5.0 doesn't set
color_space in opj_read_header(), so we end up in our
OPJ_CLRSPC_UNSPECIFIED fallback path, which guesses sRGB if there's no
component subsampling.  This means we currently can't round-trip YCbCr via
JPEG 2000.  The next OpenJPEG release will fix this, so leave the docs as
is.

Also fix typo: .j2p -> .jp2.
2023-12-26 12:52:27 -06:00
Benjamin Gilbert
a5fab5fc0b Fail if chroma subsampling selected when writing RGB JPEG
The user presumably doesn't intend to subsample the green and blue
channels.
2023-12-26 12:37:35 -06:00
Hugo van Kemenade
18907b5f7e
Merge pull request #7568 from radarhere/gif_transparency 2023-12-21 12:58:07 +02:00
Benjamin Gilbert
4b422db243 Add keep_rgb option to prevent RGB -> YCbCr conversion during JPEG write
libjpeg automatically converts RGB to YCbCr by default.  Add a keep_rgb
option to disable libjpeg's automatic conversion of RGB images during
write.
2023-12-13 18:26:35 -06:00
Benjamin Gilbert
dafaa1c512 Document JPEG streamtype option
streamtype=1 is new in 10.2.0; the other values have existed since Git
pre-history.
2023-12-04 06:58:37 -06:00
Andrew Murray
55c5587437 Fill identical pixels with transparency in subsequent frames 2023-11-25 19:16:32 +11:00
Andrew Murray
c855584dac Corrected "optimize" default when saving GIF images 2023-11-25 17:30:09 +11:00
Benjamin Gilbert
e572722479 Allow configuring JPEG restart marker interval on save
libjpeg allows specifying the marker interval either in MCU blocks or in
MCU rows.  Support both, via separate parameters, rather than requiring
callers to do the math.

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
2023-10-31 17:47:25 -05:00
Hugo van Kemenade
ac6eb84704 Add 'pypi' Sphinx role 2023-10-30 08:56:42 +02:00
Andrew Murray
84e148e944 Document that olefile is required for FPX and MIC formats 2023-10-30 09:02:42 +11:00
Andrew Murray
d682c18ded Use "gray" more consistently 2023-10-19 19:12:01 +11:00
Andrew Murray
76049de4ad Fixed typos in tutorial 2023-10-15 22:39:35 +02:00
Andrew Murray
a1ddb4dd27 Describe how to populate mode and size 2023-10-15 16:17:19 +11:00
Hugo van Kemenade
810f5f06c4
Merge branch 'main' into cover 2023-10-13 23:42:06 +02:00
Hugo van Kemenade
0a432541ae
Merge pull request #7392 from radarhere/eps 2023-10-05 09:27:06 -06:00
Andrew Murray
114aadd2ca Added versionadded 2023-10-01 06:13:40 +11:00
Andrew Murray
3caae280b9 Added release notes 2023-09-30 11:32:54 +10:00
Andrew Murray
1c5eab718f Include given size in table 2023-09-29 18:29:45 +10:00
Andrew Murray
40d11fa9ac Added demonstration images to tutorial 2023-09-28 08:27:56 +10:00
Andrew Murray
ffe2076fd6 Shortened property description 2023-09-13 08:03:23 +10:00
Andrew Murray
3ee8009561 Document gs_binary property 2023-09-12 22:22:42 +10:00
Andrew Murray
bfafa460e3 Allow "loop=None" when saving 2023-08-09 10:31:34 +10:00
Hugo van Kemenade
95257dff87
Merge pull request #7299 from radarhere/pdf 2023-08-04 11:43:09 +03:00
Andrew Murray
9979a822c7 Changed Image mode property to be read-only by default 2023-07-29 09:28:18 +10:00
Andrew Murray
0a0a3fc51f Added saving LA images as PDFs 2023-07-22 20:16:45 +10:00
Andrew Murray
064cd6fb83 Added more information about PPM formats 2023-07-22 18:47:55 +10:00
Grégoire Jadi
9a32c0f821
doc WAL: Add link to PIL.Image.Image.putpalette
[ci skip]
2023-07-05 11:26:46 +02:00
Andrew Murray
b2b05f3b83 Moved QOI from Write-Only to Read-Only 2023-06-14 18:55:19 +10:00
Andrew Murray
b39c807dde Removed rectangle example from co-ordinate system documentation 2023-05-18 22:14:40 +10:00
Andrew Murray
f8be09612d
Merge pull request #6903 from joshware/jp2k_options
Support custom comments and PLT markers when saving JPEG2000 images
2023-03-29 23:43:54 +11:00
Andrew Murray
598216fb46 OpenJPEG 2.4.0 or later is required for PLT markers 2023-03-29 19:25:14 +11:00
Andrew Murray
7d6ff23e1f
Renamed "add_plt" to "plt"
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-03-28 07:32:30 +11:00
Andrew Murray
176b2a2000 Merge branch 'master' into jp2k_options 2023-03-23 08:57:20 +11:00
Andrew Murray
9e6ae98362 Dropped support for BGR;32 mode 2023-03-13 17:31:12 +11:00
mergify[bot]
264b19b266
Merge pull request #6852 from radarhere/qoi
Added QOI reading
2023-03-12 14:43:19 +00:00
Andrew Murray
da2083fb8d List modes that can be used when saving PDFs 2023-03-13 00:07:53 +11:00
Andrew Murray
0a6092b0e6
Use full name of format
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-03-12 23:25:38 +11:00
Andrew Murray
2d01875e7c Added QOI reading 2023-03-09 13:34:44 +11:00
Hugo van Kemenade
7d8a08b221
Merge pull request #6958 from radarhere/codeblock 2023-02-25 13:38:29 +02:00
Andrew Murray
4777379465
Merge pull request #6961 from jvanderneutstulen/add-save-pdf-dpi-tuple
Support saving PDF with different X and Y resolution
2023-02-24 12:50:42 +11:00
Jasper van der Neut - Stulen
3c3d888450 Update docs/handbook/image-file-formats.rst
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2023-02-23 23:26:52 +01:00
Andrew Murray
742aff3718 Replace Python code-blocks with double colons 2023-02-24 08:17:10 +11:00
Andrew Murray
acc7e0b469 Highlight code example 2023-02-24 08:00:24 +11:00
Jasper van der Neut
36bcc0a898 Support saving PDF with different X and Y resolution.
Add a `dpi` parameter to the PDF save function, which accepts
a tuple with X and Y dpi.
This is useful for converting tiffg3 (fax) images to pdf,
which have split dpi like (204,391), (204,196) or (204,98).
2023-02-21 11:49:05 +01:00
Andrew Murray
a55c2b42b9 If following colon, replace Python code-blocks with double colons 2023-02-18 20:34:52 +11:00
mergify[bot]
d48dca3dc4
Merge pull request #6952 from jzern/webp-quality
Corrected documented WebP quality range
2023-02-15 08:19:01 +00:00
James Zern
8935dad32e image-file-formats.rst: document WebP 'xmp' option 2023-02-14 17:29:06 -08:00
James Zern
06ba226e7b image-file-formats.rst: correct WebP quality range
0-100, not 1-100
2023-02-14 17:28:16 -08:00
Renat Nasyrov
9dc9e82bef
Specify correct description for mode L. 2023-01-24 00:11:27 +01:00
Josh Ware
d55563ca25
Update docs/handbook/image-file-formats.rst to fix lint
Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
2023-01-19 12:05:05 +11:00
Josh Ware
de43bc99c8 Added support for jpeg2000 comments and PLT marker segments 2023-01-19 11:37:14 +11:00
Andrew Murray
d3d7566d9a Refer to Resampling enum 2023-01-07 11:27:43 +11:00
Hugo van Kemenade
2ae55ccbda Improve exception traceback readability 2022-12-30 00:07:52 +02:00
Hugo van Kemenade
cea6c1e86c
Merge pull request #6838 from radarhere/premultiplied_alpha
Document the meaning of "premultiplied alpha"
2022-12-29 12:02:40 +02:00
Hugo van Kemenade
f452f9a3f3
Merge pull request #6709 from radarhere/signed
Added signed option when saving JPEG2000 images
2022-12-29 11:59:33 +02:00
Andrew Murray
efa27a70d6 Document the meaning of "premultiplied alpha" 2022-12-29 13:18:45 +11:00
Andrew Murray
a4baeda9f6
Fixed typo
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2022-12-29 11:07:16 +11:00
Andrew Murray
4518dc82ba Merge branch 'main' into signed 2022-12-29 09:37:35 +11:00
Andrew Murray
a9c46bc288 Document "transparency" info key 2022-12-28 10:22:10 +11:00
Andrew Murray
164311a756 Specify "I" and "F" ranges 2022-12-12 06:55:10 +11:00
Andrew Murray
ae3f43de64 Document Hue range 2022-12-10 19:48:07 +11:00
Andrew Murray
bef128b04b Added support for saving JPEG comments 2022-12-07 22:30:15 +11:00
Alireza Shafaei
d6f10d4876 doc update for libwebp 2022-11-18 23:51:06 -08:00
Alireza Shafaei
fdf074b050 added a note to the docs for webp 2022-11-18 10:22:33 -08:00
Alireza Shafaei
1f6df76c42 updated webp with exact parameter. 2022-11-17 13:58:07 -08:00
Andrew Murray
6ddbe4cbf0 Added signed option when saving JPEG2000 images 2022-11-03 18:26:31 +11:00
Andrew Murray
78430b9549 Corrected BMP compression setting [ci skip] 2022-10-22 18:50:17 +11:00
Nathanael Gentry
455ffff735 Update documentation for 4-bit RLE decoder 2022-10-21 19:45:41 -04:00
Andrew Murray
00a716c421 High bit depth multichannel images are not yet supported 2022-10-04 12:54:48 +11:00
Andrew Murray
15b2b7a9de Added headings before listing options 2022-10-01 19:54:35 +10:00
Andrew Murray
599637808c Documented TGA keyword arguments when saving 2022-08-29 13:22:09 +10:00
Christoph Gohlke
8a1837c80d
DOC: fix image-file-formats.rst 2022-08-20 19:39:04 -07:00
Andrew Murray
2944ff18d6 Support saving multiple MPO frames 2022-07-16 20:02:58 +10:00
Andrew Murray
23af975a41 Updated link for more information about SPIDER 2022-07-11 06:25:00 +10:00
Andrew Murray
300f6c8a59 Document where to find other codecs 2022-07-04 19:33:21 +10:00
Andrew Murray
c8529b60de Added EMF and SUN [ci skip] 2022-05-28 00:13:50 +10:00
Andrew Murray
9188c81e5f Once a GIF comment is loaded, it is kept for subsequent frames 2022-05-24 08:50:51 +10:00
Andrew Murray
7c031e9279 Clarified sentence [ci skip] 2022-05-20 19:30:50 +10:00
Andrew Murray
533c907329 Updated example in light of #3203 2022-05-20 19:21:12 +10:00
Andrew Murray
3efe34463e Clarified that LZW encoding is always used for GIFs [ci skip] 2022-05-20 19:10:51 +10:00
Ray Gardner
b01a2effd2 Update image-file-formats.rst
Correct encoding of GIF files from run-length to LZW.
2022-04-19 13:40:56 -06:00
Andrew Murray
46ba6b51de
Merge pull request #6215 from kolibril13/readURL
Add example to read image from URL
2022-04-19 07:51:33 +10:00
Jan-Hendrik Müller
f9bf1cd59d
Update docs/handbook/tutorial.rst
Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
2022-04-16 08:12:54 +02:00
Jan-Hendrik Müller
12665d8db4
add read from URL example 2022-04-15 14:02:52 +02:00
Andrew Murray
986ae73562
Merge pull request #6158 from hugovk/furo
Replace Read the Docs Sphinx Theme with Furo
2022-04-04 23:23:57 +10:00
Hugo van Kemenade
703f54c847
Merge pull request #5500 from scaramallion/dev-j2k 2022-04-01 09:39:07 +03:00
Hugo van Kemenade
e0de5b67ce Document mct and no_jp2 options for saving JPEG 2000 2022-03-31 22:19:00 +03:00
scaramallion
da7e331573 Fix typo in handbook entry 2022-03-31 22:13:17 +03:00
scaramallion
74d7319c66 Reword the handbook entries to make explicit reference to RCT and ICT 2022-03-31 22:13:17 +03:00
scaramallion
4e7f041795 Rename parameter and add more tests 2022-03-31 22:13:17 +03:00
scaramallion
de26f78eb1 Add 'mct' and 'use_jp2' options for J2K saving 2022-03-31 22:13:17 +03:00
Hugo van Kemenade
5e511d5b11
Merge pull request #6135 from carandraug/document-jpeg-quality-keep 2022-03-31 21:34:02 +03:00
Hugo van Kemenade
e60ca89721
Merge pull request #6150 from radarhere/gif 2022-03-30 23:23:59 +03:00
Andrew Murray
24054d8fcc Document how to restore original setting 2022-03-30 07:29:23 +11:00
Andrew Murray
5fb1ff6369 Further explain GIF palettes combining 2022-03-29 22:05:21 +11:00
Andrew Murray
e22a4395d3 Renamed setting 2022-03-29 21:26:29 +11:00
Hugo van Kemenade
8b4c1b92a9 Remove unnecesary table of contents 2022-03-28 20:48:30 +03:00
Andrew Murray
55852d5392
Use consistent term 2022-03-26 13:44:27 +11:00
Andrew Murray
47426c5ee2 #6102 added support for RLE8 2022-03-24 19:03:37 +11:00