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 |
|---|---|
|
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. |
|
Elimina los píxeles. Este modo elimina todas las líneas eliminadas de píxeles sin intentar conservar su información. |
|
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. |
|
Igual que BLACKONWHITE. |
|
Igual que COLORONCOLOR. |
|
Igual que HALFTONE. |
|
Igual que 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 |
|---|---|
|
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 |