Plugin reference

BmpImagePlugin Module

class PIL.BmpImagePlugin.BmpImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

Image plugin for the Windows Bitmap format (BMP)

BITFIELDS = 3
COMPRESSIONS = {'PNG': 5, 'BITFIELDS': 3, 'RLE8': 1, 'RAW': 0, 'RLE4': 2, 'JPEG': 4}
JPEG = 4
PNG = 5
RAW = 0
RLE4 = 2
RLE8 = 1
format = 'BMP'
format_description = 'Windows Bitmap'
class PIL.BmpImagePlugin.DibImageFile(fp=None, filename=None)[源代码]

基类:PIL.BmpImagePlugin.BmpImageFile

format = 'DIB'
format_description = 'Windows Bitmap'

BufrStubImagePlugin Module

class PIL.BufrStubImagePlugin.BufrStubImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.StubImageFile

format = 'BUFR'
format_description = 'BUFR'
PIL.BufrStubImagePlugin.register_handler(handler)[源代码]

CurImagePlugin Module

class PIL.CurImagePlugin.CurImageFile(fp=None, filename=None)[源代码]

基类:PIL.BmpImagePlugin.BmpImageFile

format = 'CUR'
format_description = 'Windows Cursor'

DcxImagePlugin Module

class PIL.DcxImagePlugin.DcxImageFile(fp=None, filename=None)[源代码]

基类: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)[源代码]

基类:PIL.ImageFile.ImageFile

EPS File Parser for the Python Imaging Library

format = 'EPS'
format_description = 'Encapsulated Postscript'
load(scale=1)[源代码]
load_seek(*args, **kwargs)[源代码]
mode_map = {1: 'L', 2: 'LAB', 3: 'RGB'}
PIL.EpsImagePlugin.Ghostscript(tile, size, fp, scale=1)[源代码]

Render an image using Ghostscript

class PIL.EpsImagePlugin.PSFile(fp)[源代码]

基类:object

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

readline()[源代码]
seek(offset, whence=0)[源代码]
PIL.EpsImagePlugin.has_ghostscript()[源代码]

FitsStubImagePlugin Module

class PIL.FitsStubImagePlugin.FITSStubImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.StubImageFile

format = 'FITS'
format_description = 'FITS'
PIL.FitsStubImagePlugin.register_handler(handler)[源代码]

FliImagePlugin Module

class PIL.FliImagePlugin.FliImageFile(fp=None, filename=None)[源代码]

基类: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)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'FPX'
format_description = 'FlashPix'
load()[源代码]

GbrImagePlugin Module

class PIL.GbrImagePlugin.GbrImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'GBR'
format_description = 'GIMP brush file'
load()[源代码]

GifImagePlugin Module

class PIL.GifImagePlugin.GifImageFile(fp=None, filename=None)[源代码]

基类: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)[源代码]
PIL.GifImagePlugin.getdata(im, offset=(0, 0), **params)[源代码]

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)[源代码]

Return a list of strings representing a GIF header

GribStubImagePlugin Module

class PIL.GribStubImagePlugin.GribStubImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.StubImageFile

format = 'GRIB'
format_description = 'GRIB'
PIL.GribStubImagePlugin.register_handler(handler)[源代码]

Hdf5StubImagePlugin Module

class PIL.Hdf5StubImagePlugin.HDF5StubImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.StubImageFile

format = 'HDF5'
format_description = 'HDF5'
PIL.Hdf5StubImagePlugin.register_handler(handler)[源代码]

IcnsImagePlugin Module

class PIL.IcnsImagePlugin.IcnsFile(fobj)[源代码]

基类:object

SIZES = {(32, 32, 2): [(b'ic12', <function read_png_or_jpeg2000 at 0x7f44765d1378>)], (256, 256, 1): [(b'ic08', <function read_png_or_jpeg2000 at 0x7f44765d1378>)], (128, 128, 2): [(b'ic13', <function read_png_or_jpeg2000 at 0x7f44765d1378>)], (64, 64, 1): [(b'icp6', <function read_png_or_jpeg2000 at 0x7f44765d1378>)], (128, 128, 1): [(b'ic07', <function read_png_or_jpeg2000 at 0x7f44765d1378>), (b'it32', <function read_32t at 0x7f44765d11e0>), (b't8mk', <function read_mk at 0x7f44765d12f0>)], (256, 256, 2): [(b'ic14', <function read_png_or_jpeg2000 at 0x7f44765d1378>)], (32, 32, 1): [(b'icp5', <function read_png_or_jpeg2000 at 0x7f44765d1378>), (b'il32', <function read_32 at 0x7f44765d1268>), (b'l8mk', <function read_mk at 0x7f44765d12f0>)], (48, 48, 1): [(b'ih32', <function read_32 at 0x7f44765d1268>), (b'h8mk', <function read_mk at 0x7f44765d12f0>)], (16, 16, 1): [(b'icp4', <function read_png_or_jpeg2000 at 0x7f44765d1378>), (b'is32', <function read_32 at 0x7f44765d1268>), (b's8mk', <function read_mk at 0x7f44765d12f0>)], (16, 16, 2): [(b'ic11', <function read_png_or_jpeg2000 at 0x7f44765d1378>)], (512, 512, 1): [(b'ic09', <function read_png_or_jpeg2000 at 0x7f44765d1378>)], (512, 512, 2): [(b'ic10', <function read_png_or_jpeg2000 at 0x7f44765d1378>)]}
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)[源代码]

基类: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()[源代码]
PIL.IcnsImagePlugin.nextheader(fobj)[源代码]
PIL.IcnsImagePlugin.read_32(fobj, start_length, size)[源代码]

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)[源代码]
PIL.IcnsImagePlugin.read_mk(fobj, start_length, size)[源代码]
PIL.IcnsImagePlugin.read_png_or_jpeg2000(fobj, start_length, size)[源代码]

IcoImagePlugin Module

class PIL.IcoImagePlugin.IcoFile(buf)[源代码]

基类:object

frame(idx)[源代码]

Get an image from frame idx

getimage(size, bpp=False)[源代码]

Get an image from the icon

sizes()[源代码]

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

class PIL.IcoImagePlugin.IcoImageFile(fp=None, filename=None)[源代码]

基类: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/archive/p/casadebender/wikis/Win32IconImagePlugin.wiki

format = 'ICO'
format_description = 'Windows Icon'
load()[源代码]
load_seek()[源代码]

ImImagePlugin Module

class PIL.ImImagePlugin.ImImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'IM'
format_description = 'IFUNC Image Memory'
is_animated
n_frames
seek(frame)[源代码]
tell()[源代码]
PIL.ImImagePlugin.number(s)[源代码]

ImtImagePlugin Module

class PIL.ImtImagePlugin.ImtImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'IMT'
format_description = 'IM Tools'

IptcImagePlugin Module

class PIL.IptcImagePlugin.IptcImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

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

JpegImagePlugin Module

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

基类:PIL.ImageFile.ImageFile

draft(mode, size)[源代码]
format = 'JPEG'
format_description = 'JPEG (ISO 10918)'
load_djpeg()[源代码]
PIL.JpegImagePlugin.SOF(self, marker)[源代码]
PIL.JpegImagePlugin.Skip(self, marker)[源代码]
PIL.JpegImagePlugin.convert_dict_qtables(qtables)[源代码]
PIL.JpegImagePlugin.get_sampling(im)[源代码]
PIL.JpegImagePlugin.jpeg_factory(fp=None, filename=None)[源代码]

Jpeg2KImagePlugin Module

class PIL.Jpeg2KImagePlugin.Jpeg2KImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'JPEG2000'
format_description = 'JPEG 2000 (ISO 15444)'
load()[源代码]

McIdasImagePlugin Module

class PIL.McIdasImagePlugin.McIdasImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

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

MicImagePlugin Module

class PIL.MicImagePlugin.MicImageFile(fp=None, filename=None)[源代码]

基类:PIL.TiffImagePlugin.TiffImageFile

format = 'MIC'
format_description = 'Microsoft Image Composer'
is_animated
n_frames
seek(frame)[源代码]
tell()[源代码]

MpegImagePlugin Module

class PIL.MpegImagePlugin.BitStream(fp)[源代码]

基类:object

next()[源代码]
peek(bits)[源代码]
read(bits)[源代码]
skip(bits)[源代码]
class PIL.MpegImagePlugin.MpegImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'MPEG'
format_description = 'MPEG'

MspImagePlugin Module

class PIL.MspImagePlugin.MspImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'MSP'
format_description = 'Windows Paint'

PalmImagePlugin Module

PIL.PalmImagePlugin.build_prototype_image()[源代码]

PcdImagePlugin Module

class PIL.PcdImagePlugin.PcdImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'PCD'
format_description = 'Kodak PhotoCD'

PcxImagePlugin Module

class PIL.PcxImagePlugin.PcxImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'PCX'
format_description = 'Paintbrush'

PdfImagePlugin Module

PixarImagePlugin Module

class PIL.PixarImagePlugin.PixarImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

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

PngImagePlugin Module

PIL.PngImagePlugin.getchunks(im, **params)[源代码]

Return a list of PNG chunks representing this image.

PIL.PngImagePlugin.is_cid()

Matches zero or more characters at the beginning of the string.

PIL.PngImagePlugin.putchunk(fp, cid, *data)[源代码]

Write a PNG chunk (including CRC field)

class PIL.PngImagePlugin.ChunkStream(fp)[源代码]

基类: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)[源代码]

基类: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.PngStream(fp)[源代码]

基类: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)[源代码]

PpmImagePlugin Module

class PIL.PpmImagePlugin.PpmImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'PPM'
format_description = 'Pbmplus image'

PsdImagePlugin Module

class PIL.PsdImagePlugin.PsdImageFile(fp=None, filename=None)[源代码]

基类: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)[源代码]

基类:PIL.ImageFile.ImageFile

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

SpiderImagePlugin Module

class PIL.SpiderImagePlugin.SpiderImageFile(fp=None, filename=None)[源代码]

基类: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)[源代码]
PIL.SpiderImagePlugin.isSpiderHeader(t)[源代码]
PIL.SpiderImagePlugin.isSpiderImage(filename)[源代码]
PIL.SpiderImagePlugin.loadImageSeries(filelist=None)[源代码]

create a list of Image.images for use in montage

PIL.SpiderImagePlugin.makeSpiderHeader(im)[源代码]

SunImagePlugin Module

class PIL.SunImagePlugin.SunImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

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

TgaImagePlugin Module

class PIL.TgaImagePlugin.TgaImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'TGA'
format_description = 'Targa'

TiffImagePlugin Module

class PIL.TiffImagePlugin.IFDRational(value, denominator=1)[源代码]

基类:numbers.Rational

Implements a rational class where 0/0 is a legal value to match the in the wild use of exif rationals.

e.g., DigitalZoomRatio - 0.00/0.00 indicates that no digital zoom was used

denominator
limit_rational(max_denominator)[源代码]
参数:max_denominator – Integer, the maximum denominator value
返回:Tuple of (numerator, denominator)
numerator
PIL.TiffImagePlugin.ImageFileDirectory

ImageFileDirectory_v1 的别名

class PIL.TiffImagePlugin.ImageFileDirectory_v1(*args, **kwargs)[源代码]

基类:PIL.TiffImagePlugin.ImageFileDirectory_v2

This class represents the legacy interface to a TIFF tag directory.

Exposes a dictionary interface of the tags in the directory:

ifd = ImageFileDirectory_v1()
ifd[key] = 'Some Data'
ifd.tagtype[key] = 2
print ifd[key]
('Some Data',)

Also contains a dictionary of tag types as read from the tiff image file, ~PIL.TiffImagePlugin.ImageFileDirectory_v1.tagtype.

Values are returned as a tuple.

3.0.0 版后已移除.

classmethod from_v2(original)[源代码]

Returns an ImageFileDirectory_v1 instance with the same data as is contained in the original ImageFileDirectory_v2 instance.

返回:ImageFileDirectory_v1
tagdata
tags
to_v2()[源代码]

Returns an ImageFileDirectory_v2 instance with the same data as is contained in the original ImageFileDirectory_v1 instance.

返回:ImageFileDirectory_v2
class PIL.TiffImagePlugin.ImageFileDirectory_v2(ifh=b'II*x00x00x00x00x00', prefix=None)[源代码]

基类: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:

ifd = ImageFileDirectory_v2()
ifd[key] = 'Some Data'
ifd.tagtype[key] = 2
print(ifd[key])
'Some Data'

Individual values are returned as the strings or numbers, sequences are returned as tuples of the values.

The tiff metadata type of each item is stored in a dictionary of tag types in ~PIL.TiffImagePlugin.ImageFileDirectory_v2.tagtype. The types are read from a tiff file, guessed from the type added, or added manually.

Data Structures:

  • self.tagtype = {}
    • Key: numerical tiff tag number
    • Value: integer corresponding to the data type from ~PIL.TiffTags.TYPES

3.0.0 新版功能.

as_dict()[源代码]

Return a dictionary of the image’s tags.

3.0.0 版后已移除.

legacy_api
load(fp)[源代码]
load_byte(data, legacy_api=True)[源代码]
load_double(data, legacy_api=True)
load_float(data, legacy_api=True)
load_long(data, legacy_api=True)
load_rational(data, legacy_api=True)[源代码]
load_short(data, legacy_api=True)
load_signed_byte(data, legacy_api=True)
load_signed_long(data, legacy_api=True)
load_signed_rational(data, legacy_api=True)[源代码]
load_signed_short(data, legacy_api=True)
load_string(data, legacy_api=True)[源代码]
load_undefined(data, legacy_api=True)[源代码]
named()[源代码]
返回:dict of name|key: value

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

offset
prefix
reset()[源代码]
save(fp)[源代码]
write_byte(data)[源代码]
write_double(*values)
write_float(*values)
write_long(*values)
write_rational(*values)[源代码]
write_short(*values)
write_signed_byte(*values)
write_signed_long(*values)
write_signed_rational(*values)[源代码]
write_signed_short(*values)
write_string(value)[源代码]
write_undefined(value)[源代码]
class PIL.TiffImagePlugin.TiffImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'TIFF'
format_description = 'Adobe TIFF'
is_animated
load()[源代码]
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)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'WEBP'
format_description = 'WebP image'

WmfImagePlugin Module

class PIL.WmfImagePlugin.WmfStubImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.StubImageFile

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

XVThumbImagePlugin Module

class PIL.XVThumbImagePlugin.XVThumbImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

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

XbmImagePlugin Module

class PIL.XbmImagePlugin.XbmImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'XBM'
format_description = 'X11 Bitmap'

XpmImagePlugin Module

class PIL.XpmImagePlugin.XpmImageFile(fp=None, filename=None)[源代码]

基类:PIL.ImageFile.ImageFile

format = 'XPM'
format_description = 'X11 Pixel Map'
load_read(bytes)[源代码]