PixelAccess Class

The PixelAccess class provides read and write access toPIL.Image data at a pixel level.

注解

Accessing individual pixels is fairly slow. If you are looping over all of the pixels in an image, there is likely a faster way using other parts of the Pillow API.

Example

The following script loads an image, accesses one pixel from it, thenchanges it.

from PIL import Image
im = Image.open('hopper.jpg')
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

• class PixelAccess
• • setitem(self, xy, color):
  • Modifies the pixel at x,y. The color is given as a singlenumerical value for single band images, and a tuple formulti-band images

参数:

- **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)

• getitem(self, xy):
• • Returns the pixel at x,y. The pixel is returned as a single
  • value for single band images or a tuple for multiple bandimages

param xy:The pixel coordinate, given as (x, y).returns:a pixel value for single band images, a tuple ofpixel values for multiband images.

• putpixel(self, xy, color):
• Modifies the pixel at x,y. The color is given as a singlenumerical value for single band images, and a tuple formulti-band images. In addition to this, RGB and RGBA tuplesare accepted for P images.

参数:

- **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)

• getpixel(self, xy):
• • Returns the pixel at x,y. The pixel is returned as a single
  • value for single band images or a tuple for multiple bandimages

param xy:The pixel coordinate, given as (x, y).returns:a pixel value for single band images, a tuple ofpixel values for multiband images.