Plugin reference¶

BmpImagePlugin Module¶

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

Bases: PIL.ImageFile.ImageFile

Image plugin for the Windows Bitmap format (BMP)

BITFIELDS = 3¶

COMPRESSIONS = {'JPEG': 4, 'RLE4': 2, 'BITFIELDS': 3, 'RLE8': 1, 'PNG': 5, 'RAW': 0}¶

JPEG = 4¶

PNG = 5¶

RAW = 0¶

RLE4 = 2¶

RLE8 = 1¶

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]¶

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'¶

is_animated¶

n_frames¶

seek(frame)¶

tell()¶

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(scale=1)[source]¶

load_seek(*args, **kwargs)[source]¶

mode_map = {1: 'L', 2: 'LAB', 3: 'RGB'}¶

PIL.EpsImagePlugin.Ghostscript(tile, size, fp, scale=1)[source]¶

Render an image using Ghostscript

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

Bases: object

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

readline()[source]¶

seek(offset, whence=0)[source]¶

PIL.EpsImagePlugin.has_ghostscript()[source]¶

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'¶

is_animated¶

n_frames¶

seek(frame)¶

tell()¶

FpxImagePlugin Module¶

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

Bases: PIL.ImageFile.ImageFile

format = 'FPX'¶

format_description = 'FlashPix'¶

load()¶

GbrImagePlugin Module¶

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

Bases: PIL.ImageFile.ImageFile

format = 'GBR'¶

format_description = 'GIMP brush file'¶

load()¶

GifImagePlugin Module¶

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

Bases: PIL.ImageFile.ImageFile

data()¶

format = 'GIF'¶

format_description = 'Compuserve GIF'¶

global_palette = None¶

is_animated¶

load_end()¶

n_frames¶

seek(frame)¶

tell()¶

PIL.GifImagePlugin.get_interlace(im)[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

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]¶

Bases: object

SIZES = {(32, 32, 2): [(b'ic12', <function read_png_or_jpeg2000 at 0xf5577bfc>)], (256, 256, 1): [(b'ic08', <function read_png_or_jpeg2000 at 0xf5577bfc>)], (128, 128, 2): [(b'ic13', <function read_png_or_jpeg2000 at 0xf5577bfc>)], (64, 64, 1): [(b'icp6', <function read_png_or_jpeg2000 at 0xf5577bfc>)], (128, 128, 1): [(b'ic07', <function read_png_or_jpeg2000 at 0xf5577bfc>), (b'it32', <function read_32t at 0xf557777c>), (b't8mk', <function read_mk at 0xf5577bb4>)], (256, 256, 2): [(b'ic14', <function read_png_or_jpeg2000 at 0xf5577bfc>)], (32, 32, 1): [(b'icp5', <function read_png_or_jpeg2000 at 0xf5577bfc>), (b'il32', <function read_32 at 0xf5577b6c>), (b'l8mk', <function read_mk at 0xf5577bb4>)], (48, 48, 1): [(b'ih32', <function read_32 at 0xf5577b6c>), (b'h8mk', <function read_mk at 0xf5577bb4>)], (16, 16, 1): [(b'icp4', <function read_png_or_jpeg2000 at 0xf5577bfc>), (b'is32', <function read_32 at 0xf5577b6c>), (b's8mk', <function read_mk at 0xf5577bb4>)], (16, 16, 2): [(b'ic11', <function read_png_or_jpeg2000 at 0xf5577bfc>)], (512, 512, 1): [(b'ic09', <function read_png_or_jpeg2000 at 0xf5577bfc>)], (512, 512, 2): [(b'ic10', <function read_png_or_jpeg2000 at 0xf5577bfc>)]}¶

bestsize()¶

dataforsize(size)¶

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

itersizes()¶

class PIL.IcnsImagePlugin.IcnsImageFile(fp=None, filename=None)[source]¶

Bases: PIL.ImageFile.ImageFile

PIL 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]¶

PIL.IcnsImagePlugin.read_png_or_jpeg2000(fobj, start_length, size)[source]¶

IcoImagePlugin Module¶

class PIL.IcoImagePlugin.IcoFile(buf)[source]¶

Bases: object

frame(idx)[source]¶

Get an image from frame idx

getimage(size, bpp=False)[source]¶

Get an image from the icon

sizes()[source]¶

Get a list of all available icon sizes and color depths.

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

Bases: PIL.ImageFile.ImageFile

PIL read-only image support for Microsoft Windows .ico files.

By default the largest resolution image in the file will be loaded. This can be changed by altering the ‘size’ attribute before calling ‘load’.

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

Handles classic, XP and Vista icon formats.

This plugin is a refactored version of Win32IconImagePlugin by Bryan Davis <casadebender@gmail.com>. https://code.google.com/p/casadebender/wiki/Win32IconImagePlugin

format = 'ICO'¶

format_description = 'Windows Icon'¶

load()[source]¶

load_seek()[source]¶

ImImagePlugin Module¶

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

Bases: PIL.ImageFile.ImageFile

format = 'IM'¶

format_description = 'IFUNC Image Memory'¶

is_animated¶

n_frames¶

seek(frame)¶

tell()¶

PIL.ImImagePlugin.number(s)[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()¶

format = 'IPTC'¶

format_description = 'IPTC/NAA'¶

getint(key)¶

load()¶

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

format = 'JPEG'¶

format_description = 'JPEG (ISO 10918)'¶

load_djpeg()¶

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]¶

PIL.JpegImagePlugin.jpeg_factory(fp=None, filename=None)[source]¶

Jpeg2KImagePlugin Module¶

class PIL.Jpeg2KImagePlugin.Jpeg2KImageFile(fp=None, filename=None)[source]¶

Bases: PIL.ImageFile.ImageFile

format = 'JPEG2000'¶

format_description = 'JPEG 2000 (ISO 15444)'¶

load()[source]¶

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'¶

is_animated¶

n_frames¶

seek(frame)¶

tell()¶

MpegImagePlugin Module¶

class PIL.MpegImagePlugin.BitStream(fp)[source]¶

Bases: object

next()¶

peek(bits)¶

read(bits)¶

skip(bits)¶

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'¶

PalmImagePlugin Module¶

PIL.PalmImagePlugin.build_prototype_image()[source]¶

PcdImagePlugin Module¶

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

Bases: PIL.ImageFile.ImageFile

format = 'PCD'¶

format_description = 'Kodak PhotoCD'¶

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]¶

Bases: object

call(cid, pos, length)¶

Call the appropriate chunk handler

close()¶

crc(cid, data)¶

Read and verify checksum

crc_skip(cid, data)¶

Read checksum. Used if the C module is not present

push(cid, pos, length)¶

read()¶

Fetch a new chunk. Returns header information.

verify(endchunk=b'IEND')¶

class PIL.PngImagePlugin.PngImageFile(fp=None, filename=None)[source]¶

Bases: PIL.ImageFile.ImageFile

format = 'PNG'¶

format_description = 'Portable network graphics'¶

load_end()¶

internal: finished reading image data

load_prepare()¶

internal: prepare to read PNG file

load_read(read_bytes)¶

internal: read more image data

verify()¶

Verify PNG file

class PIL.PngImagePlugin.PngInfo[source]¶

Bases: object

PNG chunk container (for use with save(pnginfo=))

add(cid, data)[source]¶

Appends an arbitrary chunk. Use with caution.

Parameters:	cid – a byte string, 4 bytes long. data – a byte string of the encoded data

add_itxt(key, value, lang='', tkey='', zip=False)[source]¶

Appends an iTXt chunk.

Parameters:	key – latin-1 encodable text key name value – value for this key lang – language code tkey – UTF-8 version of the key name zip – compression flag

add_text(key, value, zip=0)[source]¶

Appends a text chunk.

Parameters:	key – latin-1 encodable text key name value – value for this key, text or an PIL.PngImagePlugin.iTXt instance zip – compression flag

class PIL.PngImagePlugin.PngStream(fp)[source]¶

Bases: PIL.PngImagePlugin.ChunkStream

check_text_memory(chunklen)¶

chunk_IDAT(pos, length)¶

chunk_IEND(pos, length)¶

chunk_IHDR(pos, length)¶

chunk_PLTE(pos, length)¶

chunk_gAMA(pos, length)¶

chunk_iCCP(pos, length)¶

chunk_iTXt(pos, length)¶

chunk_pHYs(pos, length)¶

chunk_tEXt(pos, length)¶

chunk_tRNS(pos, length)¶

chunk_zTXt(pos, length)¶

PIL.PngImagePlugin.getchunks(im, **params)[source]¶

Return a list of PNG chunks representing this image.

class PIL.PngImagePlugin.iTXt[source]¶

Bases: str

Subclass of string to allow iTXt chunks to look like strings while keeping their extra information

PIL.PngImagePlugin.is_cid()¶

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'¶

is_animated¶

load_prepare()¶

n_frames¶

seek(layer)¶

tell()¶

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

format = 'SPIDER'¶

format_description = 'Spider 2D image'¶

is_animated¶

n_frames¶

seek(frame)¶

tell()¶

tkPhotoImage()¶

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'¶

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=b'II')[source]¶

Bases: collections.abc.MutableMapping

This class represents a TIFF tag directory. To speed things up, we don’t decode tags unless they’re asked for.

Exposes a dictionary interface of the tags in the directory ImageFileDirectory[key] = value value = ImageFileDirectory[key]

Also contains a dictionary of tag types as read from the tiff image file, ‘ImageFileDirectory.tagtype’

Data Structures: ‘public’ * self.tagtype = {} Key: numerical tiff tag number

Value: integer corresponding to the data type from TiffTags.TYPES

‘internal’ * self.tags = {} Key: numerical tiff tag number

Value: Decoded data, Generally a tuple.

• If set from __setval__ – always a tuple
• Numeric types – always a tuple
• String type – not a tuple, returned as string
• Undefined data – not a tuple, returned as bytes
• Byte – not a tuple, returned as byte.

• self.tagdata = {} Key: numerical tiff tag number

  Value: undecoded byte string from file

Tags will be found in either self.tags or self.tagdata, but not both. The union of the two should contain all the tags from the Tiff image file. External classes shouldn’t reference these unless they’re really sure what they’re doing.

as_dict()[source]¶

Return a dictionary of the image’s tags.

getscalar(tag, default=None)[source]¶

items()[source]¶

load(fp)[source]¶

load_byte(data)[source]¶

load_dispatch = {1: (1, <function ImageFileDirectory.load_byte at 0xf5413854>), 2: (1, <function ImageFileDirectory.load_string at 0xf541389c>), 3: (2, <function ImageFileDirectory.load_short at 0xf54138e4>), 4: (4, <function ImageFileDirectory.load_long at 0xf541392c>), 5: (8, <function ImageFileDirectory.load_rational at 0xf5413974>), 7: (1, <function ImageFileDirectory.load_undefined at 0xf5413a4c>), 11: (4, <function ImageFileDirectory.load_float at 0xf54139bc>), 12: (8, <function ImageFileDirectory.load_double at 0xf5413a04>)}¶

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 possible.

reset()[source]¶

save(fp)[source]¶

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

Bases: PIL.ImageFile.ImageFile

format = 'TIFF'¶

format_description = 'Adobe TIFF'¶

is_animated¶

n_frames¶

seek(frame)¶

Select a given frame as current image

tell()¶

Return the current frame number

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