CDC::MaskBlt

Článek
03/04/2013

Kombinuje data barev pro zdrojové a cílové bitmapy pomocí dané masku a rastrové operace.

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

Parametry

x
Určuje logické souřadnici x levého horního rohu cílového obdélníku.
y
Určuje logické souřadnici y levého horního rohu cílového obdélníku.
nWidth
Určuje šířku v logické jednotky cílového obdélníku a zdroj bitmapy.
nHeight
Určuje výšku v logické jednotky cílového obdélníku a zdroj bitmapy.
pSrcDC
Určuje kontext zařízení, ze kterého je bitmapa je zkopírovat.Musí být nula Pokud dwRop parametr určuje rastrové operace, která neobsahuje zdroj.
xSrc
Určuje logické souřadnici x levého horního rohu zdrojová bitmapa.
ySrc
Určuje logické souřadnici y levého horního rohu zdrojová bitmapa.
maskBitmap
Identifikuje monochromatické maska bitmapy v kombinaci s barevné bitmapy v kontextu zdrojového zařízení.
xMask
Určuje posun vodorovných pixelů pro bitmapové masky určený maskBitmap parametr.
yMask
Určuje posun svislých pixelů pro bitmapové masky určený maskBitmap parametr.
dwRop
Určuje popředí a pozadí Ternární rastrové operace kódy, které využívá funkce řízení kombinaci zdrojové a cílové data.Kód pozadí rastrové operace je uložen v bajtu vysoké Word tato hodnota; kód popředí rastrové operace je uložen v dolní bajt vysoké word tato hodnota; dolní slovo této hodnoty je ignorován a by měla být nula.Makro MAKEROP4 vytváří rastrové operace kódy takové kombinace popředí a pozadí.Naleznete v části poznámky pro diskusi na popředí a pozadí v rámci této funkce.Najdete BitBlt seznam běžných rastrové operace kódů členské funkce.

Vrácená hodnota

Nenulová hodnota, pokud je tato funkce úspěšná. jinak 0.

Poznámky

Hodnota 1 v masce určené maskBitmap označuje, že kód popředí rastrové operace určené dwRop by měla být uplatňována na tomto místě.Hodnota 0 v masce označuje, že kód pozadí rastrové operace určené dwRop by měla být uplatňována na tomto místě.Pokud rastrové operace vyžadují zdroje, musí zahrnovat obdélník maska zdrojového obdélníku.Pokud ne, funkce se nezdaří.Pokud rastrové operace nevyžadují zdroj, musí zahrnovat obdélník maska cílového obdélníku.Pokud ne, funkce se nezdaří.

Otočení nebo zkosení transformace je zdroj kontextu zařízení při této funkce je volána, dojde k chybě.Jsou však povoleny jiné typy transformací.

Pokud se liší barvy formáty zdroje, vzorek a určení bitmapy, tato funkce převádí vzorek nebo formát zdroje nebo obojí, odpovídající cílový formát.Bitmapové masky není monochromatické bitmapové, dojde k chybě.Pokud metasoubor je zaznamenávána, dojde k chybě (a vrátí 0) Pokud kontext zařízení zdroje určuje kontext zařízení rozšířený metasoubor.Některá zařízení neumožňují MaskBlt .Aplikace by měla zavolat GetDeviceCaps zjistit, zda zařízení podporuje tuto funkci.Pokud je zadán žádný bitmapové masky, tato funkce chová přesně jako BitBlt , pomocí kódu popředí rastrové operace.Obrazový bod odsadí v mapě bitmapové masky bodu (0,0) v kontextu zařízení zdroj bitmapy.To je užitečné v případech, ve kterých bitmapové masky obsahuje sadu masky; aplikaci můžete snadno použít jeden z nich maska blitting úkolu úpravou posun obrazových bodů a velikosti obdélníku odeslána MaskBlt .