CDC::MaskBlt

[アーティクル]
08/09/2011

指定されたマスクとラスターオペレーションを使って、転送元ビットマップと転送先ビットマップのカラーデータを組み合わせます。

BOOL MaskBlt(
   int x,
   int y,
   int nWidth,
   int nHeight,
   CDC* pSrcDC,
   int xSrc,
   int ySrc,
   CBitmap& maskBitmap,
   int xMask,
   int yMask,
   DWORD dwRop 
);

パラメーター

x
転送先四角形の左上隅の論理 x 座標を指定します。
y
転送先四角形の左上隅の論理 y 座標を指定します。
nWidth
転送先四角形と転送元ビットマップの幅を論理単位で指定します。
nHeight
転送先四角形と転送元ビットマップの高さを論理単位で指定します。
pSrcDC
ビットマップのコピー元になるデバイスコンテキストを識別します。パラメーター dwRop で転送元ビットマップを含まないラスターオペレーションを指定するときは、0 を指定します。
xSrc
転送元ビットマップの左上隅の論理 x 座標を指定します。
ySrc
転送元ビットマップの左上隅の論理 y 座標を指定します。
maskBitmap
転送元デバイスコンテキストのカラービットマップと組み合わされるモノクロのマスクビットマップを識別します。
xMask
パラメーター maskBitmap で指定されるマスクビットマップの水平方向のピクセルオフセットを指定します。
yMask
パラメーター maskBitmap で指定されるマスクビットマップの垂直方向のピクセルオフセットを指定します。
dwRop
フォアグラウンドとバックグラウンド両方の三項ラスターオペレーションコードを指定します。このオペレーションコードは、転送元データと転送先データの組み合わせを関数が制御するのに使います。バックグラウンドのラスターオペレーションコードは、この値の上位ワードの上位バイトに格納されます。フォアグラウンドのラスターオペレーションコードは、この値の上位ワードの下位バイトに格納されます。この値の下位ワードは無視しますが 0 にしておく必要があります。マクロ MAKEROP4 は、このようなフォアグラウンドとバックグラウンドのラスターオペレーションコードの組み合わせを作成します。この関数でのフォアグラウンドとバックグラウンドの説明については、「解説」を参照してください。標準のラスターオペレーションコードの一覧については、BitBlt メンバー関数を参照してください。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

maskBitmap で指定されるマスク値の 1 は、dwRop で指定されるフォアグラウンドラスターオペレーションコードがその位置で適用されることを示します。マスク値の 0 は、dwRop で指定されるバックグラウンドラスターオペレーションコードがその位置で適用されることを示します。ラスターオペレーションが転送元ビットマップを必要とするときは、マスク四角形は転送元四角形を覆っている必要があります。マスク四角形が転送先四角形を覆っていないと、関数は失敗します。ラスターオペレーションが転送元ビットマップを必要としないときは、マスク四角形は転送先四角形を覆っている必要があります。マスク四角形が転送先四角形を覆っていないと、関数は失敗します。

この関数が呼び出されたとき、回転や傾斜による変形が転送元デバイスコンテキストに影響を与える場合は、エラーが発生します。その他の変形は可能です。

転送元ビットマップ、パターンビットマップ、および転送先ビットマップのカラーフォーマットが違っているときは、転送元のカラーフォーマットと、パターンのカラーフォーマットを転送先のカラーフォーマットに変換します。マスクビットマップがモノクロビットマップではない場合、エラーが発生します。拡張メタファイルを記録中に、転送元デバイスコンテキストが拡張メタファイルのデバイスコンテキストを識別したときは、エラーが発生し、関数は 0 を返します。すべてのデバイスが MaskBlt をサポートしているわけではありません。デバイスがこの関数をサポートしているかどうかを調べるために、アプリケーションは GetDeviceCaps 関数を呼び出す必要があります。マスクビットマップが渡されなかったときは、フォアグラウンドのラスターオペレーションコードを使って、BitBlt 関数とまったく同じ動作をします。マスクビットマップのピクセルオフセットは、転送元デバイスコンテキストのビットマップの点 (0,0) に割り当てられます。これは、マスクビットマップがマスクの組を持っているときに便利です。アプリケーションは、MaskBlt に送られるピクセルオフセットや四角形のサイズを調整することによって、マスクの中の適切な 1 つをマスク作業に適用できます。