Pillow TiffTags モジュール

TiffTags は、Python Pillow(PIL)画像処理ライブラリのサブモジュールで、TIFF(Tagged Image File Format)画像ファイル内のタグ(Tags)情報を処理するために特化しています。

TIFF は柔軟なビットマップ画像形式であり、複数の圧縮方式と色空間をサポートし、プロフェッショナルな画像処理分野で広く使用されています。

TIFF ファイルでは、画像のさまざまな属性やメタデータがタグに格納されており、TiffTags モジュールはこれらのタグにアクセスして操作する機能を提供します。

インポート方法:

from PIL.TiffTags import TAGS_V2

主な機能

TiffTags モジュールは主に以下の機能を提供します:

  1. 標準の TIFF タグとその属性を定義する
  2. タグ名と ID の間のマッピングを提供する
  3. タグのデータ型と値の範囲を説明する
  4. カスタムタグの処理をサポートする

コアメソッドの詳細

TiffTags モジュールの主要メソッド

以下は、TiffTags モジュールで最も一般的に使用されるメソッドとその説明です:

メソッド/属性 説明 戻り値の型 例
TiffTags.TAGS_V2 すべての標準 TIFF タグを含む辞書。キーはタグ ID、値はタグ情報です dict {256: (256, 'ImageWidth', 4, 1, None), ...}
TiffTags.TAGS 旧バージョンの TIFF タグ辞書(互換性のために保持) dict TAGS_V2 と同じ
TiffTags.LOOKUP タグ名から ID へのマッピング辞書 dict {'ImageWidth': 256, ...}
TiffTags.IFD IFD(画像ファイルディレクトリ)タグの集合 dict IFD 関連のタグを含む
TiffTags.CUSTOM_TAGS カスタムタグを格納するための辞書 dict ユーザー定義

タグ情報の構造

各 TIFF タグの情報は、5つの要素を含むタプルです:

  1. タグ ID(整数)
  2. タグ名(文字列)
  3. データ型(整数、TIFF 仕様に対応)
  4. 値の長さ(整数)
  5. デフォルト値または特別な説明(オプション)

データ型対応表

型コード データ型 説明
1 BYTE 8ビット符号なし整数
2 ASCII 7ビット ASCII 文字
3 SHORT 16ビット符号なし整数
4 LONG 32ビット符号なし整数
5 RATIONAL 2つの LONG、分数を表す
6 SBYTE 8ビット符号付き整数
7 UNDEFINED 8ビット未定義データ
8 SSHORT 16ビット符号付き整数
9 SLONG 32ビット符号付き整数
10 SRATIONAL 2つの SLONG、符号付き分数を表す
11 FLOAT 32ビット IEEE 浮動小数点数
12 DOUBLE 64ビット IEEE 浮動小数点数

実際の応用例

例1:すべてのTIFFタグを表示

インスタンス

from PIL.TiffTags import TAGS_V2

# すべての標準TIFFタグを出力
for tag_id, tag_info in TAGS_V2.items():
    print(f"ID: {tag_id}, Name: {tag_info[1]}, Type: {tag_info[2]}")

例2:名前でタグIDを検索

インスタンス

from PIL.TiffTags import LOOKUP

# "Artist"タグのIDを検索
artist_tag_id = LOOKUP.get('Artist')
print(f"Artist tag ID: {artist_tag_id}")  # 出力: 315

例3:TIFFファイルのタグ情報を読み取る

インスタンス

from PIL import Image
from PIL.TiffTags import TAGS

# TIFFファイルを開く
with Image.open('example.tif') as img:
    # すべてのタグを取得
    if hasattr(img, 'tag'):
        for tag_id, value in img.tag.items():
            tag_name = TAGS.get(tag_id, tag_id)
            print(f"{tag_name}: {value}")

高度な使い方

カスタムタグの処理

インスタンス

from PIL import Image
from PIL.TiffTags import TAGS_V2, CUSTOM_TAGS

# カスタムタグを定義
CUSTOM_TAGS = {
    50000: (50000, 'MyCustomTag', 2, 1, None)
}

# 標準タグとカスタムタグをマージ
ALL_TAGS = {**TAGS_V2, **CUSTOM_TAGS}

# カスタムタグを使用してTIFFファイルを保存
img = Image.new('RGB', (100, 100))
img.save('custom.tif', tiffinfo={50000: 'CustomValue'})

よくある質問と回答

Q1: 一部のTIFFタグが読み取れないのはなぜですか?

A1: タグが標準のTAGS_V2で定義されていないか、プライベートタグが使用されている可能性があります。ファイルの仕様を確認するか、ファイル作成者にタグの定義を問い合わせてみてください。

Q2: タグのデータ型を知るにはどうすればよいですか?

A2: TAGS_V2辞書を使用して各タグのデータ型を照会できます。例えば、TAGS_V2[256][2]は ImageWidth タグのデータ型コードを返します。

Q3: TIFFタグを変更できますか?

A3: はい、Pillowのsaveメソッドとtiffinfoパラメータを組み合わせてタグを変更または追加できます。ただし、すべてのタグが変更できるわけではなく、一部は読み取り専用であることに注意してください。


まとめ

TiffTags モジュールは、Pillow ライブラリで TIFF 画像のメタデータを処理するための重要なツールです。この記事の説明を通じて、以下のことを理解できたはずです:

  1. 標準の TIFF タグにアクセスして照会する方法
  2. タグ情報のデータ構造
  3. 実際のアプリケーションでタグを読み書きする方法
  4. カスタムタグの処理方法

これらの知識を習得すれば、TIFF 画像ファイル内のメタデータ情報をより効率的に処理できるようになります。

その他の拡張