Función StretchBlt (wingdi.h)

Artículo
03/08/2023

La función StretchBlt copia un mapa de bits de un rectángulo de origen en un rectángulo de destino, estirando o comprimiendo el mapa de bits para ajustarse a las dimensiones del rectángulo de destino, si es necesario. El sistema estira o comprime el mapa de bits según el modo de extensión establecido actualmente en el contexto del dispositivo de destino.

Sintaxis

BOOL StretchBlt(
  [in] HDC   hdcDest,
  [in] int   xDest,
  [in] int   yDest,
  [in] int   wDest,
  [in] int   hDest,
  [in] HDC   hdcSrc,
  [in] int   xSrc,
  [in] int   ySrc,
  [in] int   wSrc,
  [in] int   hSrc,
  [in] DWORD rop
);

Parámetros

[in] hdcDest

Controlar el contexto del dispositivo de destino.

[in] xDest

Coordenada x, en unidades lógicas, de la esquina superior izquierda del rectángulo de destino.

[in] yDest

Coordenada y, en unidades lógicas, de la esquina superior izquierda del rectángulo de destino.

[in] wDest

Ancho, en unidades lógicas, del rectángulo de destino.

[in] hDest

Alto, en unidades lógicas, del rectángulo de destino.

[in] hdcSrc

Identificador del contexto del dispositivo de origen.

[in] xSrc

Coordenada x, en unidades lógicas, de la esquina superior izquierda del rectángulo de origen.

[in] ySrc

Coordenada y, en unidades lógicas, de la esquina superior izquierda del rectángulo de origen.

[in] wSrc

Ancho, en unidades lógicas, del rectángulo de origen.

[in] hSrc

Alto, en unidades lógicas, del rectángulo de origen.

[in] rop

Operación de trama que se va a realizar. Los códigos de operación de trama definen cómo el sistema combina colores en las operaciones de salida que implican un pincel, un mapa de bits de origen y un mapa de bits de destino.

Consulte BitBlt para obtener una lista de códigos de operación de trama comunes (ROP). Tenga en cuenta que el ROP CAPTUREBLT generalmente no se puede usar para imprimir contextos de dispositivo.

Valor devuelto

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

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

Comentarios

StretchBlt estira o comprime el mapa de bits de origen en memoria y, a continuación, copia el resultado en el rectángulo de destino. Este mapa de bits puede ser un mapa de bits (DDB) compatible o la salida de CreateDIBSection. Los datos de color de los píxeles de patrón o destino se combinan después de que se produzca la ampliación o compresión.

Cuando se registra un metarchivo mejorado, se produce un error (y la función devuelve FALSE) si el contexto del dispositivo de origen identifica un contexto de dispositivo de metarchivo mejorado.

Si la operación de trama especificada requiere un pincel, el sistema usa el pincel seleccionado actualmente en el contexto del dispositivo de destino.

Las coordenadas de destino se transforman mediante la transformación especificada actualmente para el contexto del dispositivo de destino; las coordenadas de origen se transforman mediante la transformación especificada actualmente para el contexto del dispositivo de origen.

Si la transformación de origen tiene una rotación o un cable, se produce un error.

Si los mapas de bits de destino, origen y patrón no tienen el mismo formato de color, StretchBlt convierte los mapas de bits de origen y patrón para que coincidan con el mapa de bits de destino.

Si StretchBlt debe convertir un mapa de bits monocromático en un mapa de bits de color, establece bits blancos (1) en el color de fondo y los bits negros (0) en el color de primer plano. Para convertir un mapa de bits de color en un mapa de bits monocromático, establece píxeles que coinciden con el color de fondo en blanco (1) y establece todos los demás píxeles en negro (0). Se usan los colores de primer plano y de fondo del contexto de dispositivo con color.

StretchBlt crea una imagen reflejada de un mapa de bits si los signos de los parámetros nWidthSrc y nWidthDest o si los parámetros nHeightSrc y nHeightDest difieren. Si nWidthSrc y nWidthDest tienen signos diferentes, la función crea una imagen reflejada del mapa de bits a lo largo del eje X. Si nHeightSrc y nHeightDest tienen signos diferentes, la función crea una imagen reflejada del mapa de bits a lo largo del eje Y.

No todos los dispositivos admiten la función StretchBlt . Para obtener más información, consulte GetDeviceCaps.

ICM: No se realiza ninguna administración de colores cuando se produce una operación delit.

Cuando se usa en un sistema de supervisión múltiple, hdcSrc y hdcDest deben hacer referencia al mismo dispositivo o se producirá un error en la función. Para transferir datos entre controladores de dominio para distintos dispositivos, convierta el mapa de bits de memoria en un DIB mediante una llamada a GetDIBits. Para mostrar la DIB en el segundo dispositivo, llame a SetDIBits o StretchDIBits.

Ejemplos

Para obtener un ejemplo, consulte Escalado de una imagen.

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