Función SetStretchBltMode (wingdi.h)

La función SetStretchBltMode establece el modo de extensión del mapa de bits en el contexto de dispositivo especificado.

Sintaxis

int SetStretchBltMode(
  [in] HDC hdc,
  [in] int mode
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] mode

El modo de extensión. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
BLACKONWHITE	Realiza una operación AND booleana con los valores de color de los píxeles eliminados y existentes. Si el mapa de bits es un mapa de bits monocromático, este modo conserva los píxeles negros a costa de los píxeles blancos.
COLORONCOLOR	Elimina los píxeles. Este modo elimina todas las líneas eliminadas de píxeles sin intentar conservar su información.
SEMITONOS	Asigna píxeles del rectángulo de origen a bloques de píxeles del rectángulo de destino. El color promedio del bloque de destino de píxeles se aproxima al color de los píxeles de origen. Después de establecer el modo de extensión HALFTONE, una aplicación debe llamar a la función SetBrushOrgEx para establecer el origen del pincel. Si no lo hace, se produce una desalineación del pincel.
STRETCH_ANDSCANS	Igual que BLACKONWHITE.
STRETCH_DELETESCANS	Igual que COLORONCOLOR.
STRETCH_HALFTONE	Igual que HALFTONE.
STRETCH_ORSCANS	Igual que WHITEONBLACK.
WHITEONBLACK	Realiza una operación OR booleana con los valores de color de los píxeles eliminados y existentes. Si el mapa de bits es un mapa de bits monocromático, este modo conserva los píxeles blancos a costa de los píxeles negros.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el modo de extensión anterior.

Si la función no se realiza correctamente, el valor devuelto es cero.

Esta función puede devolver el siguiente valor.

Código devuelto	Descripción
ERROR_INVALID_PARAMETER	Uno o varios de los parámetros de entrada no son válidos.

Comentarios

El modo de extensión define cómo el sistema combina filas o columnas de un mapa de bits con píxeles existentes en un dispositivo de visualización cuando una aplicación llama a la función StretchBlt .

Los modos BLACKONWHITE (STRETCH_ANDSCANS) y WHITEONBLACK (STRETCH_ORSCANS) se suelen usar para conservar píxeles de primer plano en mapas de bits monocromáticos. El modo COLORONCOLOR (STRETCH_DELETESCANS) se usa normalmente para conservar el color en los mapas de bits de color.

El modo HALFTONE es más lento y requiere más procesamiento de la imagen de origen que los otros tres modos; pero genera imágenes de mayor calidad. Tenga en cuenta también que se debe llamar a SetBrushOrgEx después de establecer el modo HALFTONE para evitar la desalineación del pincel.

Es posible que haya otros modos de extensión disponibles, en función de las funcionalidades del controlador del dispositivo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll

Consulte también

Funciones de mapa de bits

Información general sobre mapas de bits

GetStretchBltMode

SetBrushOrgEx

StretchBlt