FAX ゲートウェイは 24 ビットのページレンダリングを欲しがりません。100 万件のスキャン風請求書を保存するアーカイブパイプラインも同様ですし、文字認識の前にすべてを白黒へしきい値処理する OCR フロントエンドも同じです。3 者が欲しいものは一致しています。1 ピクセル 1 ビット、各ドットがインクか紙かのどちらかである、きれいな 1 ビットビットマップです。フルカラー BMP を渡しても、先方はどうせ 1 ピクセルあたり 23 ビットを捨てます。しかも、たいていは自分でやるより質の悪いディザ処理でです。面白いのは、そのダウンコンバートをどこで行うべきかという点で、PDF Library for Delphi の答えは、できれば書き換えたくないレンダラをどう拡張するかについて有用な示唆を与えてくれます
PDF Library for Delphi は Delphi と C++Builder 向けのネイティブ Object Pascal PDF ライブラリです。そのレンダリングコアはページをビットマップへラスタライズし、BMP、PNG、JPEG、WMF などいくつかの形式で出力できます。真のモノクロビットマップを返す機能と、ページの一部だけをレンダリングする機能は、どちらも v3.83.0 以降で使えます。どちらもラスタライザそのものを変えるのではなく、既存レンダラの上に載る薄い便利層として実装されました。この制約こそが話の中心です
なぜダウンコンバートはレンダラ内ではなく、レンダリング後に行うのか
1 ビット画像を作る分かりやすい方法は、ラスタライザに 1 ビットで描画させることです。しかし、それは同時にほかのすべてを壊す方法でもあります。レンダラ内部のビットマップは PDFlibRenderer のコンストラクタで PixelFormat := pf24bit とハードコードされて生成され、この 24 ビットのサーフェスはすべてのレンダリング経路で共有されています。PNG エクスポート、デバイスコンテキストプレビュー、JPEG 出力、そのすべてです。ソースで pf1bit に切り替えると、モノクロ機能を追加したことにはならず、ライブラリの全呼び出し元のカラー忠実度を下げ、下流の退行を何ダースもデバッグするはめになります
そのため RenderPageToMonochromeFile は逆の道を取ります。ページはまず通常どおり一時的な 24 ビット BMP にレンダリングし、その後でだけ 1 ビットへ畳み込みます。レンダラ自体には一切触れません。モノクロ化の振る舞いは完全に便利メソッドの中に閉じているため、それを呼ばない利用者には何の影響もありません。この種のトレードオフは明示しておく価値があります。後処理方式はビットマップ割り当てと一時ファイルを 1 つ余分に払いますが、その代わりに重荷を支えるコアを完全にスコープ外へ置けます。FAX やアーカイブの端ケースに応えるための機能としては、こちらが正しい判断です
var
Pdf: TPDFlib;
begin
Pdf := TPDFlib.Create;
try
Pdf.LoadFromFile('invoice.pdf');
// 200 DPI は標準の Group 4 FAX 解像度です。ページ番号は 1 始まりです
Pdf.RenderPageToMonochromeFile(200, 1, 'invoice-page1.bmp');
finally
Pdf.Free;
end;
end;
1 ビットへの畳み込みは実際にどう行われるのか
ダウンコンバートは、手書きのしきい値ループではなく GDI に頼っています。この選択は出力品質に関わります。メソッド内部では、24 ビットの一時ビットマップを TBitmap に読み込み、同じ寸法で PixelFormat := pf1bit を指定した 2 つ目の TBitmap を作り、ピクセルを 1 回の blit で移動させます
// RenderPageToMonochromeFile 内、24 ビット ColorBmp を読み込んだ後
MonoBmp.PixelFormat := pf1bit;
MonoBmp.Width := ColorBmp.Width;
MonoBmp.Height := ColorBmp.Height;
// HALFTONE は GDI に 24 ビット元画像を 1 ビットへディザリングするよう指示します
SetStretchBltMode(MonoBmp.Canvas.Handle, HALFTONE);
StretchBlt(MonoBmp.Canvas.Handle, 0, 0, MonoBmp.Width, MonoBmp.Height,
ColorBmp.Canvas.Handle, 0, 0, ColorBmp.Width, ColorBmp.Height, SRCCOPY);
MonoBmp.SaveToFile('out.bmp');
肝は HALFTONE を指定した SetStretchBltMode です。ソースと転送先は同じサイズなのでスケーリングは発生しませんが、それでもストレッチモードは、GDI がカラーを 1 ビットパレットへどう割り当てるかを決めます。HALFTONE はハーフトーンディザリングを適用させ、グレーの領域やアンチエイリアスされた文字の縁を、2 色の近いほうへの硬い切り詰めではなく、白と黒のドットパターンに変えます。モード指定を外すか、デフォルトの BLACKONWHITE を使うと、グレースケールの内容はブロック状のしきい値処理された形にポスタライズされます。スキャン文書や OCR 前処理の出力としては、ディザリングされた結果のほうがほとんどの場合望ましいものです
ここで 1 つ譲れず、しかも間違えやすい点があります。一時レンダリングは必ず BMP でなければなりません。RenderPageToMonochromeFile は、汎用レンダラにオプションコード 0、つまり BMP を渡して呼び出します。RenderPageToFile の options 引数は小さな整数の列挙で、この目的では値を取り替えることはできません。0 は BMP、1 は JPEG、2 は WMF、3 は EMF、5 は PNG、という具合です。ダウンコンバータはその後、一時ファイルに TBitmap.LoadFromStream を行います。2 を渡して WMF を食わせると、この読み込みは "Bitmap image is not valid" を投げます。Windows Metafile はベクタのレコードストリームであって DIB ではないからです。モノクロへのダウンコンバートは最初から最後までラスタ処理なので、中間形式もラスタでなければなりません
ページの部分領域だけをレンダリングする
2 つ目のメソッド RenderPageRegionToFile は、ページ全体ではなくページ内の矩形だけをレンダリングします。ドキュメントビューアを作ったことのある人には、用途は見覚えがあるでしょう。契約書から署名ブロックを切り出す、大きな図面のズームマップ用にタイルを生成する、高 DPI でページ全体をラスタライズするコストを払わずに、スタンプの押された 1 領域だけをサムネイルとして取り出す。シグネチャは素直です
// Clip は PDF ポイント単位の "Left,Top,Width,Height" です (72 pt = 1 インチ)
// 例: ページ左上から 1 インチ内側にある 2.5 インチ x 1 インチの矩形
Pdf.RenderPageRegionToFile(150, 1, '72,72,180,72', 'sig-block.bmp');
clip 文字列は PDF ポイント単位の 4 つのカンマ区切り double で、ロケールや DelimitedText の癖を回避するため、メソッド内部で手動でパースされます。width と height から、メソッドは出力ビットマップのサイズを Round(Width * DPI / 72) × Round(Height * DPI / 72) として計算し、まさにそのサイズのメモリ内 pf24bit ビットマップを確保し、RenderPageToDCClip を通じてそのデバイスコンテキストへレンダリングします。結果のファイルには切り出した矩形だけが含まれ、サイズはページ全体ではなく領域のものになります
Clip 矩形がデバイスコンテキストへ届くまで
領域経路を支えているのは RenderPageToDCClip とその Clip パラメータで、この呼び出しはそれを TPDFPageTree.RenderPageToDC へと渡します。この種のレイヤー化された API の罠は、トップでは受け付けられ、途中のどこかで落とされるパラメータです。呼び出し側は好きな矩形を渡し、黙ってページ全体を受け取り、レイアウトによっては誰も気づきません
RenderPageToDC は同じ "Left,Top,Width,Height" のポイント矩形をパースし、レンダラが描画する前に、実際の GDI クリップ領域としてターゲットのデバイスコンテキストへ適用します。ポイントからデバイスピクセルへの変換は、おなじみの DPI / 72 のスケール係数で、4 辺すべてに適用されます。レンダリングを囲む一連の処理は、標準的な save/clip/restore のダンスです
// TPDFPageTree.RenderPageToDC 内、Clip が空でない場合
ScaleFactor := DPI / 72;
SaveDC(TargetDC);
IntersectClipRect(TargetDC,
Round(ClipLeft * ScaleFactor),
Round(ClipTop * ScaleFactor),
Round((ClipLeft + ClipWidth) * ScaleFactor),
Round((ClipTop + ClipHeight) * ScaleFactor));
// ...ここでレンダラがページを描画します...
// finally ブロック内:
RestoreDC(TargetDC, -1);
SaveDC / RestoreDC(-1) の対句があるからこそ、この呼び出しは繰り返しても安全です。クリップ領域は DC の状態スタックに積まれ、ページが描画され、レンダリングがどう終わろうと元のクリップが戻されます。RestoreDC(TargetDC, -1) は最後に保存された状態を復元する、保存と復元を対にする標準的な書き方です。復元を忘れると、同じ DC を後続のページ全体レンダリングで再利用する呼び出し元は、なぜか最後の領域にクリップされたままになります。RenderPageRegionToFile はまさにこの経路を通るため、同じ挙動をただで得ています
理解しておくべき挙動が 1 つあります。この clip は 切り抜くのであって、拡大縮小する わけではありません。ページは指定した DPI のまま通常位置でラスタライズされ、clip 領域の外側が捨てられるだけです。領域を出力いっぱいにズームしているわけではありません。拡大したいなら DPI を上げてください。矩形座標はポイントからピクセルへ変換されたあとのデバイス空間で解釈され、レンダリング面の左上を基準とします。したがって LeftTopTopBottom はページ上端から下向きに計画してください。PDF Library for Delphi が画面出力のためにデバイスコンテキストをどう駆動するかをより詳しく追うなら、関連稿 印刷プレビューとデバイスコンテキスト出力
出力フォーマット:非圧縮の 1 ビット BMP
RenderPageToMonochromeFile が作るのは、非圧縮の pf1bit BMP です。正しいピクセル形式で、ディザリング済み、すぐに使えます。ほとんどの FAX、アーカイブ、OCR ツールチェーンはこれをそのまま受け入れるか、下流の 1 ステップで CCITT Group 4 TIFF に変換します。FAX ワークフローや TIFF アーカイブが G4 を期待しているなら、その圧縮ステージは自分のパイプラインに組み込んでください
どちらのメソッドも意図的に小さく、そのこと自体がこのページから持ち帰るべき設計上の教訓です。レンダラの上に載る便利 API でも、モノクロ出力や領域切り抜きといった実際の能力を、ラスタライザへ踏み込んで他の呼び出し元すべてを不安定にすることなく追加できます。基盤のラスタライズのためにレンダリングエンジンを選ぶ必要が出たら、Delphi でのマルチエンジン PDF レンダリングの概説がトレードオフを深く扱っています。レンダリングサーフェスの全体と API の残りを見るには、PDF Library for Delphi(Delphi PDF ライブラリ)の製品ページが完全な情報源です