Commit Graph

427 Commits

Author SHA1 Message Date
Andrew Murray
d0a30ec369 Updated documentation 2021-07-29 16:20:20 +10:00
Andrew Murray
622a1cd542 Changed URLs to HTTPS 2021-07-12 21:00:36 +10:00
Hugo van Kemenade
20b8a83773
Merge pull request #5437 from radarhere/stdout 2021-05-03 11:57:46 +03:00
Andrew Murray
b432f838f1 Documented ImageOps contain method 2021-05-01 22:53:46 +10:00
Andrew Murray
bb12c8079e Added missing import 2021-04-29 21:35:57 +10:00
Hugo van Kemenade
8c852e44f0
Merge pull request #5349 from latosha-maltba/master 2021-04-01 11:55:37 +03:00
Hugo van Kemenade
e405ab300b
Merge pull request #5351 from radarhere/categories 2021-03-28 14:34:50 +03:00
Andrew Murray
0ff9879171 Document supported quantization methods for RGBA images 2021-03-22 19:21:31 +11:00
Andrew Murray
ab56edb49f Documented default quantization method 2021-03-22 19:18:36 +11:00
Andrew Murray
2d8658bd84 Deprecated categories [ci skip] 2021-03-22 18:58:50 +11:00
Latosha Maltba
bb88d8d017 Add support to use GraphicsMagick's "gm display" as viewer 2021-03-21 14:36:18 +00:00
Andrew Murray
f5d49f4f61 Added rounded_rectangle method 2021-03-08 19:53:59 +11:00
Ondrej Baranovič
14671f715f
Merge branch 'master' into sbix 2021-03-07 20:05:25 +01:00
Kipkurui Mutai
5e0a4acb85 Update ImageShow.rst 2021-03-04 08:56:13 +11:00
Andrew Murray
80e570bb99 Added context managers 2021-02-25 23:41:31 +11:00
Jesus Cea
f74d7d800c The example from filter should be next to filter method docs, not in 'frombytes' 2021-02-22 23:59:51 +01:00
nulano
61ee8ec03c document and add tests for SBIX color font support 2021-02-22 12:00:20 +11:00
Andrew Murray
2bbf31929f Added PyQt6 and PySide 6 to list of modules [ci skip] 2021-02-16 22:36:32 +11:00
Andrew Murray
c2203a13a8
Merge pull request #5181 from macjohnny/patch-1
Docs: add alpha channel to supported hex color specifiers
2021-02-11 20:47:22 +11:00
Andrew Murray
e64d62e568 Adjusted formatting [ci skip] 2021-02-09 19:47:40 +11:00
Andrew Murray
6c0af0fdfb Removed ImageDraw reference 2021-02-09 19:46:07 +11:00
Andrew Murray
e4a8783e88 Changed example value to avoid using "a" 2021-02-09 19:44:51 +11:00
Andrew Murray
a5d8d1e163 Removed outdated documentation [ci skip] 2021-02-08 22:00:48 +11:00
nulano
aa742fd8a4 Document availability of tk version number. [ci skip] 2021-01-25 22:13:33 +01:00
Andrew Murray
a6fc7a5320 Changed example image file name [ci skip] 2021-01-09 21:14:02 +11:00
Andrew Murray
497f9e2764 Fixed unexpected indentation [ci skip] 2021-01-08 00:06:18 +11:00
Esteban Gehring
930059814d
docs: add alpha channel to supported hex color specifiers 2021-01-04 13:42:15 +01:00
Eric Soroos
6b6c0b3692 Added docs for C-Extension debugging with valgrind [ci-skip] 2021-01-02 13:07:30 +01:00
Andrew Murray
6ee74e1f18 Document limited number of characters [ci skip] 2020-12-27 12:48:29 +11:00
Hollow Man
889409ded3
Fix use of a versus an in ImageCms.rst
an color -> a color
2020-12-20 22:31:25 +08:00
Andrew Murray
5b2da5f7b0 Link directly to pilfont script [ci skip] 2020-11-04 21:52:00 +11:00
Andrew Murray
3581600bf3 Clarified that "text" must be a string [ci skip] 2020-10-26 06:58:20 +11:00
nulano
d7a08cbd15 add color support to new text measuring functions 2020-10-12 16:05:19 +01:00
nulano
90e8255ba4 Merge remote-tracking branch 'upstream/master' into anchor-part3
# Conflicts:
#	Tests/test_imagefontctl.py
2020-10-12 15:50:45 +01:00
nulano
845bfda3ff fix docs formatting 2020-10-12 05:08:58 +01:00
nulano
b85fabca70
Apply suggestions from code review
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2020-10-11 22:25:16 +02:00
nulano
be4d5221ad remove extra information 2020-10-11 21:21:38 +01:00
nulano
067a254366
Apply suggestions from code review
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2020-10-11 21:55:32 +02:00
nulano
c80f123923 document ImageDraw.textlength and ImageDraw.textbbox 2020-10-09 01:43:23 +01:00
nulano
395aa946a9 add getbbox and getlength, with tests
Squashed commits:

[ec9ec31b] add tests for invalid anchor
(cherry picked from commit 9e50a6a47f79876ee56942152047f03fff03c49b)

[386a9170] fix lint and docs
(cherry picked from commit 2d0d5282fcfc3ee332a41e60b865ee766445cc3d)

[29f5d4c9] restore and document previous getsize behaviour
see discussion in issue 4789
(cherry picked from commit 9fbc94571ce0ed42fdd11e99f343a1613c9dc6d3)

[0ffd51a0] add getbbox and getlength, with tests
(cherry picked from commit c5f63737476a998c81e589e5819d21ca69bb7b46)
2020-10-09 00:56:58 +01:00
nulano
9151da162c add support for CBDT and embedded bitmaps in truetype fonts 2020-10-07 05:29:17 +01:00
nulano
82a28d12e2 add support for fonts with COLR data 2020-10-07 05:29:10 +01:00
nulano
e696bb06d8 update version numbers 2020-10-04 20:28:24 +01:00
nulano
a9b8dcba7d write anchor docs
(cherry picked from commit dcaee36941e6cb5e6f93186b6f819fb74887e0d3)
2020-09-22 14:58:17 +02:00
nulano
e6d4c2ce8f implement text anchor for truetype fonts
(cherry picked from commit bac9025918ccf944bac77addc130f33cf9d74701)
2020-09-19 15:17:45 +02:00
Hugo van Kemenade
3dba4ee10a
Merge pull request #4846 from comhar/features/compute_polygon_coordinates 2020-09-04 23:28:43 +03:00
Hugo van Kemenade
e0eec1eb56 Merge branch 'master' into rm-3.5 2020-09-01 20:16:46 +03:00
Tommy C
b142560488 Rename b_circle and bounding_circle + accept ((x0, y0), r)
Summary of changes

- Rename `b_circle` and `bounding_circle`
-`bounding_circle` now accepts both formats below:
    - (x0, y0, r)
    - ((x0, y0), r)
2020-08-22 20:19:23 +01:00
Tommy C
df9329f9f0 Replace bbox with b_circle, kwargs with args + minor tweaks
Summary of changes:
 - `ImageDraw.regular_polygon` now accepts a bounding circle which
inscribes the polygon. A bounding circle is defined by a center point
(x0, y0) and a radius. A bounding box is no longer accepted.
 - All keyword args have been replaced with positional args.

Misc
- Test image file renaming, minor variable name changes
2020-08-20 20:46:11 +01:00
Tommy C
ac7d41545d Update regular_polygon args + arg checks
Summary of changes

- Allow positional args in `regular_polygon` method
- Allow multiple bounding box formats
    - (e.g. bbox = [(x0, y0), (x1, y1)] or [x0, y0, x1, y1])
- Check if bounding box is square
- Update var names
    - b_box => bbox
    - nb_sides => n_sides
2020-08-16 21:07:16 +01:00
Tommy C
0ed01dd964 Add ImageDraw.regular_polygon 2020-08-16 13:29:13 +01:00
Hugo van Kemenade
dece040ee8 Fix RST backticks 2020-08-08 22:39:28 +03:00
Hugo van Kemenade
10615a7da7 Upgrade Python syntax for 3.6+
Co-authored-by: nulano <nulano@nulano.eu>
2020-07-30 10:09:18 +03:00
Andrew Murray
11de331886
Merge pull request #4798 from hugovk/rm-deprecated-notimplemented
Remove long-deprecated Image.py functions
2020-07-24 20:48:20 +10:00
Hugo van Kemenade
ea96cbeddc
Alphabetise
Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
2020-07-22 12:10:23 +03:00
Andrew Murray
7f829b60c9 MAX_IMAGE_PIXELS can be changed 2020-07-21 23:01:51 +10:00
Andrew Murray
5abf0eb4f3 Include reference to DecompressionBombError 2020-07-21 21:46:31 +10:00
Andrew Murray
265bfef36e Improved documentation 2020-07-21 20:46:50 +10:00
Andrew Murray
d98b85d386
Capitalise and hyphenate [ci skip]
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2020-07-20 23:08:25 +10:00
Andrew Murray
9db4a84983 Documented MAX_IMAGE_PIXELS 2020-07-20 21:16:33 +10:00
Hugo van Kemenade
415a4aa8ac Add PIL.Image.Image.frombytes to docs 2020-07-18 10:13:18 +03:00
Hugo van Kemenade
40aefc6ba5 Remove im.offset, deprecated in 2001; and fromstring and tostring, deprecated in 2013 2020-07-17 10:55:20 +03:00
Andrew Murray
470bf71e7a Removed domain references from image expressions 2020-07-14 22:36:42 +10:00
Andrew Murray
291208b581
Merge pull request #4768 from hugovk/rm-deprecated-ImageCms.CmsProfile-attributes
Remove ImageCms.CmsProfile attributes deprecated since 3.2.0
2020-07-12 08:10:34 +10:00
nulano
7ce6a15062 Merge remote-tracking branch 'upstream/master' into refs-animated
# Conflicts:
#	docs/reference/Image.rst
2020-07-11 12:33:36 +02:00
Hugo van Kemenade
4ca7e7e699
Merge pull request #4771 from nulano/refs-misc 2020-07-11 12:42:50 +03:00
nulano
1ac943991a Apply suggestions from code review
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2020-07-11 13:25:10 +10:00
nulano
7a660d548d fix ImageQt reference 2020-07-11 13:25:10 +10:00
nulano
39b5d7b4ac fix TiffTags and Exif related references 2020-07-11 13:25:10 +10:00
nulano
885ca9bb03 add omitted ImageFilter types 2020-07-11 13:25:10 +10:00
nulano
ec2b549a4d fix _imaging and Image.core references 2020-07-11 13:25:10 +10:00
nulano
73c5dffb5a fix ImageTransformHandler and ImagePointHandler references 2020-07-11 13:25:10 +10:00
nulano
0083ebb3d4 fix various reference typos 2020-07-11 13:25:10 +10:00
nulano
9c277f5c49 document PngImagePlugin constants 2020-07-11 13:23:19 +10:00
Andrew Murray
5e9e501591 Updated documentation [ci skip] 2020-07-11 13:13:49 +10:00
Hugo van Kemenade
fc1f16b616
Merge pull request #4774 from nulano/refs-std 2020-07-10 17:45:04 +03:00
Hugo van Kemenade
384523fab2 Fix PostScript typos 2020-07-10 11:48:02 +03:00
nulano
9589159585 use cross-reference for None value 2020-07-10 00:08:27 +02:00
nulano
c244ecf245 avoid suggesting that Pillow understands animation in all formats
Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
2020-07-09 17:16:41 +02:00
Andrew Murray
91bd2d3752 Altered descriptions [ci skip] 2020-07-05 13:34:40 +01:00
nulano
74899cd6cf
Merge branch 'master' into refs-animated 2020-07-02 12:58:09 +01:00
Hugo van Kemenade
20282dd23c
Merge pull request #4733 from nulano/refs-mod
Fix documentation references: modules
2020-06-29 11:57:53 +03:00
nulano
9019af5f32
Merge branch 'master' into refs-const 2020-06-28 10:55:26 +01:00
Hugo van Kemenade
977094d4b5
Merge pull request #4735 from nulano/refs-type 2020-06-28 09:41:37 +03:00
Hugo van Kemenade
780294302d
Merge pull request #4734 from nulano/refs-missing 2020-06-28 09:29:31 +03:00
nulano
f5b4565d8c document is_animated and n_frames 2020-06-27 17:24:13 +02:00
nulano
4f1ee7a881 add missing and sort Image functions
(cherry picked from commit f31c786aa6)
2020-06-27 15:40:43 +02:00
nulano
3342270947 fix Image constants references
(cherry picked from commit 5511111f3b)
2020-06-27 15:39:55 +02:00
nulano
8b005dfe33 fix base Image attribute references
(cherry picked from commit 07cc74d38b)
2020-06-27 15:38:52 +02:00
nulano
5e4c3ae554 fix ImageMath creating false index entries
(cherry picked from commit eebecba3c2)
2020-06-27 15:37:35 +02:00
nulano
bd2c705606 fix CmsProfile type references
(cherry picked from commit 6196695156)
2020-06-27 15:37:29 +02:00
nulano
2761a02d13 fix module references
(cherry picked from commit b077850baa)
2020-06-27 15:33:55 +02:00
nulano
471f24f660 fix PyCMSError references
(cherry picked from commit 63d0fb4f70)
2020-06-27 15:33:05 +02:00
nulano
e4210eb8d7 fix ImageFile references
(cherry picked from commit 6ac071782f)
2020-06-27 15:30:45 +02:00
Hugo van Kemenade
92561bdcdc
Merge pull request #4697 from nulano/docs-imageshow 2020-06-27 14:09:44 +03:00
nulano
6c1ff252d6 check run-time version numbers where available, add docs 2020-06-21 18:58:39 +10:00
nulano
23b771973d Merge remote-tracking branch 'upstream/master' into docs-imageshow 2020-06-20 13:08:47 +02:00
nulano
c40b0e5426 fix some docs links 2020-06-14 17:16:15 +02:00
nulano
255bd0caef create docs section Internal Modules 2020-06-14 16:39:23 +02:00
nulano
eb150c5518 sort docs index 2020-06-14 14:48:56 +02:00
nulano
eab2260313 add docs for ImageDraw2 based on ImageDraw, fix ImageDraw links 2020-06-14 14:48:22 +02:00
nulano
f19e3ec124 promote JpegPresets from autodoc section 2020-06-14 13:55:19 +02:00
nulano
4a9afc79bf improve ImageShow docs 2020-06-14 13:55:19 +02:00
nulano
d05a08a298 formatting improvements
Co-authored-by: Hugo <hugovk@users.noreply.github.com>
2020-06-14 06:49:00 +02:00
nulano
097104278b add docs for features module 2020-06-13 04:28:02 +02:00
Andrew Murray
bb01312ba9 Improved formatting 2020-06-11 22:42:13 +10:00
Andrew Murray
402a59f6ec Fixed formatting [ci skip] 2020-06-08 13:17:08 +10:00
Hugo
cda682efc4 Parameter values in code formatting 2020-06-04 11:45:13 +03:00
Hugo van Kemenade
95f3f359b7
Fix name
Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
2020-06-03 11:23:24 +03:00
Hugo
14302aa53d Fix parameter formatting 2020-06-02 22:14:36 +03:00
Hugo
87de783226 Replace simple code formatting with :py:meth: markup 2020-06-02 21:48:53 +03:00
Hugo
087e42f743 Move OpenType docs link to a reference 2020-06-02 21:28:34 +03:00
Hugo
dc0c7bea37 Update ImageDraw docs formatting and links 2020-06-02 21:16:13 +03:00
Hugo van Kemenade
b8bc307691
Merge pull request #4604 from radarhere/imagegrab
Updated ImageGrab documentation now that Linux is supported
2020-05-31 23:20:51 +03:00
Hugo
f271bc8b2f Link pilfont to its new home in pillow-scripts 2020-05-21 00:17:56 +03:00
Andrew Murray
6669ffd053 Updated documentation now that Linux is supported 2020-05-03 13:06:25 +10:00
Hugo
94c7af7596 Replace spaces with tabs and add to pre-commit linting 2020-05-01 21:23:39 +03:00
Andrew Murray
b2f187c4ec Added multiline text example [ci skip] 2020-04-12 15:11:29 +10:00
Andrew Murray
417cbd1557 Document getexif [ci skip] 2020-04-11 18:01:13 +10:00
Andrew Murray
f1f177ce80 Fixed error making HTML from docs 2020-04-06 19:41:38 +10:00
Hugo van Kemenade
b5cf165f9e
Merge pull request #4260 from nulano/imagegrab_xcb
ImageGrab.grab() for Linux with XCB
2020-03-31 23:03:21 +03:00
Hugo van Kemenade
c6115c1ceb
Merge pull request #4230 from dwastberg/new_chops
Added three new channel operations
2020-03-31 10:24:44 +03:00
Andrew Murray
790ff223fc Updated versions 2020-03-24 19:52:27 +11:00
nulano
0bcc7be89b xcb screengrab docs and fixes 2020-03-24 19:46:40 +11:00
Andrew Murray
04f7c75466 Use context manager when opening images [ci skip] 2020-02-29 10:29:44 +11:00
Dag Wästberg
2e02500fa6 change function names to snake_case 2020-02-19 19:38:53 +11:00
Dag Wästberg
13c1b7070d add Overlay chop 2020-02-19 19:24:36 +11:00
Dag Wästberg
c8a46ef387 update docs 2020-02-19 19:23:09 +11:00
Hugo van Kemenade
0e993c4740
Merge pull request #4334 from radarhere/outline_width
Allow explicit zero width to hide outline
2020-02-15 14:30:12 +02:00
Andrew Murray
1c102fd040 Updated spacing defaults [ci skip] 2020-01-18 10:26:20 +11:00
Andrew Murray
56f30ef792 Allow explicit zero width to hide outline 2020-01-08 21:55:15 +11:00
Jon Dufresne
4cd4adddc3 Improve handling of file resources
Follow Python's file object semantics. User code is responsible for
closing resources (usually through a context manager) in a deterministic
way.

To achieve this, remove __del__ functions. These functions used to
closed open file handlers in an attempt to silence Python
ResourceWarnings. However, using __del__ has the following drawbacks:

- __del__ isn't called until the object's reference count reaches 0.
  Therefore, resource handlers remain open or in use longer than
  necessary.

- The __del__ method isn't guaranteed to execute on system exit. See the
  Python documentation:

  https://docs.python.org/3/reference/datamodel.html#object.__del__

  > It is not guaranteed that __del__() methods are called for objects
  > that still exist when the interpreter exits.

- Exceptions that occur inside __del__ are ignored instead of raised.
  This has the potential of hiding bugs. This is also in the Python
  documentation:

  > Warning: Due to the precarious circumstances under which __del__()
  > methods are invoked, exceptions that occur during their execution
  > are ignored, and a warning is printed to sys.stderr instead.

Instead, always close resource handlers when they are no longer in use.
This will close the file handler at a specified point in the user's code
and not wait until the interpreter chooses to. It is always guaranteed
to run. And, if an exception occurs while closing the file handler, the
bug will not be ignored.

Now, when code receives a ResourceWarning, it will highlight an area
that is mishandling resources. It should not simply be silenced, but
fixed by closing resources with a context manager.

All warnings that were emitted during tests have been cleaned up. To
enable warnings, I passed the `-Wa` CLI option to Python. This exposed
some mishandling of resources in ImageFile.__init__() and
SpiderImagePlugin.loadImageSeries(), they too were fixed.
2019-10-12 08:27:17 -07:00
Andrew Murray
fab0205abc Updated documentation [ci skip] 2019-10-08 21:12:15 +11:00
Hugo
f0a87e25a4 Drop support for EOL PyQt4 and PySide 2019-09-30 17:58:31 +03:00
Hugo van Kemenade
310d2c9005
Add option to capture all monitors on Windows (#3950)
Add option to capture all monitors on Windows
2019-09-27 08:47:55 +03:00
nulano
3c311f5619 add version added [ci skip] 2019-09-27 00:58:32 +02:00
nulano
6a2d8f8da0 rename parameter, add note to docs 2019-09-20 17:35:08 +02:00
Hugo
f792ab6c02 RST uses double backticks for code (MD uses 1) 2019-09-13 08:56:33 +03:00
Andrew Murray
da39d40342
Merge pull request #3978 from radarhere/stroke
Added text stroking
2019-09-06 19:14:49 +10:00
nulano
fa6b80fddf add option to capture all monitors on Windows 2019-08-15 20:03:33 +10:00
Andrew Murray
4283683948 Corrected note syntax [ci skip] 2019-08-03 23:24:28 +10:00
Andrew Murray
f93a5d0972 Added text stroking 2019-07-29 06:40:03 +10:00
Andrew Murray
dfed1424d1 Improved ImageFont documentation 2019-07-25 20:04:45 +10:00
Jon Dufresne
8fac23b3df Clean up several Sphinx warnings
Appeared as:

    Pillow/docs/reference/ImageDraw.rst:137: WARNING: Unexpected indentation.
    Pillow/docs/reference/ImageDraw.rst:164: WARNING: Unexpected indentation.
    Pillow/docs/reference/ImageDraw.rst:177: WARNING: Unexpected indentation.
    Pillow/docs/reference/ImageDraw.rst:208: WARNING: Unexpected indentation.
    Pillow/docs/reference/ImageStat.rst:24: WARNING: Explicit markup ends without a blank line; unexpected unindent.
2019-07-06 17:12:09 -07:00
Hugo
a0191dae1e
Documentation for Image module (#3776)
Documentation for Image module
2019-06-28 19:49:45 +03:00
Hugo
57e3af4afb Fix typo 2019-06-28 18:47:17 +03:00
Hugo
73884576d4 Some styling and wording 2019-06-24 11:04:13 +03:00
Hugo
72bf9f6529 Use the common test-suite image 2019-06-24 10:48:33 +03:00
Hugo
fd1d779ae1 Strip trailing whitespace 2019-06-24 10:45:53 +03:00
Hugo
169961649d
Merge pull request #3848 from radarhere/pa
Improved palette handling for LA and PA modes
2019-06-05 22:32:44 +03:00