Commit Graph

400 Commits

Author SHA1 Message Date
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
Andrew Murray
8be6609243 Added PA mode to docs [ci skip] 2019-05-18 20:41:59 +10:00
Andrew Murray
110dd6236f Highlight function [ci skip] 2019-05-08 12:54:12 +10:00
Hugo
82d9ea5eac
Merge pull request #3808 from radarhere/imagegrab
Added option to include layered windows in ImageGrab.grab on Windows
2019-05-04 16:00:43 +03:00
Hugo
c15dc4d7ca
Document format limitations of ImageStat.Stat.extrema (#3661)
Document format limitations of ImageStat.Stat.extrema
2019-05-03 22:14:14 +03:00
Andrew Murray
70038bd71e Added option to include layered windows in ImageGrab.grab on Windows 2019-04-26 20:09:46 +10:00
Andrew Murray
31340bb3c6 Corrected names in documentation 2019-04-24 06:19:17 +10:00
Andrew Murray
0557ecbb3e Document class members automatically 2019-04-21 23:28:08 +10:00
Andrew Murray
93b96a6cb8 Improved documentation 2019-04-21 23:27:31 +10:00
abojja9
c4daa87415 Add documentation to Image module 2019-04-06 13:42:22 -07:00
Andrew Murray
7fd0a1493a Changed wording [ci skip] 2019-03-31 14:36:39 +11:00
Hugo
90886b1888
Merge branch 'master' into imagecms-deprecations 2019-03-27 12:03:54 +02:00
Hugo
30841fe808
Merge pull request #3737 from jdufresne/quotes
Add backticks around Python classes and modules in open_files.rst
2019-03-23 08:31:15 +00:00
Jon Dufresne
d31bee5e35 Add backticks around Python classes and modules in open_files.rst 2019-03-22 06:12:08 -07:00
Jon Dufresne
deb8a7aadd Remove additional references to removed handles_eof
handles_eof was removed in 90760a5f30.
2019-03-22 05:58:22 -07:00
Ben Yang
8bd4bbb808 implemented language parameter for multiline ImageDraw methods, updated release notes 2019-03-11 20:21:52 -07:00
Ben Yang
515244b672 moved language parameter in ImageDraw documentation 2019-03-11 18:56:22 -07:00
Ben Yang
c6ad867178 added proper documentation for ImageFont.getsize() 2019-03-11 18:56:22 -07:00
Ben Yang
d5bbf01254 moved 'language' parameter to last parameter in relevant functions 2019-03-11 18:56:22 -07:00
Ben Yang
8624efd283 added ability to set language for text rendering 2019-03-11 18:55:46 -07:00
Hugo
6f24eda48a Document format limitations of ImageStat.Stat.extrema and recommend more efficient Image.getextrema 2019-03-06 17:49:25 +02:00
Andrew Murray
7477036230
Merge branch 'master' into imagecms-deprecations 2019-02-21 20:00:27 +11:00
Hugo
186f7d943b Document deprecation 2019-02-14 23:44:07 +02:00
Hugo
3ff70c2afc
Merge branch 'master' into imagecms-deprecations 2019-02-13 15:45:28 +02:00
Andrew Murray
4fe63e44d7 Fixed typo [ci skip] 2019-02-10 12:33:16 +11:00
Hugo
7d157bd825 Add warnings to deprecated CMS profile attributes 2019-01-28 15:40:19 +02:00
Andrew Murray
32c344b7ce Added note about ImageDraw operations that exceed image bounds [ci skip] 2019-01-27 22:10:54 +11:00
Hugo
398d2f0c15
Merge pull request #3522 from radarhere/imagechops
Improved ImageChops documentation
2019-01-01 12:21:28 +02:00