PFM ファイルとは?
Portable FloatMap ファイルは、グレースケールまたは RGB のラスターサンプルを浮動小数点値として格納します。これらのサンプルは、表示用画像で一般的に使用される整数範囲の外側の値も表せます。
PFM ファイルの仕組み
PFM は、非圧縮の IEEE 754 形式の 32 ビット浮動小数点サンプルからなるラスターの前に、三行のテキストヘッダーを置きます。各行には、単一チャネル画像と三チャネル画像を区別する識別子、幅と高さ、バイトオーダーを示す符号付き数値が入ります。この形式には正式な仕様がありません。Netpbm のドキュメントによると、似た複数の形式がこの名称を共有しており、同ドキュメントでは既存ソフトウェアから推定した形式の一つを説明しています。Paul Debevec のページでも同じレイアウトが説明されています。メディアパイプラインでは、PFM は通常、数値処理の段階間で使う作業用または交換用の表現形式であり、ウェブや印刷向けの最終的な素材ではありません。
要点
- PFM ファイルは最初の行で識別します。
PFは画素ごとに三つのサンプル(RGB)、Pfは一つのサンプル(グレースケール)を意味します。二行目には幅と高さ、三行目には符号付き数値が入り、その直後にラスターが続きます。各サンプルは IEEE 754 形式の 4 バイトの非圧縮浮動小数点値です。そのため、ラスターのサイズはグレースケールで幅 × 高さ × 4 バイト、カラーではその三倍になります。ヘッダーにほかのフィールドはなく、Debevec の説明ではコメントも認められていないため、色空間と単位はファイル外で取り決める必要があります。 - ヘッダーの三番目の値の符号が、サンプルのバイトオーダーを決めます。負ならリトルエンディアン、正ならビッグエンディアンです。Netpbm は絶対値をスケール係数としても読み取り、別途共有された単位情報と組み合わせますが、Debevec の説明では、この数値はバイトオーダーの指定にのみ使われます。読み取り側がマシンのネイティブなバイトオーダーを前提にすると、逆の順序で書かれたファイルは不正な結果になります。また、書き込み側が値の大きさを利用していた場合、読み取り側がそれを無視すると絶対強度を誤って解釈するおそれがあります。
- Debevec と Netpbm のどちらの説明でも、行は下から上へ並びます。これは Netpbm 独自の PGM 形式や PPM 形式とは逆です。Netpbm のドキュメントによると、Adobe Photoshop が PFM と呼ぶ亜種では行が上から下へ並ぶため、この二つの規則の間でファイルを交換すると、エラーが出ないまま画像が上下反転します。FFmpeg も 2022 年後半の修正まで、PFM を上下反転させて読み書きしていました。パイプラインに新しいツールを加える際は、その都度、非対称のテスト画像で向きを確認してください。
PFM ファイルが重要になる場面
コンピュータービジョン、深度、科学、高ダイナミックレンジの中間データで、浮動小数点精度が重要な場合は PFM を選びます。対応アプリケーションの少なさとエンディアンの扱いにより、データ交換が複雑になることがあります。
Transloadit による PFM ファイル処理の支援
Transloadit の画像形式一覧は、/image/resize などの ImageMagick ベースの Robot を対象とし、これらの Robot が読み書きできる形式として PFM を掲載しています。
この一覧が示すのは、形式単位での読み書きへの対応のみです。PNG や JPEG などの整数形式へ変換する際に、行順序、スケール値、表示可能な範囲を外れる浮動小数点サンプルがどう扱われるかは示していません。代表的なファイルを Assembly で処理し、向きと明るさを確認してください。