Udostępnij za pośrednictwem


CDC::PlgBlt

Wykonuje przesunięcia bitowego bloku bity danych kolorów z określonego prostokąta w kontekście urządzenia źródłowego do określonego równoległobok w kontekście danego urządzenia.

BOOL PlgBlt(
   LPPOINT lpPoint,
   CDC* pSrcDC,
   int xSrc,
   int ySrc,
   int nWidth,
   int nHeight,
   CBitmap& maskBitmap,
   int xMask,
   int yMask 
);

Parametry

  • lpPoint
    Punkty do tablicy trzech punktach logicznego miejsca identyfikujący trzy narożniki równoległobok przeznaczenia.Lewego górnego rogu prostokąta źródłowego jest mapowany do pierwszego punktu w tej tablicy, górnym rogu do drugiego w tej tablicy i lewym dolnym rogu trzeciego punktu.Niejawne punkt czwarty w równoległobok jest mapowany dolnym rogu prostokąta źródłowego.

  • pSrcDC
    Identyfikuje źródło kontekstu urządzenia.

  • xSrc
    Określa współrzędną x jednostek logicznych, w lewym górnym rogu prostokąta źródłowego.

  • ySrc
    Określa współrzędną y jednostek logicznych, w lewym górnym rogu prostokąta źródłowego.

  • nWidth
    Określa szerokość, w jednostkach logicznych prostokąta źródłowego.

  • nHeight
    Określa wysokość, w jednostkach logicznych prostokąta źródłowego.

  • maskBitmap
    Określa opcjonalny bitmap monochromatycznych, używany do maskowania kolory prostokąta źródłowego.

  • xMask
    Określa współrzędną x lewego górnego rogu bitmapowych monochromatycznych.

  • yMask
    Określa współrzędną y lewego górnego rogu bitmapowych monochromatycznych.

Wartość zwracana

Niezerowa, jeśli funkcja jest pomyślne; 0 inaczej.

Uwagi

Ta mapa bitowa funkcja do maski bitów danych kolor prostokąta źródłowego uchwyt danej maski identyfikuje ważne bitmap monochromatycznych.

Czwarty wierzchołka równoległobok (D) jest zdefiniowany, traktując pierwsze trzy punkty (A, B i C) jako wektory i komputerowych D = B + C - A.

Jeśli istnieje maski, wartość 1 w masce wskazuje, że kolor piksela źródła powinny zostać skopiowane do miejsca przeznaczenia.Wartość 0 w masce wskazuje, że kolor piksela docelowy jest nie może zostać zmieniony.

Jeśli prostokąt maska jest mniejszy niż źródłowy i docelowy prostokątów, funkcja replikuje wzoru maski.

Skalowanie, tłumaczenia i odbicie przekształceń są dozwolone w kontekstu urządzenia źródłowego; Jednakże obrotu i pochylenia przekształceń nie są.Jeśli bitmapy maska nie jest bitmap monochromatycznych, wystąpi błąd.Rozciąganie tryb dla kontekstu urządzenia docelowego jest używany do określenia sposobu rozciągnąć lub skompresować pikseli, jeżeli jest to konieczne.Po nagraniu rozszerzony metaplik błąd występuje, jeśli kontekstu urządzenia źródła identyfikuje kontekstu urządzenia rozszerzonych metaplików.

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.Transformacja źródło ma obrót lub Ścinanie, zwracany jest błąd.Jeżeli przeznaczenia i źródła prostokąty mają ten sam format koloru PlgBlt konwertuje prostokąta źródłowego do docelowego prostokąta.Nie wszystkie urządzenia obsługują PlgBlt.Aby uzyskać więcej informacji, zobacz opis RC_BITBLT zdolności rastrowy w CDC::GetDeviceCaps funkcji składowej.

Jeśli źródłowy i docelowy kontekstów urządzeń stanowią urządzenia niezgodne PlgBlt zwraca błąd.

Wymagania

Nagłówek: afxwin.h

Zobacz też

Informacje

Klasa CDC

Wykres hierarchii

CDC::BitBlt

CDC::GetDeviceCaps

CDC::MaskBlt

CDC::StretchBlt

SetStretchBltMode

PlgBlt