BitBltとStretchBltでビットマップを転送する
Windows APIで画像を描画するとき、デバイスコンテキスト間のビットマップ転送にはBitBltとStretchBltがよく使われます。前者はコピー元とコピー先を同じ大きさで転送し、後者は転送時に拡大縮小を行える点が大きな違いです。
どちらもGDI(Graphics Device Interface)に属する関数で、ウィンドウ、メモリDC、プリンターDC、互換ビットマップなどを組み合わせて利用します。画面更新、画像プレビュー、印刷、オフスクリーン描画など、古いWindowsアプリケーションから現在の保守案件まで登場する場面は少なくありません。
GDIの基本的な扱い方を確認するには、APIの宣言や定数を整理したWindows API資料も参照できます。実装では関数を呼ぶだけでなく、HDCの取得、HBITMAPの選択、座標、解放順序まで一貫して管理することが重要です。
BitBltの基本動作
BitBltは、コピー元の長方形領域をコピー先へ転送します。代表的な宣言は次の形です。
BOOL BitBlt(
HDC hdcDest,
int xDest, int yDest,
int width, int height,
HDC hdcSrc,
int xSrc, int ySrc,
DWORD rop
);
SRCCOPYを指定すると、コピー元の画素をそのまま転送できます。たとえばメモリDCに読み込んだビットマップをウィンドウへ表示する場合、BitBlt(hdc, 0, 0, cx, cy, memdc, 0, 0, SRCCOPY)のように記述します。転送先と転送元の幅・高さが異なる場合、画像は切り取られるか、余白が残ります。
ropはラスタオペレーションコードで、単純コピー以外の論理演算も指定できます。通常の画像表示ではSRCCOPYが中心ですが、マスク合成ではSRCANDやSRCPAINTを使う構成もあります。ただし、現代的な透過画像ではGDIの単純なROPだけで期待どおりのアルファ合成にならない場合があります。
StretchBltによる拡大縮小
StretchBltは、コピー元とコピー先にそれぞれ異なるサイズを指定します。基本形は次のとおりです。
BOOL StretchBlt(
HDC hdcDest,
int xDest, int yDest,
int destWidth, int destHeight,
HDC hdcSrc,
int xSrc, int ySrc,
int srcWidth, int srcHeight,
DWORD rop
);
コピー元が640×480、コピー先が320×240なら、幅と高さを半分にする縮小処理になります。逆に、コピー先を1280×960にすれば2倍に拡大できます。縦横比を維持したいときは、元画像の比率を計算して片方の寸法を決め、余白部分を背景色で塗りつぶします。
補間品質はSetStretchBltModeで指定します。COLORONCOLORは比較的高速ですが、拡大時に粗さが目立つことがあります。HALFTONEは縮小時の見た目が改善されやすい一方、処理前後にブラシ原点を設定すると結果が安定します。
SetStretchBltMode(hdcDest, HALFTONE);
SetBrushOrgEx(hdcDest, 0, 0, nullptr);
StretchBlt(hdcDest, dx, dy, dw, dh,
hdcSrc, sx, sy, sw, sh, SRCCOPY);
デバイスコンテキストとビットマップの準備
画面へ描画する場合は、BeginPaintで得たHDCやGetDCで取得したHDCをコピー先にします。ちらつきを抑えるには、CreateCompatibleDCでメモリDCを作り、CreateCompatibleBitmapで画面と互換性のあるビットマップを用意します。メモリDCへ描画をまとめてから、最後にBitBltで画面へ転送する方式が一般的です。
ビットマップをメモリDCへ選択するときは、以前選択されていたオブジェクトを保存します。描画後に元のオブジェクトへ戻してから、ビットマップ、メモリDCの順で解放すると、GDIオブジェクトの破棄に関する問題を避けられます。
HDC memDC = CreateCompatibleDC(screenDC);
HBITMAP bmp = CreateCompatibleBitmap(screenDC, width, height);
HBITMAP oldBmp = (HBITMAP)SelectObject(memDC, bmp);
// memDCへ描画し、BitBltまたはStretchBltで転送する
SelectObject(memDC, oldBmp);
DeleteObject(bmp);
DeleteDC(memDC);
画像ファイルから取得したDIBを扱う場合は、ピクセル形式やDIBセクションのメモリ配置にも注意が必要です。HBITMAPが有効でも、想定した色順や行の向きと一致するとは限らないため、表示が上下反転したときはBITMAPINFOの高さや変換処理を確認します。
実装時に確認する項目
座標とサイズの計算ミスは、画像の一部が欠ける、黒い領域が出る、意図しない引き伸ばしになるといった症状につながります。特にクライアント領域のサイズ変更時は、GetClientRectの値を使って転送先の矩形を毎回計算します。
次の項目を実装前後に確認すると、原因を切り分けやすくなります。
- コピー元とコピー先のHDCが有効である
- 転送元ビットマップが対象のメモリDCに選択されている
- 幅と高さがゼロや負数になっていない
SRCCOPYなどのROPコードが用途に合っているBitBltまたはStretchBltの戻り値を確認している
戻り値がゼロの場合は、GetLastErrorだけで判断せず、HDCや選択済みオブジェクトの状態も調べます。GDI関数のすべてが詳細なエラー情報を同じように提供するわけではないため、各APIの戻り値を記録し、処理段階ごとに検証する方法が有効です。
画質と透過処理の違い
BitBltは画素を拡大縮小せずに移すため、原寸表示や高速な画面更新に向いています。StretchBltはサイズ変換を一度に実行できますが、補間モードによって輪郭や文字の見え方が変わります。小さなアイコンを拡大する場合、元画像の解像度が低ければHALFTONEでも細部は復元できません。
| 項目 | BitBlt | StretchBlt |
|---|---|---|
| 主な用途 | 原寸コピー、画面更新 | 拡大縮小、印刷プレビュー |
| サイズ指定 | 転送元と転送先が同じ | 転送先サイズを変更可能 |
| 画質設定 | 基本的に不要 | SetStretchBltModeを検討 |
| 処理負荷 | 比較的低い | サイズ変更により増えやすい |
| 透過 | ROPや別処理が必要 | ROPや別処理が必要 |
アルファ付き画像を自然に合成する場合は、AlphaBlendやGDI+、Direct2Dなどが適することがあります。BitBltやStretchBltに透過画像を渡すだけで、半透明の境界が自動的に正しく合成されるとは限りません。背景色との境界に黒い縁が出る場合は、ピクセル形式とアルファ値の扱いを確認します。
用途別の選び方
同一サイズのバックバッファをウィンドウへ表示するなら、BitBltが簡潔です。描画対象と表示領域の大きさが変わらないため、転送処理の意図も明確になります。スクロール表示ではコピー元の開始座標を変えるだけで、必要な範囲を効率よく表示できます。
画像ビューアーやサムネイル生成ではStretchBltが便利です。ただし、縦横比を固定するロジック、補間モード、余白の塗りつぶしをアプリケーション側で設計します。プリンターDCへ出力する場合は、画面上のピクセル数ではなく、印刷デバイスの解像度に合わせた論理単位も考慮します。
用途に応じた判断材料は次のとおりです。
- 原寸のバックバッファ転送ならBitBlt
- ウィンドウサイズに合わせるならStretchBlt
- 半透明合成が中心ならAlphaBlendなど
- 高品質な2D描画ならGDI+やDirect2D
- 大量のフレーム更新では転送範囲を限定する
安定した描画へ仕上げる手順
描画処理を安定させるには、まずリソースの所有者を決めます。ウィンドウごとにメモリDCを保持するのか、描画のたびに作成するのかで、初期化と解放の設計が変わります。頻繁な再作成は負荷やGDIハンドル消費につながるため、サイズ変更時だけ再構築する方法が実用的です。
続いて、原画像の寸法、表示先の寸法、選択中のビットマップ、描画モードをログで確認します。画面が真っ黒になる問題も、転送関数そのものではなく、空のメモリDC、未選択のビットマップ、解放済みHBITMAPが原因であることがあります。
最初の検証では、24ビットまたは32ビットの小さな画像をメモリDCへ選択し、SRCCOPYのBitBltで原寸表示した後、HALFTONEのStretchBltで半分のサイズへ転送するテストを順に実行します。