Image

---

Pillow library Image provides support for creating and manipulating images.

Standard package

Modules using `Image typically include the following import

from PIL import Image

---

Functions

• Image.open( n ): returns an Image representation of the image file named by n. Parameter n is the name of a local file.

• Image.new( m, size, color='black' ) returns a mode m new image, whose dimensions are size. The background of the image color. Parameter color is optional with a default value of black.

• The mode is the representation to be used for the pixels in the image. Typically, we will use an RGB ('RGB') pixel color representation. Other common representations are RGBA, HSV, CMYK, I and F.

• An image size is specified as a two-tuple (w, h) where w and h are respctively the desired width and height. A two-tuple is often referred to as an ordered-pair.

---

Image members

Suppose below im is an Image object, spot is a two-tuple (x, y) representing an image coordinate of interest, and c is a pixel (color).

Fields

• im.width is the width of of image im.

• im.height is the height of of image im.

• im.size is a two-tuple giving the width and height of image im.

For example, the first two statements in following code segment initialize respectively w and h to the width and height of image im. The third statement initializes respectively sw and sh also to the width and height of image im.

w = im.width

h = im.height

sw, sh = im.size

Methods

• im.getpixel( spot ) : returns the value of the pixel at coordinate spot in image im.

• im.putpixel( spot, c ) : sets the pixel at coordinate spot in image im to c.

• im.copy( ) : returns a new Image copy of im.

• im.show( ) : popups a copy of im.

• im.save( n, format=None ) : saves image im to local file n where the picture file type is specified by None. If the format parameter is omitted or None, the file type is given the filename extension of n.

 

---