CDC::StretchBlt

Artykuł
02/27/2013

Kopiuje bitmapy z prostokąta źródłowego do docelowego prostokąta, rozciągnięcie lub kompresowanie bitmapy, jeśli to konieczne dopasować wymiary prostokąta przeznaczenia.

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

Parametry

x
Określa współrzędną x (w jednostkach logicznych) lewym górnym rogu prostokąta przeznaczenia.
y
Określa współrzędną y (w jednostkach logicznych) lewym górnym rogu prostokąta przeznaczenia.
nWidth
Określa szerokość (w jednostkach logicznych) prostokąt docelowy.
nHeight
Określa wysokość prostokąta przeznaczenia (w jednostkach logicznych).
pSrcDC
Określa źródło kontekstu urządzenia.
xSrc
Określa współrzędną x (w jednostkach logicznych) lewym górnym rogu prostokąta źródłowego.
ySrc
Określa współrzędną x (w jednostkach logicznych) lewym górnym rogu prostokąta źródłowego.
nSrcWidth
Określa szerokość prostokąta źródłowego (w jednostkach logicznych).
nSrcHeight
Określa wysokość prostokąta źródłowego (w jednostkach logicznych).
dwRop
Określa wykonywanej operacji rastrowe.Kody operacji rastrowych zdefiniować jak GDI łączy kolory w operacji wyjścia, obejmujących bieżący pędzel, bitmapy możliwe źródło i mapy bitowej miejsca przeznaczenia.Ten parametr może być jedną z następujących wartości:
- BLACKNESS włącza wszystkie wyjściowe czarny.
- DSTINVERT odwraca mapy bitowej miejsca przeznaczenia.
- MERGECOPY łączy deseń i źródłowa bitmapa przy użyciu operatora logiczna I.
- MERGEPAINT łączy odwrócony źródłowa bitmapa z mapy bitowej miejsca przeznaczenia za pomocą operatora logiczną lub.
- NOTSRCCOPY kopiuje bitmapy odwrócony źródła do miejsca przeznaczenia.
- NOTSRCERASE odwraca wynikiem połączenia bitmapy przeznaczenia i źródło za pomocą operatora logiczną lub.
- PATCOPY kopiuje wzorzec do mapy bitowej miejsca przeznaczenia.
- PATINVERT łączy mapy bitowej miejsca przeznaczenia z wzorcem przy użyciu operatora Boolean XOR.
- PATPAINT łączy z wzorcem przy użyciu operatora logiczna lub odwrócony źródłowa bitmapa.Łączy mapy bitowej miejsca przeznaczenia za pomocą operatora logiczna lub wynik tej operacji.
- SRCAND pikseli bitmapy przeznaczenia i źródło za pomocą operatora logiczna i łączy.
- SRCCOPY kopiuje źródłowa bitmapa mapy bitowej miejsca przeznaczenia.
- SRCERASE odwraca mapy bitowej miejsca przeznaczenia i łączy wynik z źródłowa bitmapa przy użyciu operatora logiczna I.
- SRCINVERT łączy piksele bitmapy przeznaczenia i źródło za pomocą operatora Boolean XOR.
- SRCPAINT łączy piksele bitmapy przeznaczenia i źródło za pomocą operatora logiczną lub.
- INTENSYWNOŚĆ włącza wszystkie wyjściowe biały.

Wartość zwracana

Niezerowa, jeśli sporządzono bitmapy; 0 inaczej.

Uwagi

Funkcja używa trybu rozciąganie kontekstu urządzenia docelowego (przez SetStretchBltMode) do określania sposobu rozciągnąć lub skompresować mapy bitowej.

StretchBlt Funkcji przenosi bitmapy z urządzenia źródłowego przez pSrcDC do urządzenia docelowego reprezentowane przez obiekt kontekstu urządzenia o nazwie którego funkcji składowej.xSrc, ySrc, nSrcWidth, I nSrcHeight zdefiniować parametry lewym górnym rogu i wymiary prostokąta źródłowego.x, y, nWidth, i nHeight parametry nadać lewym górnym rogu i wymiary prostokąta przeznaczenia.Operacja rastrowych, określona przez dwRop definiuje sposób scalonej bitmapy źródła i bitów już na urządzeniu docelowym.

StretchBlt Funkcji tworzy obraz lustrzany bitmapy, jeżeli oznaki nSrcWidth i nWidth lub nSrcHeight i nHeight różnią się parametry.Jeśli nSrcWidth i nWidth mają różne znaki, funkcja tworzy obraz lustrzany bitmapy wzdłuż osi x.Jeśli nSrcHeight i nHeight mają różne znaki, funkcja tworzy obraz lustrzany bitmapy wzdłuż osi y.

StretchBlt Funkcja rozciąga lub kompresuje źródła bitmapy w pamięci i następnie kopiuje wynik do miejsca przeznaczenia.Jeśli deseń jest połączone z wynikiem, nie jest scalana aż rozciągnięty źródłowa bitmapa jest kopiowana do miejsca przeznaczenia.Jeśli jest używany pędzel, jest pędzla kontekstu urządzenia docelowego.Współrzędne miejsca przeznaczenia są przekształcane w zależności od kontekstu urządzenia docelowego; współrzędne źródła są przekształcane w zależności od kontekstu urządzenia źródłowego.

Jeśli miejsca przeznaczenia, źródło i mapy bitowe wzorzec nie ma ten sam format koloru StretchBlt konwertuje bitmapy źródła i deseń odpowiadać bitmapy przeznaczenia.Kolory pierwszego planu i tła kontekstu urządzenia docelowego są używane w konwersji.

Jeśli StretchBlt bitmap monochromatycznych kolorów, należy przekonwertować ustawia bity białe (1) kolor tła i bitów (0) czarny kolor pierwszego planu.Aby przekonwertować kolor monochromatyczny, ustawia piksele, które odpowiadają kolorowi tła do białe (1) i ustawia wszystkie piksele czarny (0).Narzędzia i tła kolory kontekstu urządzenia kolorem są używane.

Nie wszystkie urządzenia obsługują StretchBlt funkcji.Aby ustalić, czy urządzenie obsługuje StretchBlt, wywołanie GetDeviceCaps funkcji Członkowskich RASTERCAPS indeksu i sprawdzić wartość zwracana dla RC_STRETCHBLT flagi.