CDC::StretchBlt

Článek
03/04/2013

Rastrový obrázek ze zdrojového obdélníku se zkopíruje do cílového obdélníku roztažení nebo komprese bitmapy v případě potřeby přizpůsobit rozměry cílového obdélníku.

BOOL StretchBlt(
   int x,
   int y,
   int nWidth,
   int nHeight,
   CDC* pSrcDC,
   int xSrc,
   int ySrc,
   int nSrcWidth,
   int nSrcHeight,
   DWORD dwRop 
);

Parametry

x
Určuje souřadnice x (v logické jednotky) horního levého rohu cílového obdélníku.
y
Určuje souřadnici y (v logické jednotky) horního levého rohu cílového obdélníku.
nWidth
Určuje šířku (v logické jednotky) cílového obdélníku.
nHeight
Určuje výšku (v logické jednotky) cílového obdélníku.
pSrcDC
Určuje zdroj kontextu zařízení.
xSrc
Určuje souřadnice x (v logické jednotky) levého horního rohu zdrojového obdélníku.
ySrc
Určuje souřadnice x (v logické jednotky) levého horního rohu zdrojového obdélníku.
nSrcWidth
Určuje šířku (v logické jednotky) zdrojového obdélníku.
nSrcHeight
Určuje výšku (v logické jednotky) zdrojového obdélníku.
dwRop
Určuje rastrové operace provést.Rastrové operace kódy definovat jak GDI Zkombinuje barvy ve výstupních operací zahrnujících aktuální stopy, možným zdrojem bitmapy a určení bitmapy.Tento parametr může být jedna z následujících hodnot:
- ČERNÉ zapne všechny výstupní černé.
- DSTINVERT Invertuje určení bitmapy.
- MERGECOPY kombinuje vzorek a zdrojová bitmapa logická a operátorem.
- MERGEPAINT kombinuje obráceným zdrojová bitmapa rastrovým obrázkem cíl pomocí logický operátor OR.
- NOTSRCCOPY obráceným zdrojová bitmapa zkopíruje do cílového umístění.
- NOTSRCERASE Invertuje výsledkem sloučení zdrojový a cílový bitmapy pomocí logický operátor OR.
- PATCOPY vzorek zkopíruje do cílového bitmapy.
- PATINVERT kombinuje bitmapové určení vzorku pomocí operátoru XOR logickou.
- PATPAINT kombinuje obráceným zdrojová bitmapa s operátorem logická nebo vzorek.Kombinuje s určení bitmapy pomocí operátoru logická nebo výsledek této operace.
- SRCAND kombinuje zdrojový a cílový bitmapy pomocí operátoru logická a obrazové body.
- SRCCOPY zdrojová bitmapa zkopíruje do cílového bitmapy.
- SRCERASE Invertuje určení bitmapy a zkombinuje výsledek se zdrojová bitmapa operátorem logická A.
- SRCINVERT kombinuje zdrojový a cílový bitmap pomocí operátoru XOR logickou pixelů.
- SRCPAINT kombinuje pixelů zdrojový a cílový bitmapy pomocí logický operátor OR.
- BÍLÉ zapne všechny výstupní bílou.

Vrácená hodnota

Nenulová hodnota, pokud je nakreslena bitmapy; jinak 0.

Poznámky

Roztažení režimu kontextu cílové zařízení využívá funkce (nastavit SetStretchBltMode ) k určení způsobu roztáhnout nebo zúžit bitmapy.

StretchBlt Funkce přesune bitmapy ze zdrojového zařízení dána pSrcDC do cílového zařízení nazývá jehož členské funkce objektu kontext zařízení. xSrc , ySrc , nSrcWidth , A nSrcHeight parametry definovat levého horního rohu a rozměry zdrojového obdélníku.x, y, nWidth , a nHeight parametry poskytují levého horního rohu a rozměry cílového obdélníku.Rastrové operace podle dwRop definuje, jak kombinovat zdrojová bitmapa a bitů již na cílové zařízení.

StretchBlt Funkce vytvoří zrcadlový obraz bitmapy, pokud příznaky nSrcWidth a nWidth nebo nSrcHeight a nHeight parametry se liší.Pokud nSrcWidth a nWidth mají rozdílná znaménka funkce vytvoří zrcadlový obraz bitmapy podél osy x.Pokud nSrcHeight a nHeight mají rozdílná znaménka funkce vytvoří zrcadlový obraz bitmapy podél osy y.

StretchBlt Funkce roztáhne nebo komprimuje zdrojová bitmapa v paměti a výsledek pak zkopíruje do cílového umístění.Pokud vzorek je sloučena s výsledkem, není to sloučeny, dokud roztažený zdrojová bitmapa se zkopíruje do cílového.Pokud je použit stopu, je vybrané stopy v kontextu cílové zařízení.Cílové souřadnice jsou transformovány podle kontextu cílové zařízení; transformací souřadnic zdroje podle kontextu zdrojového zařízení.

Pokud cíl, zdroje a vzorek bitmapy nemají stejný formát barev, StretchBlt převede zdroje a vzorek bitmapy tak, aby odpovídalo cílové bitmapy.Barvy popředí a pozadí kontextu cílové zařízení se používají při převodu.

Pokud StretchBlt barvu, musíte převést monochromatické bitmapové bílé bitů (1) nastaví barvu pozadí a barvu popředí černá bitů (0).Převést na černobílý tisk barev, nastaví obrazové body, které odpovídají barvu pozadí bílá (1) a nastaví všechny pixely na černou (0).Jsou použity barvy popředí a pozadí kontextu zařízení s barvou.

Některá zařízení neumožňují StretchBlt funkce.Chcete-li zjistit, zda zařízení podporuje StretchBlt , volání GetDeviceCaps členské funkce s RASTERCAPS index a zkontrolujte návratovou hodnotu pro RC_STRETCHBLT příznak.