python-pillow/Pillow
1
1
Fork 0
mirror of https://github.com/python-pillow/Pillow.git synced 2024-12-27 10:26:19 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #3384 from radarhere/tutorial

Browse Source 
Improved tutorial
This commit is contained in:
Hugo 2018-09-29 09:42:11 +03:00 committed by GitHub
commit 2aed1ffcba
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
docs/handbook/tutorial.rst
View File

@ -41,10 +41,10 @@ example, let’s display the image we just loaded::
.. note:: .. note::
The standard version of :py:meth:`~PIL.Image.Image.show` is not very The standard version of :py:meth:`~PIL.Image.Image.show` is not very
efficient, since it saves the image to a temporary file and calls the efficient, since it saves the image to a temporary file and calls a utility
:command:`xv` utility to display the image. If you don’t have :command:`xv` to display the image. If you don’t have an appropriate utility installed,
installed, it won’t even work. When it does work though, it is very handy it won’t even work. When it does work though, it is very handy for
for debugging and tests. debugging and tests.
The following sections provide an overview of the different functions provided in this library. The following sections provide an overview of the different functions provided in this library.
@ -183,20 +183,11 @@ Rolling an image
part1 = image.crop((0, 0, delta, ysize)) part1 = image.crop((0, 0, delta, ysize))
part2 = image.crop((delta, 0, xsize, ysize)) part2 = image.crop((delta, 0, xsize, ysize))
part1.load()
part2.load()
image.paste(part2, (0, 0, xsize-delta, ysize))
image.paste(part1, (xsize-delta, 0, xsize, ysize)) image.paste(part1, (xsize-delta, 0, xsize, ysize))
image.paste(part2, (0, 0, xsize-delta, ysize))
return image return image
Note that when pasting it back from the :py:meth:`~PIL.Image.Image.crop`
operation, :py:meth:`~PIL.Image.Image.load` is called first. This is because
cropping is a lazy operation. If :py:meth:`~PIL.Image.Image.load` was not
called, then the crop operation would not be performed until the images were
used in the paste commands. This would mean that ``part1`` would be cropped from
the version of ``image`` already modified by the first paste.
For more advanced tricks, the paste method can also take a transparency mask as For more advanced tricks, the paste method can also take a transparency mask as
an optional argument. In this mask, the value 255 indicates that the pasted an optional argument. In this mask, the value 255 indicates that the pasted
image is opaque in that position (that is, the pasted image should be used as image is opaque in that position (that is, the pasted image should be used as