The Python Imaging Library
  Copyright © 1997 by Fredrik Lundh <fredrik@pythonware.com>  
  Updated 20 Aug 1997  

< The ImageChops Module | The ImageDraw Class | The ImageEnhance Module >

The ImageDraw Class

This class provide some basic graphics support for "1", "L" and "P" images.

To use the ImageDraw class, import the ImageDraw module.

Example

import Image, ImageDraw

im = Image.open("lena.gif")

# draw a grey cross over the image
draw = ImageDraw.ImageDraw(im)
draw.setink(128)
draw.line((0, 0), im.size)
draw.line((0, im.size[1]), (im.size[0], 0))
del draw 

im.show()

Functions

ImageDraw (constructor)

ImageDraw( image ) creates an object that can be used to draw in the given image. The image must be a "1", "L" or "P" image. Ink is set to 255, and fill is off.

Methods

line

line( from, to ) draws a line between the two points.

line( list ) connects the points in the list. The list can be any sequence object containing either 2-tuples [(x, y), ...] or numeric values [x, y, ...].

point

point( position ) draws a point at the given position.

point( list ) draws the points in the list. The list can be any sequence object containing either 2-tuples [(x, y), ...] or numeric values [x, y, ...].

polygon

polygon( list ) draws a polygon. The list can be any sequence object containing either 2-tuples [(x, y), ...] or numeric values [x, y, ...].

rectangle

rectangle( box ) draws a rectangle. Note that the second coordinate pair defines a point just outside the rectangle, also when the rectangle is not filled.

text

text( position, string ) draws the string at the given position. You must call setfont before you can use this method.

setink

setink( ink ) selects the pixel value to use with subsequent operations.

setfill

setfill( onoff ) selects if subsequently polygons and rectangles should be filled objects or just outlined.

setfont

setfont( font ) selects the font to use for the text method. The font argument should be an instance of the ImageFont class, typically loaded from file using the load method in the ImageFont module.

< The ImageChops Module | The ImageDraw Class | The ImageEnhance Module >