PIL Package

PIL Package

ArgImagePlugin Module

class PIL.ArgImagePlugin.ArgImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'ARG'
format_description = 'Animated raster graphics'
load()[source]
seek(frame)[source]
tell()[source]
verify()[source]

Verify ARG file

class PIL.ArgImagePlugin.ArgStream(fp)[source]

Bases: PIL.PngImagePlugin.ChunkStream

Parser callbacks for ARG data

chunk_ADEF(offset, bytes)[source]

ADEF – store image

chunk_AEND(offset, bytes)[source]

AEND – end of animation

chunk_AFRM(offset, bytes)[source]

AFRM – next frame follows

chunk_AHDR(offset, bytes)[source]

AHDR – animation header

chunk_BLNK(offset, bytes)[source]

BLNK – create blank image

chunk_DEND(offset, bytes)[source]
chunk_DHDR(offset, bytes)[source]

DHDR – delta image follows

chunk_IDAT(offset, bytes)[source]

IDAT – image data block

chunk_IEND(offset, bytes)[source]

IEND – end of image

chunk_IHDR(offset, bytes)[source]

IHDR – full image follows

chunk_JEND(offset, bytes)[source]
chunk_JHDR(offset, bytes)[source]

JHDR – JPEG image follows

chunk_NAME(offset, bytes)[source]

NAME – name the current image

chunk_PAST(offset, bytes)[source]

PAST – paste one image into another

chunk_PLTE(offset, bytes)[source]

PLTE – palette data

chunk_UEND(offset, bytes)[source]
chunk_UHDR(offset, bytes)[source]

UHDR – uncompressed image data follows (EXPERIMENTAL)

chunk_sYNC(offset, bytes)[source]

SYNC – reset decoder

BdfFontFile Module

class PIL.BdfFontFile.BdfFontFile(fp)[source]

Bases: PIL.FontFile.FontFile

PIL.BdfFontFile.bdf_char(f)[source]

BmpImagePlugin Module

class PIL.BmpImagePlugin.BmpImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'BMP'
format_description = 'Windows Bitmap'
class PIL.BmpImagePlugin.DibImageFile(fp=None, filename=None)[source]

Bases: PIL.BmpImagePlugin.BmpImageFile

format = 'DIB'
format_description = 'Windows Bitmap'

BufrStubImagePlugin Module

class PIL.BufrStubImagePlugin.BufrStubImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.StubImageFile

format = 'BUFR'
format_description = 'BUFR'
PIL.BufrStubImagePlugin.register_handler(handler)[source]

ContainerIO Module

class PIL.ContainerIO.ContainerIO(file, offset, length)[source]
isatty()[source]
read(n=0)[source]
readline()[source]
readlines()[source]
seek(offset, mode=0)[source]
tell()[source]

CurImagePlugin Module

class PIL.CurImagePlugin.CurImageFile(fp=None, filename=None)[source]

Bases: PIL.BmpImagePlugin.BmpImageFile

format = 'CUR'
format_description = 'Windows Cursor'

DcxImagePlugin Module

class PIL.DcxImagePlugin.DcxImageFile(fp=None, filename=None)[source]

Bases: PIL.PcxImagePlugin.PcxImageFile

format = 'DCX'
format_description = 'Intel DCX'
seek(frame)[source]
tell()[source]

EpsImagePlugin Module

class PIL.EpsImagePlugin.EpsImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

EPS File Parser for the Python Imaging Library

format = 'EPS'
format_description = 'Encapsulated Postscript'
load()[source]
PIL.EpsImagePlugin.Ghostscript(tile, size, fp)[source]

Render an image using Ghostscript

class PIL.EpsImagePlugin.PSFile(fp)[source]

Wrapper that treats either CR or LF as end of line.

read(count)[source]
readline()[source]
seek(offset, whence=0)[source]
tell()[source]

ExifTags Module

FitsStubImagePlugin Module

class PIL.FitsStubImagePlugin.FITSStubImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.StubImageFile

format = 'FITS'
format_description = 'FITS'
PIL.FitsStubImagePlugin.register_handler(handler)[source]

FliImagePlugin Module

class PIL.FliImagePlugin.FliImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'FLI'
format_description = 'Autodesk FLI/FLC Animation'
seek(frame)[source]
tell()[source]

FontFile Module

class PIL.FontFile.FontFile[source]
bitmap = None
compile()[source]

Create metrics and bitmap

save(filename)

Save font in version 1 format

save1(filename)[source]

Save font in version 1 format

save2(filename)[source]

Save font in version 2 format

PIL.FontFile.puti16(fp, values)[source]

FpxImagePlugin Module

class PIL.FpxImagePlugin.FpxImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'FPX'
format_description = 'FlashPix'
load()[source]

GbrImagePlugin Module

class PIL.GbrImagePlugin.GbrImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'GBR'
format_description = 'GIMP brush file'
load()[source]

GdImageFile Module

class PIL.GdImageFile.GdImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'GD'
format_description = 'GD uncompressed images'
PIL.GdImageFile.open(fp, mode='r')[source]

GifImagePlugin Module

class PIL.GifImagePlugin.GifImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

data()[source]
format = 'GIF'
format_description = 'Compuserve GIF'
global_palette = None
seek(frame)[source]
tell()[source]
PIL.GifImagePlugin.getdata(im, offset=(0, 0), **params)[source]

Return a list of strings representing this image. The first string is a local image header, the rest contains encoded image data.

PIL.GifImagePlugin.getheader(im, palette=None, info=None)[source]

Return a list of strings representing a GIF header

GimpGradientFile Module

class PIL.GimpGradientFile.GimpGradientFile(fp)[source]

Bases: PIL.GimpGradientFile.GradientFile

class PIL.GimpGradientFile.GradientFile[source]
getpalette(entries=256)[source]
gradient = None
PIL.GimpGradientFile.curved(middle, pos)[source]
PIL.GimpGradientFile.linear(middle, pos)[source]
PIL.GimpGradientFile.sine(middle, pos)[source]
PIL.GimpGradientFile.sphere_decreasing(middle, pos)[source]
PIL.GimpGradientFile.sphere_increasing(middle, pos)[source]

GimpPaletteFile Module

class PIL.GimpPaletteFile.GimpPaletteFile(fp)[source]
getpalette()[source]
rawmode = 'RGB'

GribStubImagePlugin Module

class PIL.GribStubImagePlugin.GribStubImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.StubImageFile

format = 'GRIB'
format_description = 'GRIB'
PIL.GribStubImagePlugin.register_handler(handler)[source]

Hdf5StubImagePlugin Module

class PIL.Hdf5StubImagePlugin.HDF5StubImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.StubImageFile

format = 'HDF5'
format_description = 'HDF5'
PIL.Hdf5StubImagePlugin.register_handler(handler)[source]

IcnsImagePlugin Module

class PIL.IcnsImagePlugin.IcnsFile(fobj)[source]
SIZES = {(16, 16): [('is32', <function read_32 at 0xf60fe374>), ('s8mk', <function read_mk at 0xf60fe3ac>)], (48, 48): [('ih32', <function read_32 at 0xf60fe374>), ('h8mk', <function read_mk at 0xf60fe3ac>)], (128, 128): [('it32', <function read_32t at 0xf60fe33c>), ('t8mk', <function read_mk at 0xf60fe3ac>)], (32, 32): [('il32', <function read_32 at 0xf60fe374>), ('l8mk', <function read_mk at 0xf60fe3ac>)]}
bestsize()[source]
dataforsize(size)[source]

Get an icon resource as {channel: array}. Note that the arrays are bottom-up like windows bitmaps and will likely need to be flipped or transposed in some way.

getimage(size=None)[source]
itersizes()[source]
class PIL.IcnsImagePlugin.IcnsImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

PIL read-only image support for Mac OS .icns files. Chooses the best resolution, but will possibly load a different size image if you mutate the size attribute before calling ‘load’.

The info dictionary has a key ‘sizes’ that is a list of sizes that the icns file has.

format = 'ICNS'
format_description = 'Mac OS icns resource'
load()[source]
PIL.IcnsImagePlugin.nextheader(fobj)[source]
PIL.IcnsImagePlugin.read_32(fobj, start_length, size)[source]

Read a 32bit RGB icon resource. Seems to be either uncompressed or an RLE packbits-like scheme.

PIL.IcnsImagePlugin.read_32t(fobj, start_length, size)[source]
PIL.IcnsImagePlugin.read_mk(fobj, start_length, size)[source]

IcoImagePlugin Module

class PIL.IcoImagePlugin.IcoImageFile(fp=None, filename=None)[source]

Bases: PIL.BmpImagePlugin.BmpImageFile

format = 'ICO'
format_description = 'Windows Icon'

ImImagePlugin Module

class PIL.ImImagePlugin.ImImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'IM'
format_description = 'IFUNC Image Memory'
seek(frame)[source]
tell()[source]
PIL.ImImagePlugin.number(s)[source]

Image Module

class PIL.Image.Image[source]
convert(mode=None, data=None, dither=None, palette=0, colors=256)[source]

Convert to other pixel format

copy()[source]

Copy raster data

crop(box=None)[source]

Crop region from image

draft(mode, size)[source]

Configure image decoder

filter(filter)[source]

Apply environment filter to image

format = None
format_description = None
frombytes(data, decoder_name='raw', *args)[source]

Load data to image from a bytes object

fromstring(*args, **kw)[source]

Deprecated alias to frombytes

getbands()[source]

Get band names

getbbox()[source]

Get bounding box of actual data (non-zero pixels) in image

getcolors(maxcolors=256)[source]

Get colors from image, up to given limit

getdata(band=None)[source]

Get image data as sequence object.

getextrema()[source]

Get min/max value

getim()[source]

Get capsule pointer to internal image memory

getpalette()[source]

Get palette contents.

getpixel(xy)[source]

Get pixel value

getprojection()[source]

Get projection to x and y axes

histogram(mask=None, extrema=None)[source]

Take histogram of image

load()[source]

Explicitly load pixel data.

offset(xoffset, yoffset=None)[source]

(deprecated) Offset image in horizontal and/or vertical direction

paste(im, box=None, mask=None)[source]

Paste other image into region

point(lut, mode=None)[source]

Map image through lookup table

putalpha(alpha)[source]

Set alpha layer

putdata(data, scale=1.0, offset=0.0)[source]

Put data from a sequence object into an image.

putpalette(data, rawmode='RGB')[source]

Put palette data into an image.

putpixel(xy, value)[source]

Set pixel value

quantize(colors=256, method=0, kmeans=0, palette=None)[source]
resize(size, resample=0)[source]

Resize image

rotate(angle, resample=0, expand=0)[source]

Rotate image. Angle given as degrees counter-clockwise.

save(fp, format=None, **params)[source]

Save image to file or stream

seek(frame)[source]

Seek to given frame in sequence file

show(title=None, command=None)[source]

Display image (for debug purposes only)

split()[source]

Split image into bands

tell()[source]

Return current frame number

thumbnail(size, resample=0)[source]

Create thumbnail representation (modifies image in place)

tobitmap(name='image')[source]

Return image as an XBM bitmap

tobytes(encoder_name='raw', *args)[source]

Return image as a bytes object

tostring(*args, **kw)[source]
transform(size, method, data=None, resample=0, fill=1)[source]

Transform image

transpose(method)[source]

Transpose image (flip or rotate in 90 degree steps)

verify()[source]

Verify file contents.

class PIL.Image.ImagePointHandler[source]
class PIL.Image.ImageTransformHandler[source]
PIL.Image.alpha_composite(im1, im2)[source]

Alpha composite im2 over im1.

PIL.Image.blend(im1, im2, alpha)[source]

Interpolate between images.

PIL.Image.coerce_e(value)[source]
PIL.Image.composite(image1, image2, mask)[source]

Create composite image by blending images using a transparency mask

PIL.Image.eval(image, *args)[source]

Evaluate image expression

PIL.Image.fromarray(obj, mode=None)[source]
PIL.Image.frombuffer(mode, size, data, decoder_name='raw', *args)[source]

Load image from bytes or buffer

PIL.Image.frombytes(mode, size, data, decoder_name='raw', *args)[source]

Load image from byte buffer

PIL.Image.fromstring(*args, **kw)[source]

Deprecated alias to frombytes

PIL.Image.getmodebandnames(mode)[source]
PIL.Image.getmodebands(mode)[source]
PIL.Image.getmodebase(mode)[source]
PIL.Image.getmodetype(mode)[source]
PIL.Image.init()[source]

Load all file format drivers.

PIL.Image.isDirectory(f)[source]
PIL.Image.isImageType(t)[source]
PIL.Image.isStringType(t)[source]
PIL.Image.merge(mode, bands)[source]

Merge a set of single band images into a new multiband image.

PIL.Image.new(mode, size, color=0)[source]

Create a new image

PIL.Image.open(fp, mode='r')[source]

Open an image file, without loading the raster data

PIL.Image.preinit()[source]

Load standard file format drivers.

PIL.Image.register_extension(id, extension)[source]
PIL.Image.register_mime(id, mimetype)[source]
PIL.Image.register_open(id, factory, accept=None)[source]
PIL.Image.register_save(id, driver)[source]

ImageChops Module

PIL.ImageChops.add(image1, image2, scale=1.0, offset=0)[source]

Add two images

PIL.ImageChops.add_modulo(image1, image2)[source]

Add two images without clipping

PIL.ImageChops.blend(image1, image2, alpha)[source]

Blend two images using a constant transparency weight

PIL.ImageChops.composite(image1, image2, mask)[source]

Create composite image by blending images using a transparency mask

PIL.ImageChops.constant(image, value)[source]

Fill a channel with a given grey level

PIL.ImageChops.darker(image1, image2)[source]

Select the darker pixels from each image

PIL.ImageChops.difference(image1, image2)[source]

Subtract one image from another

PIL.ImageChops.duplicate(image)[source]

Create a copy of a channel

PIL.ImageChops.invert(image)[source]

Invert a channel

PIL.ImageChops.lighter(image1, image2)[source]

Select the lighter pixels from each image

PIL.ImageChops.logical_and(image1, image2)[source]

Logical and between two images

PIL.ImageChops.logical_or(image1, image2)[source]

Logical or between two images

PIL.ImageChops.logical_xor(image1, image2)[source]

Logical xor between two images

PIL.ImageChops.multiply(image1, image2)[source]

Superimpose two positive images

PIL.ImageChops.offset(image, xoffset, yoffset=None)[source]

Offset image in horizontal and/or vertical direction

PIL.ImageChops.screen(image1, image2)[source]

Superimpose two negative images

PIL.ImageChops.subtract(image1, image2, scale=1.0, offset=0)[source]

Subtract two images

PIL.ImageChops.subtract_modulo(image1, image2)[source]

Subtract two images without clipping

ImageCms Module

ImageColor Module

PIL.ImageColor.getcolor(color, mode)[source]
PIL.ImageColor.getrgb(color)[source]

ImageDraw Module

PIL.ImageDraw.Draw(im, mode=None)[source]
class PIL.ImageDraw.ImageDraw(im, mode=None)[source]
arc(xy, start, end, fill=None)[source]
bitmap(xy, bitmap, fill=None)[source]
chord(xy, start, end, fill=None, outline=None)[source]
ellipse(xy, fill=None, outline=None)[source]
getfont()[source]
line(xy, fill=None, width=0)[source]
pieslice(xy, start, end, fill=None, outline=None)[source]
point(xy, fill=None)[source]
polygon(xy, fill=None, outline=None)[source]
rectangle(xy, fill=None, outline=None)[source]
setfill(onoff)[source]
setfont(font)[source]
setink(ink)[source]
shape(shape, fill=None, outline=None)[source]
text(xy, text, fill=None, font=None, anchor=None)[source]
textsize(text, font=None)[source]
PIL.ImageDraw.floodfill(image, xy, value, border=None)[source]

Fill bounded region.

PIL.ImageDraw.getdraw(im=None, hints=None)[source]

ImageDraw2 Module

class PIL.ImageDraw2.Brush(color, opacity=255)[source]
class PIL.ImageDraw2.Draw(image, size=None, color=None)[source]
arc(xy, start, end, *options)[source]
chord(xy, start, end, *options)[source]
ellipse(xy, *options)[source]
flush()[source]
line(xy, *options)[source]
pieslice(xy, start, end, *options)[source]
polygon(xy, *options)[source]
rectangle(xy, *options)[source]
render(op, xy, pen, brush=None)[source]
settransform(offset)[source]
symbol(xy, symbol, *options)[source]
text(xy, text, font)[source]
textsize(text, font)[source]
class PIL.ImageDraw2.Font(color, file, size=12)[source]
class PIL.ImageDraw2.Pen(color, width=1, opacity=255)[source]

ImageEnhance Module

class PIL.ImageEnhance.Brightness(image)[source]

Bases: PIL.ImageEnhance._Enhance

Adjust image brightness

class PIL.ImageEnhance.Color(image)[source]

Bases: PIL.ImageEnhance._Enhance

Adjust image colour balance

class PIL.ImageEnhance.Contrast(image)[source]

Bases: PIL.ImageEnhance._Enhance

Adjust image contrast

class PIL.ImageEnhance.Sharpness(image)[source]

Bases: PIL.ImageEnhance._Enhance

Adjust image sharpness

ImageFile Module

class PIL.ImageFile.ImageFile(fp=None, filename=None)[source]

Bases: PIL.Image.Image

Base class for image file format handlers.

draft(mode, size)[source]

Set draft mode

load()[source]

Load image data based on tile list

load_end()[source]
load_prepare()[source]
verify()[source]

Check file integrity

class PIL.ImageFile.Parser[source]
close()[source]
data = None
decoder = None
feed(data)[source]
finished = 0
image = None
incremental = None
reset()[source]
class PIL.ImageFile.StubImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

Base class for stub image loaders.

load()[source]
PIL.ImageFile.raise_ioerror(error)[source]

ImageFileIO Module

class PIL.ImageFileIO.ImageFileIO(fp)[source]

Bases: _io.BytesIO

ImageFilter Module

class PIL.ImageFilter.BLUR[source]

Bases: PIL.ImageFilter.BuiltinFilter

filterargs = ((5, 5), 16, 0, (1, 1, 1, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0, 0, 1, 1, 0, 0, 0, 1, 1, 1, 1, 1, 1))
name = 'Blur'
class PIL.ImageFilter.BuiltinFilter[source]

Bases: PIL.ImageFilter.Kernel

class PIL.ImageFilter.CONTOUR[source]

Bases: PIL.ImageFilter.BuiltinFilter

filterargs = ((3, 3), 1, 255, (-1, -1, -1, -1, 8, -1, -1, -1, -1))
name = 'Contour'
class PIL.ImageFilter.DETAIL[source]

Bases: PIL.ImageFilter.BuiltinFilter

filterargs = ((3, 3), 6, 0, (0, -1, 0, -1, 10, -1, 0, -1, 0))
name = 'Detail'
class PIL.ImageFilter.EDGE_ENHANCE[source]

Bases: PIL.ImageFilter.BuiltinFilter

filterargs = ((3, 3), 2, 0, (-1, -1, -1, -1, 10, -1, -1, -1, -1))
name = 'Edge-enhance'
class PIL.ImageFilter.EDGE_ENHANCE_MORE[source]

Bases: PIL.ImageFilter.BuiltinFilter

filterargs = ((3, 3), 1, 0, (-1, -1, -1, -1, 9, -1, -1, -1, -1))
name = 'Edge-enhance More'
class PIL.ImageFilter.EMBOSS[source]

Bases: PIL.ImageFilter.BuiltinFilter

filterargs = ((3, 3), 1, 128, (-1, 0, 0, 0, 1, 0, 0, 0, 0))
name = 'Emboss'
class PIL.ImageFilter.FIND_EDGES[source]

Bases: PIL.ImageFilter.BuiltinFilter

filterargs = ((3, 3), 1, 0, (-1, -1, -1, -1, 8, -1, -1, -1, -1))
name = 'Find Edges'
class PIL.ImageFilter.Filter[source]

Bases: object

class PIL.ImageFilter.GaussianBlur(radius=2)[source]

Bases: PIL.ImageFilter.Filter

filter(image)[source]
name = 'GaussianBlur'
class PIL.ImageFilter.Kernel(size, kernel, scale=None, offset=0)[source]

Bases: PIL.ImageFilter.Filter

filter(image)[source]
class PIL.ImageFilter.MaxFilter(size=3)[source]

Bases: PIL.ImageFilter.RankFilter

name = 'Max'
class PIL.ImageFilter.MedianFilter(size=3)[source]

Bases: PIL.ImageFilter.RankFilter

name = 'Median'
class PIL.ImageFilter.MinFilter(size=3)[source]

Bases: PIL.ImageFilter.RankFilter

name = 'Min'
class PIL.ImageFilter.ModeFilter(size=3)[source]

Bases: PIL.ImageFilter.Filter

filter(image)[source]
name = 'Mode'
class PIL.ImageFilter.RankFilter(size, rank)[source]

Bases: PIL.ImageFilter.Filter

filter(image)[source]
name = 'Rank'
class PIL.ImageFilter.SHARPEN[source]

Bases: PIL.ImageFilter.BuiltinFilter

filterargs = ((3, 3), 16, 0, (-2, -2, -2, -2, 32, -2, -2, -2, -2))
name = 'Sharpen'
class PIL.ImageFilter.SMOOTH[source]

Bases: PIL.ImageFilter.BuiltinFilter

filterargs = ((3, 3), 13, 0, (1, 1, 1, 1, 5, 1, 1, 1, 1))
name = 'Smooth'
class PIL.ImageFilter.SMOOTH_MORE[source]

Bases: PIL.ImageFilter.BuiltinFilter

filterargs = ((5, 5), 100, 0, (1, 1, 1, 1, 1, 1, 5, 5, 5, 1, 1, 5, 44, 5, 1, 1, 5, 5, 5, 1, 1, 1, 1, 1, 1))
name = 'Smooth More'
class PIL.ImageFilter.UnsharpMask(radius=2, percent=150, threshold=3)[source]

Bases: PIL.ImageFilter.Filter

filter(image)[source]
name = 'UnsharpMask'

ImageFont Module

class PIL.ImageFont.FreeTypeFont(file, size, index=0, encoding='')[source]

FreeType font wrapper (requires _imagingft service)

getmask(text, mode='')[source]
getmask2(text, mode='', fill=<built-in function fill>)[source]
getmetrics()[source]
getname()[source]
getsize(text)[source]
class PIL.ImageFont.ImageFont[source]

PIL font wrapper

class PIL.ImageFont.TransposedFont(font, orientation=None)[source]

Wrapper for writing rotated or mirrored text

getmask(text, mode='')[source]
getsize(text)[source]
PIL.ImageFont.load(filename)[source]

Load a font file.

PIL.ImageFont.load_default()[source]

Load a default font.

PIL.ImageFont.load_path(filename)[source]

Load a font file, searching along the Python path.

PIL.ImageFont.truetype(filename, size, index=0, encoding='')[source]

Load a truetype font file.

ImageMath Module

PIL.ImageMath.eval(expression, _dict={}, **kw)[source]
PIL.ImageMath.imagemath_convert(self, mode)[source]
PIL.ImageMath.imagemath_equal(self, other)[source]
PIL.ImageMath.imagemath_float(self)[source]
PIL.ImageMath.imagemath_int(self)[source]
PIL.ImageMath.imagemath_max(self, other)[source]
PIL.ImageMath.imagemath_min(self, other)[source]
PIL.ImageMath.imagemath_notequal(self, other)[source]
PIL.ImageMath.v(self, other)

ImageMode Module

class PIL.ImageMode.ModeDescriptor(mode, bands, basemode, basetype)[source]
PIL.ImageMode.getmode(mode)[source]

ImageOps Module

PIL.ImageOps.autocontrast(image, cutoff=0, ignore=None)[source]

Maximize image contrast, based on histogram

PIL.ImageOps.colorize(image, black, white)[source]

Colorize a grayscale image

PIL.ImageOps.crop(image, border=0)[source]

Crop border off image

PIL.ImageOps.deform(image, deformer, resample=2)[source]

Deform image using the given deformer

PIL.ImageOps.equalize(image, mask=None)[source]

Equalize image histogram

PIL.ImageOps.expand(image, border=0, fill=0)[source]

Add border to image

PIL.ImageOps.fit(image, size, method=0, bleed=0.0, centering=(0.5, 0.5))[source]

This method returns a sized and cropped version of the image, cropped to the aspect ratio and size that you request.

PIL.ImageOps.flip(image)[source]

Flip image vertically

PIL.ImageOps.gaussian_blur(im, radius=None)[source]

PIL_usm.gblur(im, [radius])

PIL.ImageOps.gblur(im[, radius])
PIL.ImageOps.grayscale(image)[source]

Convert to grayscale

PIL.ImageOps.invert(image)[source]

Invert image (negate)

PIL.ImageOps.mirror(image)[source]

Flip image horizontally

PIL.ImageOps.posterize(image, bits)[source]

Reduce the number of bits per color channel

PIL.ImageOps.solarize(image, threshold=128)[source]

Invert all values above threshold

PIL.ImageOps.unsharp_mask(im, radius=None, percent=None, threshold=None)[source]

PIL_usm.usm(im, [radius, percent, threshold])

PIL.ImageOps.usm(im[, radius, percent, threshold])

ImagePalette Module

class PIL.ImagePalette.ImagePalette(mode='RGB', palette=None)[source]

Colour palette for palette mapped images

getcolor(color)[source]
getdata()[source]
save(fp)[source]
tobytes()[source]
tostring()
PIL.ImagePalette.load(filename)[source]
PIL.ImagePalette.negative(mode='RGB')[source]
PIL.ImagePalette.new(mode, data)[source]
PIL.ImagePalette.random(mode='RGB')[source]
PIL.ImagePalette.raw(rawmode, data)[source]
PIL.ImagePalette.sepia(white='#fff0c0')[source]
PIL.ImagePalette.wedge(mode='RGB')[source]

ImagePath Module

ImageQt Module

class PIL.ImageQt.ImageQt(im)[source]

Bases: PyQt4.QtGui.QImage

PIL.ImageQt.rgb(r, g, b)[source]

ImageSequence Module

class PIL.ImageSequence.Iterator(im)[source]

ImageShow Module

class PIL.ImageShow.DisplayViewer[source]

Bases: PIL.ImageShow.UnixViewer

get_command_ex(file, **options)[source]
class PIL.ImageShow.UnixViewer[source]

Bases: PIL.ImageShow.Viewer

show_file(file, **options)[source]
class PIL.ImageShow.Viewer[source]
format = None
get_command(file, **options)[source]
get_format(image)[source]
save_image(image)[source]
show(image, **options)[source]
show_file(file, **options)[source]
show_image(image, **options)[source]
class PIL.ImageShow.XVViewer[source]

Bases: PIL.ImageShow.UnixViewer

get_command_ex(file, title=None, **options)[source]
PIL.ImageShow.register(viewer, order=1)[source]
PIL.ImageShow.show(image, title=None, **options)[source]
PIL.ImageShow.which(executable)[source]

ImageStat Module

PIL.ImageStat.Global

alias of Stat

class PIL.ImageStat.Stat(image_or_list, mask=None)[source]

Get image or feature statistics

ImageTk Module

class PIL.ImageTk.BitmapImage(image=None, **kw)[source]
height()[source]
width()[source]
class PIL.ImageTk.PhotoImage(image=None, size=None, **kw)[source]
height()[source]
paste(im, box=None)[source]
width()[source]
PIL.ImageTk.getimage(photo)[source]

ImageTransform Module

class PIL.ImageTransform.AffineTransform(data)[source]

Bases: PIL.ImageTransform.Transform

method = 0
class PIL.ImageTransform.ExtentTransform(data)[source]

Bases: PIL.ImageTransform.Transform

method = 1
class PIL.ImageTransform.MeshTransform(data)[source]

Bases: PIL.ImageTransform.Transform

method = 4
class PIL.ImageTransform.QuadTransform(data)[source]

Bases: PIL.ImageTransform.Transform

method = 3
class PIL.ImageTransform.Transform(data)[source]

Bases: PIL.Image.ImageTransformHandler

getdata()[source]
transform(size, image, **options)[source]

ImageWin Module

class PIL.ImageWin.Dib(image, size=None)[source]
draw(handle, dst, src=None)[source]
expose(handle)[source]
frombytes(buffer)[source]
fromstring(*args, **kw)[source]
paste(im, box=None)[source]
query_palette(handle)[source]
tobytes()[source]
tostring()[source]
class PIL.ImageWin.HDC(dc)[source]
class PIL.ImageWin.HWND(wnd)[source]
class PIL.ImageWin.ImageWindow(image, title='PIL')[source]

Bases: PIL.ImageWin.Window

ui_handle_repair(dc, x0, y0, x1, y1)[source]
class PIL.ImageWin.Window(title='PIL', width=None, height=None)[source]
mainloop()[source]
ui_handle_clear(dc, x0, y0, x1, y1)[source]
ui_handle_damage(x0, y0, x1, y1)[source]
ui_handle_destroy()[source]
ui_handle_repair(dc, x0, y0, x1, y1)[source]
ui_handle_resize(width, height)[source]

ImtImagePlugin Module

class PIL.ImtImagePlugin.ImtImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'IMT'
format_description = 'IM Tools'

IptcImagePlugin Module

class PIL.IptcImagePlugin.IptcImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

field()[source]
format = 'IPTC'
format_description = 'IPTC/NAA'
getint(key)[source]
load()[source]
PIL.IptcImagePlugin.dump(c)[source]
PIL.IptcImagePlugin.getiptcinfo(im)[source]
PIL.IptcImagePlugin.i(c)[source]

JpegImagePlugin Module

PIL.JpegImagePlugin.APP(self, marker)[source]
PIL.JpegImagePlugin.COM(self, marker)[source]
PIL.JpegImagePlugin.DQT(self, marker)[source]
class PIL.JpegImagePlugin.JpegImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

draft(mode, size)[source]
format = 'JPEG'
format_description = 'JPEG (ISO 10918)'
load_djpeg()[source]
PIL.JpegImagePlugin.SOF(self, marker)[source]
PIL.JpegImagePlugin.Skip(self, marker)[source]
PIL.JpegImagePlugin.convert_dict_qtables(qtables)[source]
PIL.JpegImagePlugin.get_sampling(im)[source]

JpegPresets Module

JPEG quality settings equivalent to the Photoshop settings.

More presets can be added to the presets dict if needed.

Can be use when saving JPEG file.

To apply the preset, specify:

quality="preset_name"

To apply only the quantization table:

qtables="preset_name"

To apply only the subsampling setting:

subsampling="preset_name"

Example:

im.save("image_name.jpg", quality="web_high")

Subsampling

Subsampling is the practice of encoding images by implementing less resolution for chroma information than for luma information. (ref.: http://en.wikipedia.org/wiki/Chroma_subsampling)

Possible subsampling values are 0, 1 and 2 that correspond to 4:4:4, 4:2:2 and 4:1:1 (or 4:2:0?).

You can get the subsampling of a JPEG with the JpegImagePlugin.get_subsampling(im) function.

Quantization tables

They are values use by the DCT (Discrete cosine transform) to remove unnecessary information from the image (the lossy part of the compression). (ref.: http://en.wikipedia.org/wiki/Quantization_matrix#Quantization_matrices, http://en.wikipedia.org/wiki/JPEG#Quantization)

You can get the quantization tables of a JPEG with:

im.quantization

This will return a dict with a number of arrays. You can pass this dict directly as the qtables argument when saving a JPEG.

The tables format between im.quantization and quantization in presets differ in 3 ways:

  1. The base container of the preset is a list with sublists instead of dict. dict[0] -> list[0], dict[1] -> list[1], ...
  2. Each table in a preset is a list instead of an array.
  3. The zigzag order is remove in the preset (needed by libjpeg >= 6a).

You can convert the dict format to the preset format with the JpegImagePlugin.convert_dict_qtables(dict_qtables) function.

Libjpeg ref.: http://www.jpegcameras.com/libjpeg/libjpeg-3.html

McIdasImagePlugin Module

class PIL.McIdasImagePlugin.McIdasImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'MCIDAS'
format_description = 'McIdas area file'

MicImagePlugin Module

class PIL.MicImagePlugin.MicImageFile(fp=None, filename=None)[source]

Bases: PIL.TiffImagePlugin.TiffImageFile

format = 'MIC'
format_description = 'Microsoft Image Composer'
seek(frame)[source]
tell()[source]

MpegImagePlugin Module

class PIL.MpegImagePlugin.BitStream(fp)[source]
next()[source]
peek(bits)[source]
read(bits)[source]
skip(bits)[source]
class PIL.MpegImagePlugin.MpegImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'MPEG'
format_description = 'MPEG'

MspImagePlugin Module

class PIL.MspImagePlugin.MspImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'MSP'
format_description = 'Windows Paint'

OleFileIO Module

class PIL.OleFileIO.OleFileIO(filename=None)[source]

OLE container object

This class encapsulates the interface to an OLE 2 structured storage file. Use the listdir and openstream methods to access the contents of this file.

Object names are given as a list of strings, one for each subentry level. The root entry should be omitted. For example, the following code extracts all image streams from a Microsoft Image Composer file:

ole = OleFileIO("fan.mic")

for entry in ole.listdir():
    if entry[1:2] == "Image":
        fin = ole.openstream(entry)
        fout = open(entry[0:1], "wb")
        while 1:
            s = fin.read(8192)
            if not s:
                break
            fout.write(s)

You can use the viewer application provided with the Python Imaging Library to view the resulting files (which happens to be standard TIFF files).

dumpdirectory()[source]
getproperties(filename)[source]

Return properties described in substream

getsect(sect)[source]
listdir()[source]

Return a list of streams stored in this file

loaddirectory(sect)[source]
loadfat(header)[source]
loadminifat()[source]
open(filename)[source]

Open an OLE2 file

openstream(filename)[source]

Open a stream as a read-only file object

PSDraw Module

class PIL.PSDraw.PSDraw(fp=None)[source]
begin_document(id=None)[source]

Write Postscript DSC header

end_document()[source]

Write Postscript DSC footer

image(box, im, dpi=None)[source]

Write an PIL image

line(xy0, xy1)[source]
rectangle(box)[source]
setfont(font, size)[source]
setink(ink)[source]
text(xy, text)[source]

PaletteFile Module

class PIL.PaletteFile.PaletteFile(fp)[source]
getpalette()[source]
rawmode = 'RGB'

PalmImagePlugin Module

PIL.PalmImagePlugin.build_prototype_image()[source]

PcdImagePlugin Module

class PIL.PcdImagePlugin.PcdImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

draft(mode, size)[source]
format = 'PCD'
format_description = 'Kodak PhotoCD'

PcfFontFile Module

class PIL.PcfFontFile.PcfFontFile(fp)[source]

Bases: PIL.FontFile.FontFile

name = 'name'
PIL.PcfFontFile.sz(s, o)[source]

PcxImagePlugin Module

class PIL.PcxImagePlugin.PcxImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'PCX'
format_description = 'Paintbrush'

PdfImagePlugin Module

PixarImagePlugin Module

class PIL.PixarImagePlugin.PixarImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'PIXAR'
format_description = 'PIXAR raster image'

PngImagePlugin Module

class PIL.PngImagePlugin.ChunkStream(fp)[source]
call(cid, pos, len)[source]

Call the appropriate chunk handler

close()[source]
crc(cid, data)[source]

Read and verify checksum

crc_skip(cid, data)[source]

Read checksum. Used if the C module is not present

push(cid, pos, len)[source]
read()[source]

Fetch a new chunk. Returns header information.

verify(endchunk='IEND')[source]
class PIL.PngImagePlugin.PngImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'PNG'
format_description = 'Portable network graphics'
load_end()[source]

internal: finished reading image data

load_prepare()[source]

internal: prepare to read PNG file

load_read(bytes)[source]

internal: read more image data

verify()[source]

Verify PNG file

class PIL.PngImagePlugin.PngInfo[source]
add(cid, data)[source]
add_text(key, value, zip=0)[source]
class PIL.PngImagePlugin.PngStream(fp)[source]

Bases: PIL.PngImagePlugin.ChunkStream

chunk_IDAT(pos, len)[source]
chunk_IEND(pos, len)[source]
chunk_IHDR(pos, len)[source]
chunk_PLTE(pos, len)[source]
chunk_gAMA(pos, len)[source]
chunk_iCCP(pos, len)[source]
chunk_pHYs(pos, len)[source]
chunk_tEXt(pos, len)[source]
chunk_tRNS(pos, len)[source]
chunk_zTXt(pos, len)[source]
PIL.PngImagePlugin.getchunks(im, **params)[source]

Return a list of PNG chunks representing this image.

PIL.PngImagePlugin.is_cid()

match(string[, pos[, endpos]]) –> match object or None. Matches zero or more characters at the beginning of the string

PIL.PngImagePlugin.putchunk(fp, cid, *data)[source]

Write a PNG chunk (including CRC field)

PpmImagePlugin Module

class PIL.PpmImagePlugin.PpmImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'PPM'
format_description = 'Pbmplus image'

PsdImagePlugin Module

class PIL.PsdImagePlugin.PsdImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'PSD'
format_description = 'Adobe Photoshop'
load_prepare()[source]
seek(layer)[source]
tell()[source]

SgiImagePlugin Module

class PIL.SgiImagePlugin.SgiImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'SGI'
format_description = 'SGI Image File Format'

SpiderImagePlugin Module

class PIL.SpiderImagePlugin.SpiderImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

convert2byte(depth=255)[source]
format = 'SPIDER'
format_description = 'Spider 2D image'
seek(frame)[source]
tell()[source]
tkPhotoImage()[source]
PIL.SpiderImagePlugin.isInt(f)[source]
PIL.SpiderImagePlugin.isSpiderHeader(t)[source]
PIL.SpiderImagePlugin.isSpiderImage(filename)[source]
PIL.SpiderImagePlugin.loadImageSeries(filelist=None)[source]

create a list of Image.images for use in montage

PIL.SpiderImagePlugin.makeSpiderHeader(im)[source]

SunImagePlugin Module

class PIL.SunImagePlugin.SunImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'SUN'
format_description = 'Sun Raster File'

TarIO Module

class PIL.TarIO.TarIO(tarfile, file)[source]

Bases: PIL.ContainerIO.ContainerIO

TgaImagePlugin Module

class PIL.TgaImagePlugin.TgaImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'TGA'
format_description = 'Targa'

TiffImagePlugin Module

class PIL.TiffImagePlugin.ImageFileDirectory(prefix)[source]

Bases: _abcoll.MutableMapping

as_dict()[source]

Return a dictionary of the image’s tags.

getscalar(tag, default=None)[source]
has_key(tag)[source]
items()[source]
load(fp)[source]
load_byte(data)[source]
load_dispatch = {1: (1, <function load_byte at 0xf298fdbc>), 2: (1, <function load_string at 0xf298fdf4>), 3: (2, <function load_short at 0xf298fe2c>), 4: (4, <function load_long at 0xf298fe64>), 5: (8, <function load_rational at 0xf298fe9c>), 7: (1, <function load_undefined at 0xf298ff44>), 11: (4, <function load_float at 0xf298fed4>), 12: (8, <function load_double at 0xf298ff0c>)}
load_double(data)[source]
load_float(data)[source]
load_long(data)[source]
load_rational(data)[source]
load_short(data)[source]
load_string(data)[source]
load_undefined(data)[source]
named()[source]

Returns the complete tag dictionary, with named tags where posible.

reset()[source]
save(fp)[source]
class PIL.TiffImagePlugin.TiffImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'TIFF'
format_description = 'Adobe TIFF'
seek(frame)[source]

Select a given frame as current image

tell()[source]

Return the current frame number

TiffTags Module

WalImageFile Module

PIL.WalImageFile.open(filename)[source]

WebPImagePlugin Module

class PIL.WebPImagePlugin.WebPImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'WEBP'
format_description = 'WebP image'

WmfImagePlugin Module

class PIL.WmfImagePlugin.WmfStubImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.StubImageFile

format = 'WMF'
format_description = 'Windows Metafile'
PIL.WmfImagePlugin.register_handler(handler)[source]
PIL.WmfImagePlugin.short(c, o=0)[source]

XVThumbImagePlugin Module

class PIL.XVThumbImagePlugin.XVThumbImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'XVThumb'
format_description = 'XV thumbnail image'

XbmImagePlugin Module

class PIL.XbmImagePlugin.XbmImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'XBM'
format_description = 'X11 Bitmap'

XpmImagePlugin Module

class PIL.XpmImagePlugin.XpmImageFile(fp=None, filename=None)[source]

Bases: PIL.ImageFile.ImageFile

format = 'XPM'
format_description = 'X11 Pixel Map'
load_read(bytes)[source]

_binary Module

PIL._binary.i16be(c, o=0)[source]
PIL._binary.i16le(c, o=0)[source]
PIL._binary.i32be(c, o=0)[source]
PIL._binary.i32le(c, o=0)[source]
PIL._binary.i8(c)[source]
PIL._binary.o16be(i)[source]
PIL._binary.o16le(i)[source]
PIL._binary.o32be(i)[source]
PIL._binary.o32le(i)[source]
PIL._binary.o8(i)[source]

Table Of Contents

Previous topic

Welcome to Pillow (PIL fork)’s documentation!

This Page