PBM ファイルとは
Portable Bitmap ファイルは、白黒二値画像用の Netpbm ラスター形式です。各ピクセルは二つの値のいずれかを取り、意図的に単純化されたテキストまたはバイナリの符号化で表現されます。
PBM ファイルの仕組み
PBM は Netpbm ファミリーの二値画像形式で、同じファミリーには PGM(グレースケール)と PPM があります。PNM はこの三つの総称で、PAM は四つ目の、より汎用的な形式です。PBM 画像は短い ASCII ヘッダーと、その後に続くラスターデータで構成されます。二文字のマジックナンバー、空白文字で区切られた十進数の幅と高さが続き、その後に各行のピクセルが左から右、行が上から下の順に並びます。PBM には、PGM で高さの後に追加される最大値フィールドはありません。ラスターデータより前では、# から行末までのテキストはコメントです。raw 形式はピクセルをバイトに詰め込みますが、従来の plain 形式では、各ピクセルを ASCII の 1 または 0 で記述します。より豊かな画像表現には、PGM、PPM、PAM、または別の形式が必要です。
要点
- 拡張子ではなく、先頭の二バイトで種類を識別してください。
P4はビットを詰め込んだバイナリ形式(raw)、P1は ASCII 形式(plain)です。慣例的な拡張子は.pbmですが、.pnmも PBM、PGM、PPM に共通して使われます。IANA に登録されたメディアタイプはありません(慣例的な値はimage/x-portable-bitmapです)。使用するライブラリが両方の種類を読み込めることを確認してください。Pillow のドキュメントによると、書き込みは raw 形式で行い、plain 形式のP1からP3までのファイルの読み込みは、バージョン 9.2.0 以降でのみ対応しています。 - raw PBM では各行を最上位ビットから順に、8 ピクセルずつ一バイトに詰め込み、行の最後のバイトの余りは値が不定のビットで埋めます。したがって、一行のバイト数は幅を 8 で割って切り上げた値です。ラスターデータを一つの連続したビットストリームとして扱う読み込み処理では、幅が 8 の倍数でない場合、二行目以降のすべての行で位置がずれます。高さとラスターデータの間には、ちょうど一文字の空白文字を置きます。
- 保存値
1は黒、0は白を表します。これは、ゼロが黒で最大値が白の PGM や、タプル型がBLACKANDWHITEで、黒に 0、白に 1 を使う PAM 画像とは逆です。保存された PBM のビットを明度値や PAM のサンプル値に直接対応づけるコードでは、値を反転する必要があります。ただし、デコードライブラリがすでに反転している場合もあります。Pillow は保存値 1 を 0 に、保存値 0 を 255 に変換します。再度反転する前に、ライブラリの戻り値を確認してください。 - 二つの種類は、符号化以外の点でも異なります。plain ファイルには画像がちょうど一つ入り、埋め合わせ用のビットはなく、ラスターデータ内の空白文字は無視されます。一行は 70 文字以内に収めることが推奨されます。raw ファイルには複数の画像を連続して格納できます。仕様では 2000 年7月からこれを認めていますが、現在もほとんどのツールは最初の画像しか読み込まないと記されています。最も幅広い互換性を得るため、仕様では
P4、改行、スペースで区切った幅と高さ、改行、単一のラスターデータの順に書き込むことを推奨しています。
PBM ファイルの用途
PBM は、画像ツール間で受け渡すバイナリマスクなど、二値データの中間形式として使用します。Netpbm 仕様では、効率を一切考慮しない中間形式と位置付けられており、通常、ファイルの保存や転送に使う形式ではないと説明されています。グレースケール、カラー、部分的な透明度を表現するには、別の形式への変換が必要です。
PBM ファイル処理での Transloadit の活用
Transloadit の画像形式一覧では、/image/resize を含む ImageMagick ベースの
Robot が読み書きできる形式として PBM が掲載されています。その Robot の format パラメーターには、一覧で書き込み可能とされているすべての形式を指定できます。
一覧には、PBM 出力が raw 形式と plain 形式のどちらで書き込まれるかは記載されていません。後続のツールでどちらかが必要な場合は、出力のマジックナンバーを確認してください。
出典
- Netpbm:PBM 形式の仕様(構造、最小サブセット、plain PBM、メディアタイプ、互換性)
- Netpbm:PBM、PGM、PPM の総称 PNM
- Netpbm:PGM 形式の仕様(最大値、ゼロが黒)
- Netpbm:PAM 形式の仕様(BLACKANDWHITE タプル型、不透明度プレーン)
- Pillow ハンドブック:PPM の項(バージョン別の PBM、PGM、PPM 読み書き対応)
- Pillow ソース:PpmImagePlugin.py(ビットを反転する PBM デコード)
- Pillow の Issue #860 :ASCII の .pbm、.pgm、.ppm ファイルを開くと画像ファイルを識別できない問題