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