- Installation
- Handbook
- Reference
ImagemoduleImageChops(“channel operations”) moduleImageCmsmoduleImageColormoduleImageDrawmoduleImageEnhancemoduleImageFilemoduleImageFiltermoduleImageFontmoduleImageGrabmoduleImageMathmoduleImageMorphmoduleImageOpsmoduleImagePalettemoduleImagePathmoduleImageQtmoduleImageSequencemoduleImageShowmoduleImageStatmoduleImageTextmoduleImageTkmoduleImageTransformmoduleImageWinmodule (Windows-only)ExifTagsmoduleTiffTagsmoduleJpegPresetsmodulePSDrawmodulePixelAccessclassfeaturesmodule- PIL package (autodoc of remaining modules)
- Plugin reference
- Internal reference
- Porting
- About
- Release notes
- 12.0.0 (2025-10-15)
- 11.3.0 (2025-07-01)
- 11.2.1 (2025-04-12)
- 11.1.0 (2025-01-02)
- 11.0.0 (2024-10-15)
- 10.4.0 (2024-07-01)
- 10.3.0 (2024-04-01)
- 10.2.0 (2024-01-02)
- 10.1.0 (2023-10-15)
- 10.0.1 (2023-09-15)
- 10.0.0 (2023-07-01)
- 9.5.0 (2023-04-01)
- 9.4.0 (2023-01-02)
- 9.3.0 (2022-10-29)
- 9.2.0 (2022-07-01)
- 9.1.1 (2022-05-17)
- 9.1.0 (2022-04-01)
- 9.0.1 (2022-02-03)
- 9.0.0 (2022-01-02)
- 8.4.0 (2021-10-15)
- 8.3.2 (2021-09-02)
- 8.3.1 (2021-07-06)
- 8.3.0 (2021-07-01)
- 8.2.0 (2021-04-01)
- 8.1.2 (2021-03-06)
- 8.1.1 (2021-03-01)
- 8.1.0 (2021-01-02)
- 8.0.1 (2020-10-22)
- 8.0.0 (2020-10-14)
- 7.2.0 (2020-06-30)
- 7.1.2 (2020-04-25)
- 7.1.1 (2020-04-02)
- 7.1.0 (2020-04-01)
- 7.0.0 (2020-01-02)
- 6.2.2 (2020-01-02)
- 6.2.1 (2019-10-20)
- 6.2.0 (2019-10-01)
- 6.1.0 (2019-07-02)
- 6.0.0 (2019-04-02)
- 5.4.1 (2019-01-06)
- 5.4.0 (2019-01-01)
- 5.3.0 (2018-10-01)
- 5.2.0 (2018-07-01)
- 5.1.0 (2018-04-02)
- 5.0.0 (2018-01-01)
- 4.3.0 (2017-10-02)
- 4.2.1 (2017-07-06)
- 4.2.0 (2017-07-01)
- 4.1.1 (2017-04-28)
- 4.1.0 (2017-04-03)
- 4.0.0 (2017-01-01)
- 3.4.0 (2016-10-03)
- 3.3.2 (2016-09-29)
- 3.3.0 (2016-07-01)
- 3.2.0 (2016-04-01)
- 3.1.2 (2016-04-01)
- 3.1.1 (2016-02-04)
- 3.1.0 (2016-01-04)
- 3.0.0 (2015-10-01)
- 2.8.0 (2015-04-01)
- 2.7.0 (2014-12-31)
- 2.6.0 (2014-10-01)
- 2.5.2 (2014-08-12)
- 2.3.2 (2014-08-12)
- 2.3.1 (2014-03-14)
- Versioning
- Deprecations and removals
PixelAccess class¶
The PixelAccess class provides read and write access toPIL.Image data at a pixel level.
Note
Accessing individual pixels is fairly slow. If you arelooping over all of the pixels in an image, there is likelya faster way using other parts of the Pillow API.
Image,ImageChops andImageOpshave methods for many standard operations. If you wish to performa custom mapping, check outpoint().
Example¶
The following script loads an image, accesses one pixel from it, thenchanges it.
fromPILimportImagewithImage.open("hopper.jpg")asim:px=im.load()print(px[4,4])px[4,4]=(0,0,0)print(px[4,4])
Results in the following:
(23,24,68)(0,0,0)
Access using negative indexes is also possible.
px[-1,-1]=(0,0,0)print(px[-1,-1])
PixelAccess class¶
- classPixelAccess¶
- __getitem__(self,xy:tuple[int,int])→float|tuple[int,...]¶
Returns the pixel at x,y. The pixel is returned as a singlevalue for single band images or a tuple for multi-band images.
- Parameters:
xy – The pixel coordinate, given as (x, y).
- Returns:
a pixel value for single band images, a tuple ofpixel values for multiband images.
- __setitem__(self,xy:tuple[int,int],color:float|tuple[int,...])→None¶
Modifies the pixel at x,y. The color is given as a singlenumerical value for single band images, and a tuple formulti-band images. SeeColors for more information.
- Parameters:
xy – The pixel coordinate, given as (x, y).
color – The pixel value according to its mode,e.g. tuple (r, g, b) for RGB mode.