Freigeben über


CDC::SetStretchBltMode

Legt den Bitmapstreckmodus für die StretchBlt-Memberfunktion fest.

int SetStretchBltMode( 
   int nStretchMode  
);

Parameter

  • nStretchMode
    Gibt den Streckmodus an. Er kann einer der folgenden Werte sein:

    Wert

    Beschreibung

    BLACKONWHITE

    Führt eine boolesche AND-Operation mithilfe der Farbwerte für die beseitigten und vorhandenen Pixel aus. Wenn die Bitmap eine monochrome Bitmap ist, schwarze Pixel der behält dieses Modus auf Kosten von weißen Pixel.

    COLORONCOLOR

    Löscht die Pixel. Dieser Modus löscht alle beseitigten Zeilen aus Pixel, ohne zu versuchen, ihre Informationen beizubehalten.

    HALBTON

    Ordnet Pixel vom Quellrechteck Blöcke in Pixel im Zielrechteck zu. Die durchschnittliche Farbe über dem Zielblock aus Pixel entspricht die Farbe der Quellpixel.

     

    Nachdem sie den HALFTONE Streckmodus festgelegt hat, muss eine Anwendung die Win32-Funktion SetBrushOrgEx aufrufen, um den Pinselursprung festzulegen. Wenn sie dies fehlschlägt, bürsten Sie falsche Ausrichtung auftritt.

    STRETCH_ANDSCANS

    Windows 95/98: Identisch mit BLACKONWHITE

    STRETCH_DELETESCANS

    Windows 95/98: Identisch mit COLORONCOLOR

    STRETCH_HALFTONE

    Windows 95/98: Identisch mit HALFTONE.

    STRETCH_ORSCANS

    Windows 95/98: Identisch mit WHITEONBLACK

    WHITEONBLACK

    Führt eine boolesche OR-Operation mithilfe der Farbwerte für die beseitigten und vorhandenen Pixel aus. Wenn die Bitmap eine monochrome Bitmap ist, behält der weiße Pixel dieses Modus auf Kosten von schwarzen Pixel.

Rückgabewert

Der vorherige Streckmodus. Es kann STRETCH_ANDSCANS, STRETCH_DELETESCANS oder STRETCH_ORSCANS sein.

Hinweise

Der Bitmapstreckmodus definiert, wie Informationen aus den Bitmaps entfernt werden, die komprimiert werden, indem die Funktion verwendet.

Die Modi BLACKONWHITE (STRETCH_ANDSCANS) und WHITEONBLACK (STRETCH_ORSCANS) werden in der Regel verwendet, um Vordergrundpixel in den monochromen Bitmaps beizubehalten. Der Modus COLORONCOLOR (STRETCH_DELETESCANS) wird in der Regel verwendet, um Farbe in den Farbenbitmaps beizubehalten.

Der HALFTONE Modus erfordert die Verarbeitung des Quellbilds als die anderen drei Modi; langsamer als die anderen, aber erzeugt höherwertige Bilder. Beachten Sie auch, dass SetBrushOrgEx aufgerufen werden muss, nachdem Sie den HALFTONE Modus festgelegt hat, dass Pinselfalsche ausrichtung zu vermeiden.

Zusätzliche Streckmodi möglicherweise auch abhängig von den Funktionen des Gerätetreibers verfügbar.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchiediagramm

CDC::GetStretchBltMode

CDC::StretchBlt

SetStretchBltMode