プラグインリファレンス

BmpImagePlugin モジュール

class PIL.BmpImagePlugin.BmpImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

Windows Bitmap形式（BMP）用の画像プラグイン

BITFIELDS = 3

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

JPEG = 4

PNG = 5

RAW = 0

RLE4 = 2

RLE8 = 1

format: str | None = 'BMP'

format_description: str | None = 'Windows Bitmap'

k = 'PNG'

v = 5

class PIL.BmpImagePlugin.BmpRleDecoder(mode: str, *args: Any)

ベース: PyDecoder

decode(buffer: bytes | SupportsArrayInterface) → tuple[int, int]

デコード処理を実行するためにオーバーライドします。

パラメータ:

buffer – デコードするデータを含む bytes オブジェクト。

戻り値:

(消費されたバイト数, エラーコード) のタプル。デコードが終了した場合は、消費されたバイト数として -1 を返します。エラーコードは ImageFile.ERRORS から取得します。

class PIL.BmpImagePlugin.DibImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベースクラス: BmpImageFile

format: str | None = 'DIB'

format_description: str | None = 'Windows Bitmap'

BufrStubImagePlugin モジュール

class PIL.BufrStubImagePlugin.BufrStubImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベースクラス: StubImageFile

format: str | None = 'BUFR'

format_description: str | None = 'BUFR'

PIL.BufrStubImagePlugin.register_handler(handler: StubHandler | None) → None

アプリケーション固有の BUFR イメージハンドラーをインストールします。

パラメータ:

handler – ハンドラーオブジェクト。

CurImagePlugin モジュール

class PIL.CurImagePlugin.CurImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベースクラス: BmpImageFile

format: str | None = 'CUR'

format_description: str | None = 'Windows Cursor'

DcxImagePlugin モジュール

class PIL.DcxImagePlugin.DcxImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベースクラス: PcxImageFile

format: str | None = 'DCX'

format_description: str | None = 'Intel DCX'

seek(frame: int) → None

このシーケンスファイル内の指定されたフレームにシークします。シーケンスの終端を超えてシークすると、このメソッドは EOFError 例外を発生させます。シーケンスファイルを開くと、ライブラリは自動的にフレーム 0 にシークします。

tell() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

パラメータ:

frame – フレーム番号。0 から始まります。

発生する例外:

EOFError – 呼び出しがシーケンスの終端を超えてシークしようとした場合。

tell() → int

現在のフレーム番号を返します。seek() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

戻り値:

フレーム番号。0 から始まります。

DdsImagePlugin モジュール

.dds ファイル（S3TC 圧縮、別名 DXTC）用の Pillow ローダー。Jerome Leclanche <jerome@leclan.ch>

ドキュメント: https://web.archive.org/web/20170802060935/http://oss.sgi.com/projects/ogl-sample/registry/EXT/texture_compression_s3tc.txt

このファイルの内容は、ここにパブリックドメイン（CC0）でリリースされます。CC0 ライセンスの全文： https://creativecommons.org/publicdomain/zero/1.0/

class PIL.DdsImagePlugin.D3DFMT(value, names=<指定なし>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

ベース: IntEnum

A1 = 118

A16B16G16R16 = 36

A16B16G16R16F = 113

A1R5G5B5 = 25

A2B10G10R10 = 31

A2B10G10R10_XR_BIAS = 119

A2R10G10B10 = 35

A2W10V10U10 = 67

A32B32G32R32F = 116

A4L4 = 52

A4R4G4B4 = 26

A8 = 28

A8B8G8R8 = 32

A8L8 = 51

A8P8 = 40

A8R3G3B2 = 29

A8R8G8B8 = 21

ATI1 = 826889281

ATI2 = 843666497

BC4S = 1395934018

BC4U = 1429488450

BC5S = 1395999554

BC5U = 1429553986

BINARYBUFFER = 199

CxV8U8 = 117

D15S1 = 73

D16 = 80

D16_LOCKABLE = 70

D24FS8 = 83

D24S8 = 75

D24X4S4 = 79

D24X8 = 77

D32 = 71

D32F_LOCKABLE = 82

D32_LOCKABLE = 84

DX10 = 808540228

DXT1 = 827611204

DXT2 = 844388420

DXT3 = 861165636

DXT4 = 877942852

DXT5 = 894720068

G16R16 = 34

G16R16F = 112

G32R32F = 115

G8R8_G8B8 = 1111970375

INDEX16 = 101

INDEX32 = 102

L16 = 81

L6V5U5 = 61

L8 = 50

MULTI2_ARGB8 = 827606349

P8 = 41

Q16W16V16U16 = 110

Q8W8V8U8 = 63

R16F = 111

R32F = 114

R3G3B2 = 27

R5G6B5 = 23

R8G8B8 = 20

R8G8_B8G8 = 1195525970

S8_LOCKABLE = 85

UNKNOWN = 0

UYVY = 1498831189

V16U16 = 64

V8U8 = 60

VERTEXDATA = 100

X1R5G5B5 = 24

X4R4G4B4 = 30

X8B8G8R8 = 33

X8L8V8U8 = 62

X8R8G8B8 = 22

YUY2 = 844715353

class PIL.DdsImagePlugin.DDPF(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

ベース: IntFlag

ALPHA = 2

ALPHAPIXELS = 1

FOURCC = 4

LUMINANCE = 131072

PALETTEINDEXED8 = 32

RGB = 64

class PIL.DdsImagePlugin.DDSCAPS(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

ベース: IntFlag

COMPLEX = 8

MIPMAP = 4194304

TEXTURE = 4096

class PIL.DdsImagePlugin.DDSCAPS2(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

ベース: IntFlag

CUBEMAP = 512

CUBEMAP_NEGATIVEX = 2048

CUBEMAP_NEGATIVEY = 8192

CUBEMAP_NEGATIVEZ = 32768

CUBEMAP_POSITIVEX = 1024

CUBEMAP_POSITIVEY = 4096

CUBEMAP_POSITIVEZ = 16384

VOLUME = 2097152

class PIL.DdsImagePlugin.DDSD(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

ベース: IntFlag

CAPS = 1

DEPTH = 8388608

HEIGHT = 2

LINEARSIZE = 524288

MIPMAPCOUNT = 131072

PITCH = 8

PIXELFORMAT = 4096

WIDTH = 4

class PIL.DdsImagePlugin.DXGI_FORMAT(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

ベース: IntEnum

A8P8 = 114

A8_UNORM = 65

AI44 = 111

AYUV = 100

B4G4R4A4_UNORM = 115

B5G5R5A1_UNORM = 86

B5G6R5_UNORM = 85

B8G8R8A8_TYPELESS = 90

B8G8R8A8_UNORM = 87

B8G8R8A8_UNORM_SRGB = 91

B8G8R8X8_TYPELESS = 92

B8G8R8X8_UNORM = 88

B8G8R8X8_UNORM_SRGB = 93

BC1_TYPELESS = 70

BC1_UNORM = 71

BC1_UNORM_SRGB = 72

BC2_TYPELESS = 73

BC2_UNORM = 74

BC2_UNORM_SRGB = 75

BC3_TYPELESS = 76

BC3_UNORM = 77

BC3_UNORM_SRGB = 78

BC4_SNORM = 81

BC4_TYPELESS = 79

BC4_UNORM = 80

BC5_SNORM = 84

BC5_TYPELESS = 82

BC5_UNORM = 83

BC6H_SF16 = 96

BC6H_TYPELESS = 94

BC6H_UF16 = 95

BC7_TYPELESS = 97

BC7_UNORM = 98

BC7_UNORM_SRGB = 99

D16_UNORM = 55

D24_UNORM_S8_UINT = 45

D32_FLOAT = 40

D32_FLOAT_S8X24_UINT = 20

G8R8_G8B8_UNORM = 69

IA44 = 112

NV11 = 110

NV12 = 103

OPAQUE_420 = 106

P010 = 104

P016 = 105

P208 = 130

P8 = 113

R10G10B10A2_TYPELESS = 23

R10G10B10A2_UINT = 25

R10G10B10A2_UNORM = 24

R10G10B10_XR_BIAS_A2_UNORM = 89

R11G11B10_FLOAT = 26

R16G16B16A16_FLOAT = 10

R16G16B16A16_SINT = 14

R16G16B16A16_SNORM = 13

R16G16B16A16_TYPELESS = 9

R16G16B16A16_UINT = 12

R16G16B16A16_UNORM = 11

R16G16_FLOAT = 34

R16G16_SINT = 38

R16G16_SNORM = 37

R16G16_TYPELESS = 33

R16G16_UINT = 36

R16G16_UNORM = 35

R16_FLOAT = 54

R16_SINT = 59

R16_SNORM = 58

R16_TYPELESS = 53

R16_UINT = 57

R16_UNORM = 56

R1_UNORM = 66

R24G8_TYPELESS = 44

R24_UNORM_X8_TYPELESS = 46

R32G32B32A32_FLOAT = 2

R32G32B32A32_SINT = 4

R32G32B32A32_TYPELESS = 1

R32G32B32A32_UINT = 3

R32G32B32_FLOAT = 6

R32G32B32_SINT = 8

R32G32B32_TYPELESS = 5

R32G32B32_UINT = 7

R32G32_FLOAT = 16

R32G32_SINT = 18

R32G32_TYPELESS = 15

R32G32_UINT = 17

R32G8X24_TYPELESS = 19

R32_FLOAT = 41

R32_FLOAT_X8X24_TYPELESS = 21

R32_SINT = 43

R32_TYPELESS = 39

R32_UINT = 42

R8G8B8A8_SINT = 32

R8G8B8A8_SNORM = 31

R8G8B8A8_TYPELESS = 27

R8G8B8A8_UINT = 30

R8G8B8A8_UNORM = 28

R8G8B8A8_UNORM_SRGB = 29

R8G8_B8G8_UNORM = 68

R8G8_SINT = 52

R8G8_SNORM = 51

R8G8_TYPELESS = 48

R8G8_UINT = 50

R8G8_UNORM = 49

R8_SINT = 64

R8_SNORM = 63

R8_TYPELESS = 60

R8_UINT = 62

R8_UNORM = 61

R9G9B9E5_SHAREDEXP = 67

SAMPLER_FEEDBACK_MIN_MIP_OPAQUE = 189

SAMPLER_FEEDBACK_MIP_REGION_USED_OPAQUE = 190

UNKNOWN = 0

V208 = 131

V408 = 132

X24_TYPELESS_G8_UINT = 47

X32_TYPELESS_G8X24_UINT = 22

Y210 = 108

Y216 = 109

Y410 = 101

Y416 = 102

YUY2 = 107

class PIL.DdsImagePlugin.DdsImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'DDS'

format_description: str | None = 'DirectDraw Surface'

load_seek(pos: int) → None

class PIL.DdsImagePlugin.DdsRgbDecoder(mode: str, *args: Any)

ベース: PyDecoder

decode(buffer: bytes | SupportsArrayInterface) → tuple[int, int]

デコード処理を実行するためにオーバーライドします。

パラメータ:

buffer – デコードするデータを含む bytes オブジェクト。

戻り値:

(消費されたバイト数, エラーコード) のタプル。デコードが終了した場合は、消費されたバイト数として -1 を返します。エラーコードは ImageFile.ERRORS から取得します。

EpsImagePlugin モジュール

class PIL.EpsImagePlugin.EpsImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

Python Imaging Library 用の EPS ファイルパーサー

format: str | None = 'EPS'

format_description: str | None = 'Encapsulated Postscript'

load(scale: int = 1, transparency: bool = False) → Image.core.PixelAccess | None

タイルリストに基づいて画像データをロードします

load_seek(pos: int) → None

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

PIL.EpsImagePlugin.Ghostscript(tile: list[ImageFile._Tile], size: tuple[int, int], fp: IO[bytes], scale: int = 1, transparency: bool = False) → Image.core.ImagingCore

Ghostscript を使用して画像を描画します

PIL.EpsImagePlugin.has_ghostscript() → bool

FitsImagePlugin モジュール

class PIL.FitsImagePlugin.FitsGzipDecoder(mode: str, *args: Any)

ベース: PyDecoder

decode(buffer: bytes | SupportsArrayInterface) → tuple[int, int]

デコード処理を実行するためにオーバーライドします。

パラメータ:

buffer – デコードするデータを含む bytes オブジェクト。

戻り値:

(消費されたバイト数, エラーコード) のタプル。デコードが終了した場合は、消費されたバイト数として -1 を返します。エラーコードは ImageFile.ERRORS から取得します。

class PIL.FitsImagePlugin.FitsImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'FITS'

format_description: str | None = 'FITS'

FliImagePlugin モジュール

class PIL.FliImagePlugin.FliImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'FLI'

format_description: str | None = 'Autodesk FLI/FLC Animation'

seek(frame: int) → None

このシーケンスファイル内の指定されたフレームにシークします。シーケンスの終端を超えてシークすると、このメソッドは EOFError 例外を発生させます。シーケンスファイルを開くと、ライブラリは自動的にフレーム 0 にシークします。

tell() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

パラメータ:

frame – フレーム番号。0 から始まります。

発生する例外:

EOFError – 呼び出しがシーケンスの終端を超えてシークしようとした場合。

tell() → int

現在のフレーム番号を返します。seek() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

戻り値:

フレーム番号。0 から始まります。

FpxImagePlugin モジュール

class PIL.FpxImagePlugin.FpxImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

close() → None

可能であれば、ファイルポインタを閉じます。

この操作は、イメージコアを破棄し、そのメモリを解放します。その後、イメージデータは使用できなくなります。

この関数は、複数のフレームを持つイメージや、load()メソッドによってファイルが読み込まれて閉じられていないイメージを閉じるために必要です。詳細については、Pillowでのファイル処理を参照してください。

format: str | None = 'FPX'

format_description: str | None = 'FlashPix'

load() → Image.core.PixelAccess | None

タイルリストに基づいて画像データをロードします

GbrImagePlugin モジュール

class PIL.GbrImagePlugin.GbrImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'GBR'

format_description: str | None = 'GIMP ブラシファイル'

load() → Image.core.PixelAccess | None

タイルリストに基づいて画像データをロードします

GifImagePlugin モジュール

class PIL.GifImagePlugin.GifImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

data() → bytes | None

format: str | None = 'GIF'

format_description: str | None = 'Compuserve GIF'

global_palette = None

property is_animated: bool

load_end() → None

load_prepare() → None

property n_frames: int

seek(frame: int) → None

このシーケンスファイル内の指定されたフレームにシークします。シーケンスの終端を超えてシークすると、このメソッドは EOFError 例外を発生させます。シーケンスファイルを開くと、ライブラリは自動的にフレーム 0 にシークします。

tell() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

パラメータ:

frame – フレーム番号。0 から始まります。

発生する例外:

EOFError – 呼び出しがシーケンスの終端を超えてシークしようとした場合。

tell() → int

現在のフレーム番号を返します。seek() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

戻り値:

フレーム番号。0 から始まります。

PIL.GifImagePlugin.LOADING_STRATEGY = LoadingStrategy.RGB_AFTER_FIRST

バージョン 9.1.0 で追加.

class PIL.GifImagePlugin.LoadingStrategy(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

ベース: IntEnum

バージョン 9.1.0 で追加.

RGB_AFTER_DIFFERENT_PALETTE_ONLY = 1

RGB_AFTER_FIRST = 0

RGB_ALWAYS = 2

PIL.GifImagePlugin.get_interlace(im: Image) → int

PIL.GifImagePlugin.getdata(im: Image, offset: tuple[int, int] = (0, 0), **params: Any) → list[bytes]

旧メソッド

このイメージを表す文字列のリストを返します。最初の文字列はローカルイメージヘッダーで、残りはエンコードされたイメージデータを含みます。

期間を指定するには、ミリ秒単位で時間を追加します。例：getdata(im_frame, duration=1000)

パラメータ:

• im – イメージオブジェクト

• offset – (x, y)ピクセルのタプル。デフォルトは(0, 0)

• **params – 例：durationまたはその他のエンコーダー情報パラメーター

戻り値:

GIFエンコードされたフレームデータを含むバイトのリスト

PIL.GifImagePlugin.getheader(im: Image, palette: bytes | bytearray | list[int] | ImagePalette | None = None, info: dict[str, Any] | None = None) → tuple[list[bytes], list[int] | None]

イメージからGifデータを取得する旧メソッド。

警告:: イメージデータを変更する可能性があります。

パラメータ:

• im – イメージオブジェクト

• palette – ソースパレットを含むバイトオブジェクト、または…。

• info – エンコーダー情報

戻り値:

(ヘッダー項目のリスト、最適化されたパレット)のタプル

GribStubImagePlugin モジュール

class PIL.GribStubImagePlugin.GribStubImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベースクラス: StubImageFile

format: str | None = 'GRIB'

format_description: str | None = 'GRIB'

PIL.GribStubImagePlugin.register_handler(handler: StubHandler | None) → None

アプリケーション固有のGRIBイメージハンドラーをインストールします。

パラメータ:

handler – ハンドラーオブジェクト。

Hdf5StubImagePlugin モジュール

class PIL.Hdf5StubImagePlugin.HDF5StubImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベースクラス: StubImageFile

format: str | None = 'HDF5'

format_description: str | None = 'HDF5'

PIL.Hdf5StubImagePlugin.register_handler(handler: StubHandler | None) → None

アプリケーション固有のHDF5イメージハンドラーをインストールします。

パラメータ:

handler – ハンドラーオブジェクト。

IcnsImagePlugin モジュール

class PIL.IcnsImagePlugin.IcnsFile(fobj: IO[bytes])

ベースクラス: object

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

bestsize() → tuple[int, int, int]

dataforsize(size: tuple[int, int, int]) → dict[str, Image]

アイコンリソースを{channel: array}として取得します。配列はWindowsビットマップのように下から上に向かっており、何らかの方法で反転または転置する必要がある可能性が高いことに注意してください。

getimage(size: tuple[int, int] | tuple[int, int, int] | None = None) → Image

itersizes() → list[tuple[int, int, int]]

class PIL.IcnsImagePlugin.IcnsImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

Mac OS .icns ファイルの PIL イメージをサポートします。最適な解像度を選択しますが、'load' を呼び出す前にサイズ属性を変更すると、異なるサイズの画像をロードする可能性があります。

info ディクショナリには、icns ファイルが持つサイズのリストである 'sizes' というキーがあります。

format: str | None = 'ICNS'

format_description: str | None = 'Mac OS icns リソース'

load(scale: int | None = None) → Image.core.PixelAccess | None

タイルリストに基づいて画像データをロードします

property size: tuple[int, int] | tuple[int, int, int]

PIL.IcnsImagePlugin.nextheader(fobj: IO[bytes]) → tuple[bytes, int]

PIL.IcnsImagePlugin.read_32(fobj: IO[bytes], start_length: tuple[int, int], size: tuple[int, int, int]) → dict[str, Image]

32ビット RGB アイコンリソースを読み込みます。非圧縮または RLE packbits のようなスキームのいずれかであるようです。

PIL.IcnsImagePlugin.read_32t(fobj: IO[bytes], start_length: tuple[int, int], size: tuple[int, int, int]) → dict[str, Image]

PIL.IcnsImagePlugin.read_mk(fobj: IO[bytes], start_length: tuple[int, int], size: tuple[int, int, int]) → dict[str, Image]

PIL.IcnsImagePlugin.read_png_or_jpeg2000(fobj: IO[bytes], start_length: tuple[int, int], size: tuple[int, int, int]) → dict[str, Image]

IcoImagePlugin モジュール

class PIL.IcoImagePlugin.IcoFile(buf: IO[bytes])

ベースクラス: object

frame(idx: int) → Image

フレーム idx から画像を取得します

getentryindex(size: tuple[int, int], bpp: int | bool = False) → int

getimage(size: tuple[int, int], bpp: int | bool = False) → Image

アイコンから画像を取得します

sizes() → set[tuple[int, int]]

利用可能なすべてのアイコンサイズと色深度のセットを取得します。

class PIL.IcoImagePlugin.IcoImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

Microsoft Windowsの .ico ファイルに対する PIL の読み取り専用画像サポートです。

デフォルトでは、ファイル内の最大の解像度の画像が読み込まれます。これは、 ‘load’ を呼び出す前に ‘size’ 属性を変更することで変更できます。

情報辞書には、アイコンファイルで利用可能なサイズのリストである ‘sizes’ というキーがあります。

クラシック、XP、Vista のアイコン形式を処理します。

保存時には、PNG圧縮が使用されます。このサポートは Windows Vista でのみ追加されました。Windows でアイコンを表示できない場合は、保存前に画像を「RGBA」モードに変換してください。

このプラグインは、Bryan Davis <casadebender@gmail.com> による Win32IconImagePlugin のリファクタリング版です。 https://code.google.com/archive/p/casadebender/wikis/Win32IconImagePlugin.wiki

format: str | None = 'ICO'

format_description: str | None = 'Windows Icon'

load() → Image.core.PixelAccess | None

タイルリストに基づいて画像データをロードします

load_seek(pos: int) → None

property size: tuple[int, int]

class PIL.IcoImagePlugin.IconHeader(width, height, nb_color, reserved, planes, bpp, size, offset, dim, square, color_depth)

基底クラス: NamedTuple

bpp: int

フィールド番号5のエイリアス

color_depth: int

フィールド番号10のエイリアス

dim: tuple[int, int]

フィールド番号8のエイリアス

height: int

フィールド番号1のエイリアス

nb_color: int

フィールド番号2のエイリアス

offset: int

フィールド番号7のエイリアス

planes: int

フィールド番号4のエイリアス

reserved: int

フィールド番号3のエイリアス

size: int

フィールド番号 6 のエイリアス

square: int

フィールド番号 9 のエイリアス

width: int

フィールド番号 0 のエイリアス

ImImagePlugin モジュール

class PIL.ImImagePlugin.ImImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'IM'

format_description: str | None = 'IFUNC イメージ メモリ'

property is_animated: bool

property n_frames: int

seek(frame: int) → None

このシーケンスファイル内の指定されたフレームにシークします。シーケンスの終端を超えてシークすると、このメソッドは EOFError 例外を発生させます。シーケンスファイルを開くと、ライブラリは自動的にフレーム 0 にシークします。

tell() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

パラメータ:

frame – フレーム番号。0 から始まります。

発生する例外:

EOFError – 呼び出しがシーケンスの終端を超えてシークしようとした場合。

tell() → int

現在のフレーム番号を返します。seek() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

戻り値:

フレーム番号。0 から始まります。

PIL.ImImagePlugin.number(s: Any) → float

ImtImagePlugin モジュール

class PIL.ImtImagePlugin.ImtImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'IMT'

format_description: str | None = 'IM ツール'

IptcImagePlugin モジュール

class PIL.IptcImagePlugin.IptcImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

field() → tuple[tuple[int, int] | None, int]

format: str | None = 'IPTC'

format_description: str | None = 'IPTC/NAA'

getint(key: tuple[int, int]) → int

load() → Image.core.PixelAccess | None

タイルリストに基づいて画像データをロードします

PIL.IptcImagePlugin.dump(c: Sequence[int | bytes]) → None

バージョン 10.2.0 で非推奨になりました。

PIL.IptcImagePlugin.getiptcinfo(im: ImageFile) → dict[tuple[int, int], bytes | list[bytes]] | None

TIFF、JPEG、またはIPTCファイルからIPTC情報を取得します。

パラメータ:

im – IPTCデータを含む画像。

戻り値:

IPTC情報を含む辞書、またはIPTC情報ブロックが見つからなかった場合は None。

PIL.IptcImagePlugin.i(c: bytes) → int

バージョン 10.2.0 で非推奨になりました。

JpegImagePlugin モジュール

PIL.JpegImagePlugin.APP(self: JpegImageFile, marker: int) → None

PIL.JpegImagePlugin.COM(self: JpegImageFile, marker: int) → None

PIL.JpegImagePlugin.DQT(self: JpegImageFile, marker: int) → None

class PIL.JpegImagePlugin.JpegImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

draft(mode: str | None, size: tuple[int, int] | None) → tuple[str, tuple[int, int, float, float]] | None

指定されたモードとサイズにできる限り一致する画像のバージョンを返すように、画像ファイルローダーを設定します。たとえば、このメソッドを使用して、カラーJPEGをロード中にグレースケールに変換できます。

変更が行われた場合、選択された mode と、変更された画像内の元の画像の座標を含む box のタプルを返します。

このメソッドは Image オブジェクトをインプレースで変更することに注意してください。画像が既にロードされている場合、このメソッドは効果がありません。

注意: このメソッドはほとんどの画像では実装されていません。現在、JPEGおよびMPO画像でのみ実装されています。

パラメータ:

• mode – 要求されたモード。

• size – ピクセル単位で要求されたサイズ。2タプル（幅、高さ）として指定します。

format: str | None = 'JPEG'

format_description: str | None = 'JPEG (ISO 10918)'

load_djpeg() → None

load_read(read_bytes: int) → bytes

内部：より多くの画像データを読み込みます。早期のEOFおよびLOAD_TRUNCATED_IMAGESの場合、libjpegがデコードを完了できるようにEOIマーカーを追加します

PIL.JpegImagePlugin.SOF(self: JpegImageFile, marker: int) → None

PIL.JpegImagePlugin.Skip(self: JpegImageFile, marker: int) → None

PIL.JpegImagePlugin.get_sampling(im: Image) → int

PIL.JpegImagePlugin.jpeg_factory(fp: IO[bytes], filename: str | bytes | None = None) → JpegImageFile | MpoImageFile

Jpeg2KImagePlugin モジュール

class PIL.Jpeg2KImagePlugin.BoxReader(fp: IO[bytes], length: int = -1)

ベースクラス: object

JPEG2000ヘッダーボックスに格納されているフィールドを読み取り、サブボックスに簡単にステップインして読み取るための小さなヘルパークラス。

has_next_box() → bool

next_box_type() → bytes

read_boxes() → BoxReader

read_fields(field_format: str) → tuple[int | bytes, ...]

class PIL.Jpeg2KImagePlugin.Jpeg2KImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'JPEG2000'

format_description: str | None = 'JPEG 2000 (ISO 15444)'

load() → Image.core.PixelAccess | None

タイルリストに基づいて画像データをロードします

property reduce: Callable[[int | tuple[int, int], tuple[int, int, int, int] | None], Image] | int

画像を factor 倍に縮小したコピーを返します。画像のサイズが factor で割り切れない場合、結果のサイズは切り上げられます。

パラメータ:

• factor – 幅と高さを別々に指定するための、0より大きい整数、または2つの整数のタプル。

• box – 縮小するソース画像領域を提供する、オプションの4整数のタプル。値は (0, 0, width, height) の矩形内である必要があります。省略または None の場合、ソース全体が使用されます。

McIdasImagePlugin モジュール

class PIL.McIdasImagePlugin.McIdasImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'MCIDAS'

format_description: str | None = 'McIdas エリア ファイル'

MicImagePlugin モジュール

class PIL.MicImagePlugin.MicImageFile(fp: str | bytes | PathLike[str] | PathLike[bytes] | IO[bytes], filename: str | bytes | None = None)

ベース: TiffImageFile

close() → None

可能であれば、ファイルポインタを閉じます。

この操作は、イメージコアを破棄し、そのメモリを解放します。その後、イメージデータは使用できなくなります。

この関数は、複数のフレームを持つイメージや、load()メソッドによってファイルが読み込まれて閉じられていないイメージを閉じるために必要です。詳細については、Pillowでのファイル処理を参照してください。

format: str | None = 'MIC'

format_description: str | None = 'Microsoft Image Composer'

seek(frame: int) → None

指定されたフレームを現在の画像として選択します

tell() → int

現在のフレーム番号を返します

MpegImagePlugin モジュール

class PIL.MpegImagePlugin.BitStream(fp: SupportsRead[bytes])

ベースクラス: object

next() → int

peek(bits: int) → int

read(bits: int) → int

skip(bits: int) → None

class PIL.MpegImagePlugin.MpegImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'MPEG'

format_description: str | None = 'MPEG'

MpoImagePlugin モジュール

class PIL.MpoImagePlugin.MpoImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: JpegImageFile

static adopt(jpeg_instance: JpegImageFile, mpheader: dict[int, Any] | None = None) → MpoImageFile

JpegImageFileのインスタンスをMpoImageFileのインスタンスに変換します。呼び出し後、JpegImageFileはMpoImageFileになるように拡張されます。

これは、_openへの二重呼び出しを避けるために、MPOであることが判明したJPEGファイルを開く場合に非常に役立ちます。

format: str | None = 'MPO'

format_description: str | None = 'MPO (CIPA DC-007)'

load_seek(pos: int) → None

seek(frame: int) → None

このシーケンスファイル内の指定されたフレームにシークします。シーケンスの終端を超えてシークすると、このメソッドは EOFError 例外を発生させます。シーケンスファイルを開くと、ライブラリは自動的にフレーム 0 にシークします。

tell() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

パラメータ:

frame – フレーム番号。0 から始まります。

発生する例外:

EOFError – 呼び出しがシーケンスの終端を超えてシークしようとした場合。

tell() → int

現在のフレーム番号を返します。seek() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

戻り値:

フレーム番号。0 から始まります。

MspImagePlugin モジュール

class PIL.MspImagePlugin.MspDecoder(mode: str, *args: Any)

ベース: PyDecoder

decode(buffer: bytes | SupportsArrayInterface) → tuple[int, int]

デコード処理を実行するためにオーバーライドします。

パラメータ:

buffer – デコードするデータを含む bytes オブジェクト。

戻り値:

(消費されたバイト数, エラーコード) のタプル。デコードが終了した場合は、消費されたバイト数として -1 を返します。エラーコードは ImageFile.ERRORS から取得します。

class PIL.MspImagePlugin.MspImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'MSP'

format_description: str | None = 'Windows Paint'

PalmImagePlugin モジュール

PIL.PalmImagePlugin.build_prototype_image() → Image

PcdImagePlugin モジュール

class PIL.PcdImagePlugin.PcdImageFile(fp: StrOrBytesPath | IO[ bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'PCD'

format_description: str | None = 'Kodak PhotoCD'

load_end() → None

PcxImagePlugin モジュール

class PIL.PcxImagePlugin.PcxImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'PCX'

format_description: str | None = 'Paintbrush'

PdfImagePlugin モジュール

PixarImagePlugin モジュール

class PIL.PixarImagePlugin.PixarImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'PIXAR'

format_description: str | None = 'PIXAR ラスタ画像'

PngImagePlugin モジュール

class PIL.PngImagePlugin.Blend(value, names=<指定なし>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

ベース: IntEnum

OP_OVER = 1

このフレームは、前の出力画像のコンテンツとアルファ合成される必要があります。APNGシーケンスの保存を参照してください。

OP_SOURCE = 0

アルファを含むこのフレームのすべての色成分は、前の出力画像のコンテンツを上書きします。APNGシーケンスの保存を参照してください。

class PIL.PngImagePlugin.ChunkStream(fp: IO[bytes])

ベースクラス: object

call(cid: bytes, pos: int, length: int) → bytes

適切なチャンクハンドラーを呼び出します。

close() → None

crc(cid: bytes, data: bytes) → None

チェックサムを読み込み、検証します。

crc_skip(cid: bytes, data: bytes) → None

チェックサムを読み込みます。

push(cid: bytes, pos: int, length: int) → None

read() → tuple[bytes, int, int]

新しいチャンクを取得します。ヘッダー情報を返します。

verify(endchunk: bytes = b'IEND') → list[bytes]

class PIL.PngImagePlugin.Disposal(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

ベース: IntEnum

OP_BACKGROUND = 1

このフレームの変更された領域は、次のフレームをレンダリングする前に、完全に透明な黒にクリアされます。「APNG シーケンスの保存」を参照してください。

OP_NONE = 0

次のフレームをレンダリングする前に、このフレームに対して破棄は行われません。「APNG シーケンスの保存」を参照してください。

OP_PREVIOUS = 2

このフレームの変更された領域は、次のフレームをレンダリングする前に、前のフレームの内容に戻されます。「APNG シーケンスの保存」を参照してください。

class PIL.PngImagePlugin.PngImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

getexif() → Exif

画像からEXIFデータを取得します。

戻り値:

Exif オブジェクト。

load_end() → None

内部: 画像データの読み込みが完了しました。

load_prepare() → None

内部: PNGファイルを読み込む準備をします。

load_read(read_bytes: int) → bytes

内部処理：画像データをさらに読み込む

seek(frame: int) → None

このシーケンスファイル内の指定されたフレームにシークします。シーケンスの終端を超えてシークすると、このメソッドは EOFError 例外を発生させます。シーケンスファイルを開くと、ライブラリは自動的にフレーム 0 にシークします。

tell() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

パラメータ:

frame – フレーム番号。0 から始まります。

発生する例外:

EOFError – 呼び出しがシーケンスの終端を超えてシークしようとした場合。

tell() → int

現在のフレーム番号を返します。seek() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

戻り値:

フレーム番号。0 から始まります。

verify() → None

PNGファイルを検証する

format: str | None = 'PNG'

format_description: str | None = 'Portable network graphics'

property text: dict[str, str | iTXt]

class PIL.PngImagePlugin.PngStream(fp: IO[bytes])

基底クラス: ChunkStream

check_text_memory(chunklen: int) → None

chunk_IDAT(pos: int, length: int) → NoReturn

chunk_IEND(pos: int, length: int) → NoReturn

chunk_IHDR(pos: int, length: int) → bytes

chunk_PLTE(pos: int, length: int) → bytes

chunk_acTL(pos: int, length: int) → bytes

chunk_cHRM(pos: int, length: int) → bytes

chunk_eXIf(pos: int, length: int) → bytes

chunk_fcTL(pos: int, length: int) → bytes

chunk_fdAT(pos: int, length: int) → bytes

chunk_gAMA(pos: int, length: int) → bytes

chunk_iCCP(pos: int, length: int) → bytes

chunk_iTXt(pos: int, length: int) → bytes

chunk_pHYs(pos: int, length: int) → bytes

chunk_sRGB(pos: int, length: int) → bytes

chunk_tEXt(pos: int, length: int) → bytes

chunk_tRNS(pos: int, length: int) → bytes

chunk_zTXt(pos: int, length: int) → bytes

rewind() → None

save_rewind() → None

PIL.PngImagePlugin.getchunks(im: Image, **params: Any) → list[tuple[bytes, bytes, bytes]]

このイメージを表すPNGチャンクのリストを返します。

PIL.PngImagePlugin.is_cid(string, pos=0, endpos=9223372036854775807)

文字列の先頭で、0個以上の文字にマッチします。

PIL.PngImagePlugin.putchunk(fp: IO[bytes], cid: bytes, *data: bytes) → None

PNGチャンク（CRCフィールドを含む）を書き込みます。

PIL.PngImagePlugin.MAX_TEXT_CHUNK = 1048576

iTXtまたはzTXtチャンクの最大解凍サイズ。圧縮チャンクが1000倍に拡張される可能性のある解凍爆弾を排除します。 PNGファイル形式におけるテキストを参照してください。

PIL.PngImagePlugin.MAX_TEXT_MEMORY = 67108864

テキストチャンクの合計最大サイズを設定します。PNGファイル形式におけるテキストを参照してください。

PpmImagePlugin モジュール

class PIL.PpmImagePlugin.PpmDecoder(mode: str, *args: Any)

ベース: PyDecoder

decode(buffer: bytes | SupportsArrayInterface) → tuple[int, int]

デコード処理を実行するためにオーバーライドします。

パラメータ:

buffer – デコードするデータを含む bytes オブジェクト。

戻り値:

(消費されたバイト数, エラーコード) のタプル。デコードが終了した場合は、消費されたバイト数として -1 を返します。エラーコードは ImageFile.ERRORS から取得します。

class PIL.PpmImagePlugin.PpmImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'PPM'

format_description: str | None = 'Pbmplus 画像'

class PIL.PpmImagePlugin.PpmPlainDecoder(mode: str, *args: Any)

ベース: PyDecoder

decode(buffer: bytes | SupportsArrayInterface) → tuple[int, int]

デコード処理を実行するためにオーバーライドします。

パラメータ:

buffer – デコードするデータを含む bytes オブジェクト。

戻り値:

(消費されたバイト数, エラーコード) のタプル。デコードが終了した場合は、消費されたバイト数として -1 を返します。エラーコードは ImageFile.ERRORS から取得します。

PsdImagePlugin モジュール

class PIL.PsdImagePlugin.PsdImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'PSD'

format_description: str | None = 'Adobe Photoshop'

property is_animated: bool

property layers: list[tuple[str, str, tuple[int, int, int, int], list[_Tile]]]

property n_frames: int

seek(layer: int) → None

このシーケンスファイル内の指定されたフレームにシークします。シーケンスの終端を超えてシークすると、このメソッドは EOFError 例外を発生させます。シーケンスファイルを開くと、ライブラリは自動的にフレーム 0 にシークします。

tell() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

パラメータ:

frame – フレーム番号。0 から始まります。

発生する例外:

EOFError – 呼び出しがシーケンスの終端を超えてシークしようとした場合。

tell() → int

現在のフレーム番号を返します。seek() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

戻り値:

フレーム番号。0 から始まります。

SgiImagePlugin モジュール

class PIL.SgiImagePlugin.SGI16Decoder(mode: str, *args: Any)

ベース: PyDecoder

decode(buffer: bytes | SupportsArrayInterface) → tuple[int, int]

デコード処理を実行するためにオーバーライドします。

パラメータ:

buffer – デコードするデータを含む bytes オブジェクト。

戻り値:

(消費されたバイト数, エラーコード) のタプル。デコードが終了した場合は、消費されたバイト数として -1 を返します。エラーコードは ImageFile.ERRORS から取得します。

class PIL.SgiImagePlugin.SgiImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'SGI'

format_description: str | None = 'SGI Image File Format'

SpiderImagePlugin モジュール

class PIL.SpiderImagePlugin.SpiderImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

convert2byte(depth: int = 255) → Image

format: str | None = 'SPIDER'

format_description: str | None = 'Spider 2D image'

property is_animated: bool

property n_frames: int

seek(frame: int) → None

このシーケンスファイル内の指定されたフレームにシークします。シーケンスの終端を超えてシークすると、このメソッドは EOFError 例外を発生させます。シーケンスファイルを開くと、ライブラリは自動的にフレーム 0 にシークします。

tell() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

パラメータ:

frame – フレーム番号。0 から始まります。

発生する例外:

EOFError – 呼び出しがシーケンスの終端を超えてシークしようとした場合。

tell() → int

現在のフレーム番号を返します。seek() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

戻り値:

フレーム番号。0 から始まります。

tkPhotoImage() → ImageTk.PhotoImage

PIL.SpiderImagePlugin.isInt(f: Any) → int

PIL.SpiderImagePlugin.isSpiderHeader(t: tuple[float, ...]) → int

PIL.SpiderImagePlugin.isSpiderImage(filename: str) → int

PIL.SpiderImagePlugin.loadImageSeries(filelist: list[str] | None = None) → list[SpiderImageFile] | None

モンタージュで使用するためのImageオブジェクトのリストを作成します

PIL.SpiderImagePlugin.makeSpiderHeader(im: Image) → list[bytes]

SunImagePlugin モジュール

class PIL.SunImagePlugin.SunImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'SUN'

format_description: str | None = 'Sun Raster File'

TgaImagePlugin モジュール

class PIL.TgaImagePlugin.TgaImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'TGA'

format_description: str | None = 'Targa'

load_end() → None

TiffImagePlugin モジュール

class PIL.TiffImagePlugin.AppendingTiffWriter(fn: str | bytes | PathLike[str] | PathLike[bytes] | IO[bytes], new: bool = False)

ベース: BytesIO

Tags = {273, 288, 324, 519, 520, 521}

close() → None

すべてのI/O操作を無効にします。

fieldSizes = [0, 1, 1, 2, 4, 8, 1, 1, 2, 4, 8, 4, 8, 4, 2, 4, 8]

finalize() → None

fixIFD() → None

fixOffsets(count: int, isShort: bool = False, isLong: bool = False) → None

goToEnd() → None

newFrame() → None

readLong() → int

readShort() → int

rewriteLastLong(value: int) → None

rewriteLastShort(value: int) → None

rewriteLastShortToLong(value: int) → None

seek(offset: int, whence: int = 0) → int

パラメータ:

• offset – シークする距離。

• whence – 距離が開始位置、終了位置、または現在位置のどれを基準とするか。

戻り値:

開始位置からの相対的な結果の位置。

setEndian(endian: str) → None

setup() → None

skipIFDs() → None

tell() → int

現在のファイル位置、整数値。

write(data: Buffer, /) → int

バイト列をファイルに書き込みます。

書き込まれたバイト数を返します。

writeLong(value: int) → None

writeShort(value: int) → None

class PIL.TiffImagePlugin.IFDRational(value: float | Fraction | IFDRational, denominator: int = 1)

ベース: Rational

exif の有理数の使用状況に合わせて、0/0 が有効な値となる有理数クラスを実装します。

例: DigitalZoomRatio - 0.00/0.00 は、デジタルズームが使用されなかったことを示します。

property denominator: int

limit_rational(max_denominator: int) → tuple[IntegralLike, int]

パラメータ:

max_denominator – 最大分母値である整数。

戻り値:

(分子、分母)のタプル。

property numerator: IntegralLike

PIL.TiffImagePlugin.ImageFileDirectory

ImageFileDirectory_v1 のエイリアス。

class PIL.TiffImagePlugin.ImageFileDirectory_v1(*args: Any, **kwargs: Any)

ベース: ImageFileDirectory_v2

このクラスは、TIFFタグディレクトリへのレガシーインターフェースを表します。

ディレクトリ内のタグの辞書インターフェースを公開します。

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

また、tiff画像ファイルから読み取ったタグ型の辞書 tagtype も含まれています。

値はタプルとして返されます。

バージョン 3.0.0 で非推奨になりました。

classmethod from_v2(original: ImageFileDirectory_v2) → ImageFileDirectory_v1

元の ImageFileDirectory_v2 インスタンスに含まれるのと同じデータを持つ ImageFileDirectory_v1 インスタンスを返します。

戻り値:

ImageFileDirectory_v1

property tagdata

property tags

tagtype: dict[int, int]

タグ型の辞書

to_v2() → ImageFileDirectory_v2

元の ImageFileDirectory_v1 インスタンスに含まれるのと同じデータを持つ ImageFileDirectory_v2 インスタンスを返します。

戻り値:

ImageFileDirectory_v2

class PIL.TiffImagePlugin.ImageFileDirectory_v2(ifh: bytes = b'II*\x00\x00\x00\x00\x00', prefix: bytes | None = None, group: int | None = None)

ベース: MutableMapping

このクラスは、TIFFタグディレクトリを表します。処理を高速化するために、タグが要求されない限りデコードしません。

ディレクトリ内のタグの辞書インターフェースを公開します。

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

個々の値は文字列または数値として返され、シーケンスは値のタプルとして返されます。

各項目のtiffメタデータ型は、tagtype のタグ型の辞書に保存されます。型はtiffファイルから読み取られるか、追加された型から推測されるか、または手動で追加されます。

データ構造

• self.tagtype = {}

  • キー: 数値のTIFFタグ番号

  • 値: TiffTags.TYPES のデータ型に対応する整数

  バージョン 3.0.0 で追加。

「内部」データ構造

• self._tags_v2 = {}

  • キー: 数値のTIFFタグ番号

  • 値: デコードされたデータ。複数値の場合はタプル

• self._tagdata = {}

  • キー: 数値のTIFFタグ番号

  • 値: ファイルからのデコードされていないバイト文字列

• self._tags_v1 = {}

  • キー: 数値のTIFFタグ番号

  • 値: v1形式でデコードされたデータ

タグは、プライベート属性 self._tagdata およびデコードされた self._tags_v2 にあります。

self.legacy_api は内部使用のための値であり、外部コードから変更すべきではありません。ImageFileDirectory_v1 と連携して、legacy_api が true の場合、デコードされたタグは _tags_v1 と _tags_v2 の両方に格納されます。この IFD が TIFF 保存ルーチンで使用される場合、_tags_v2 が使用されます。タグは、legacy_api == true の場合、_tags_v1 から読み取る必要があります。

property legacy_api: bool

load(fp: IO[bytes]) → None

load_byte(data: bytes, legacy_api: bool = True) → bytes

load_double(data: bytes, legacy_api: bool = True) → tuple[Any, ...]

load_float(data: bytes, legacy_api: bool = True) → tuple[Any, ...]

load_long(data: bytes, legacy_api: bool = True) → tuple[Any, ...]

load_long8(data: bytes, legacy_api: bool = True) → tuple[Any, ...]

load_rational(data: bytes, legacy_api: bool = True) → tuple[tuple[int, int] | IFDRational, ...]

load_short(data: bytes, legacy_api: bool = True) → tuple[Any, ...]

load_signed_byte(data: bytes, legacy_api: bool = True) → tuple[Any, ...]

load_signed_long(data: bytes, legacy_api: bool = True) → tuple[Any, ...]

load_signed_rational(data: bytes, legacy_api: bool = True) → tuple[tuple[int, int] | IFDRational, ...]

load_signed_short(data: bytes, legacy_api: bool = True) → tuple[Any, ...]

load_string(data: bytes, legacy_api: bool = True) → str

load_undefined(data: bytes, legacy_api: bool = True) → bytes

named() → dict[str, Any]

戻り値:

name|key: value の辞書

可能な場合は名前付きタグを含む、完全なタグ辞書を返します。

property offset

property prefix

reset() → None

save(fp: IO[bytes]) → int

tagtype: dict[int, int]

タグ型の辞書

tobytes(offset: int = 0) → bytes

write_byte(data: bytes | int | IFDRational) → bytes

write_double(*values)

write_float(*values)

write_long(*values)

write_long8(*values)

write_rational(*values: IFDRational) → bytes

write_short(*values)

write_signed_byte(*values)

write_signed_long(*values)

write_signed_rational(*values: IFDRational) → bytes

write_signed_short(*values)

write_string(value: str | bytes | int) → bytes

write_undefined(value: bytes | int | IFDRational) → bytes

class PIL.TiffImagePlugin.TiffImageFile(fp: str | bytes | PathLike[str] | PathLike[bytes] | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'TIFF'

format_description: str | None = 'Adobe TIFF'

get_photoshop_blocks() → dict[int, dict[str, bytes]]

Photoshopの「イメージリソースブロック」の辞書を返します。キーはイメージリソースIDです。詳細については、https://www.adobe.com/devnet-apps/photoshop/fileformatashtml/#50577409_pgfId-1037727を参照してください。

戻り値:

辞書形式のPhotoshopの「イメージリソースブロック」。

load() → Image.core.PixelAccess | None

タイルリストに基づいて画像データをロードします

load_end() → None

load_prepare() → None

property n_frames: int

seek(frame: int) → None

指定されたフレームを現在の画像として選択します

tag: ImageFileDirectory_v1

レガシータグエントリ

tag_v2: ImageFileDirectory_v2

イメージファイルディレクトリ (タグ辞書)

tell() → int

現在のフレーム番号を返します

WebPImagePlugin モジュール

class PIL.WebPImagePlugin.WebPImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'WEBP'

format_description: str | None = 'WebP image'

load() → Image.core.PixelAccess | None

タイルリストに基づいて画像データをロードします

load_seek(pos: int) → None

seek(frame: int) → None

このシーケンスファイル内の指定されたフレームにシークします。シーケンスの終端を超えてシークすると、このメソッドは EOFError 例外を発生させます。シーケンスファイルを開くと、ライブラリは自動的にフレーム 0 にシークします。

tell() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

パラメータ:

frame – フレーム番号。0 から始まります。

発生する例外:

EOFError – 呼び出しがシーケンスの終端を超えてシークしようとした場合。

tell() → int

現在のフレーム番号を返します。seek() を参照してください。

定義されている場合、n_frames は利用可能なフレーム数を指します。

戻り値:

フレーム番号。0 から始まります。

WmfImagePlugin モジュール

class PIL.WmfImagePlugin.WmfStubImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベースクラス: StubImageFile

format: str | None = 'WMF'

format_description: str | None = 'Windows Metafile'

load(dpi: int | None = None) → Image.core.PixelAccess | None

タイルリストに基づいて画像データをロードします

PIL.WmfImagePlugin.register_handler(handler: StubHandler | None) → None

アプリケーション固有のWMFイメージハンドラーをインストールします。

パラメータ:

handler – ハンドラーオブジェクト。

XVThumbImagePlugin モジュール

class PIL.XVThumbImagePlugin.XVThumbImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'XVThumb'

format_description: str | None = 'XV thumbnail image'

XbmImagePlugin モジュール

class PIL.XbmImagePlugin.XbmImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'XBM'

format_description: str | None = 'X11 Bitmap'

XpmImagePlugin モジュール

class PIL.XpmImagePlugin.XpmImageFile(fp: StrOrBytesPath | IO[bytes], filename: str | bytes | None = None)

ベース: ImageFile

format: str | None = 'XPM'

format_description: str | None = 'X11 Pixel Map'

load_read(read_bytes: int) → bytes