hozugawa.net · A neutral informational page

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の値を使って転送先の矩形を毎回計算します。

次の項目を実装前後に確認すると、原因を切り分けやすくなります。

戻り値がゼロの場合は、GetLastErrorだけで判断せず、HDCや選択済みオブジェクトの状態も調べます。GDI関数のすべてが詳細なエラー情報を同じように提供するわけではないため、各APIの戻り値を記録し、処理段階ごとに検証する方法が有効です。

画質と透過処理の違い

BitBltは画素を拡大縮小せずに移すため、原寸表示や高速な画面更新に向いています。StretchBltはサイズ変換を一度に実行できますが、補間モードによって輪郭や文字の見え方が変わります。小さなアイコンを拡大する場合、元画像の解像度が低ければHALFTONEでも細部は復元できません。

項目 BitBlt StretchBlt
主な用途 原寸コピー、画面更新 拡大縮小、印刷プレビュー
サイズ指定 転送元と転送先が同じ 転送先サイズを変更可能
画質設定 基本的に不要 SetStretchBltModeを検討
処理負荷 比較的低い サイズ変更により増えやすい
透過 ROPや別処理が必要 ROPや別処理が必要

アルファ付き画像を自然に合成する場合は、AlphaBlendやGDI+、Direct2Dなどが適することがあります。BitBltやStretchBltに透過画像を渡すだけで、半透明の境界が自動的に正しく合成されるとは限りません。背景色との境界に黒い縁が出る場合は、ピクセル形式とアルファ値の扱いを確認します。

用途別の選び方

同一サイズのバックバッファをウィンドウへ表示するなら、BitBltが簡潔です。描画対象と表示領域の大きさが変わらないため、転送処理の意図も明確になります。スクロール表示ではコピー元の開始座標を変えるだけで、必要な範囲を効率よく表示できます。

画像ビューアーやサムネイル生成ではStretchBltが便利です。ただし、縦横比を固定するロジック、補間モード、余白の塗りつぶしをアプリケーション側で設計します。プリンターDCへ出力する場合は、画面上のピクセル数ではなく、印刷デバイスの解像度に合わせた論理単位も考慮します。

用途に応じた判断材料は次のとおりです。

安定した描画へ仕上げる手順

描画処理を安定させるには、まずリソースの所有者を決めます。ウィンドウごとにメモリDCを保持するのか、描画のたびに作成するのかで、初期化と解放の設計が変わります。頻繁な再作成は負荷やGDIハンドル消費につながるため、サイズ変更時だけ再構築する方法が実用的です。

続いて、原画像の寸法、表示先の寸法、選択中のビットマップ、描画モードをログで確認します。画面が真っ黒になる問題も、転送関数そのものではなく、空のメモリDC、未選択のビットマップ、解放済みHBITMAPが原因であることがあります。

最初の検証では、24ビットまたは32ビットの小さな画像をメモリDCへ選択し、SRCCOPYのBitBltで原寸表示した後、HALFTONEのStretchBltで半分のサイズへ転送するテストを順に実行します。