Función BitBlt (wingdi.h)

Artículo
03/08/2023

La función BitBlt realiza una transferencia de bloque de bits de los datos de color correspondientes a un rectángulo de píxeles del contexto de dispositivo de origen especificado en un contexto de dispositivo de destino.

Sintaxis

BOOL BitBlt(
  [in] HDC   hdc,
  [in] int   x,
  [in] int   y,
  [in] int   cx,
  [in] int   cy,
  [in] HDC   hdcSrc,
  [in] int   x1,
  [in] int   y1,
  [in] DWORD rop
);

Parámetros

[in] hdc

Controlar el contexto del dispositivo de destino.

[in] x

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

[in] y

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

[in] cx

Ancho, en unidades lógicas, de los rectángulos de origen y destino.

[in] cy

Alto, en unidades lógicas, de los rectángulos de origen y de destino.

[in] hdcSrc

Identificador del contexto del dispositivo de origen.

[in] x1

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

[in] y1

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

[in] rop

Código de operación ráster. Estos códigos definen cómo se combinarán los datos de color del rectángulo de origen con los datos de color del rectángulo de destino para lograr el color final.

En la lista siguiente se muestran algunos códigos de operación ráster comunes.

Valor	Significado
OSCURIDAD	Rellena el rectángulo de destino con el color asociado al índice 0 en la paleta física. (este color es negro para la paleta física predeterminada).
CAPTUREBLT	Incluye las ventanas superpuestas de la ventana en la imagen resultante. De forma predeterminada, la imagen solo contiene la ventana. Observe que, generalmente, esto no se puede usar para los contextos de dispositivos de impresión.
DSTINVERT	Invierte el rectángulo de destino.
MERGECOPY	Combina los colores del rectángulo de origen con el pincel seleccionado actualmente en hdcDest mediante el operador Boolean AND.
MERGEPAINT	Combina los colores del rectángulo de origen invertido con los colores del rectángulo de destino mediante el operador OR booleano.
NOMIRRORBITMAP	Impide que el mapa de bits se refleje.
NOTSRCCOPY	Copia el rectángulo de origen invertido en el destino.
NOTSRCERASE	Combina los colores de los rectángulos de origen y destino mediante el operador OR booleano y, a continuación, invierte el color resultante.
PATCOPY	Copia el pincel seleccionado actualmente en hdcDest, en el mapa de bits de destino.
PATINVERT	Combina los colores del pincel actualmente seleccionado en hdcDest, con los colores del rectángulo de destino mediante el operador XOR booleano.
PATPAINT	Combina los colores del pincel actualmente seleccionado en hdcDest, con los colores del rectángulo de origen invertido mediante el operador OR booleano. El resultado de esta operación se combina con los colores del rectángulo de destino mediante el operador OR booleano.
SRCAND	Combina los colores de los rectángulos de origen y destino mediante el operador BOOLEAN AND.
SRCCOPY	Copia el rectángulo de origen directamente en el rectángulo de destino.
SRCERASE	Combina los colores invertidos del rectángulo de destino con los colores del rectángulo de origen mediante el operador BOOLEAN AND.
SRCINVERT	Combina los colores de los rectángulos de origen y destino mediante el operador XOR booleano.
SRCPAINT	Combina los colores de los rectángulos de origen y destino mediante el operador OR booleano.
BLANCURA	Rellena el rectángulo de destino con el color asociado al índice 1 de la paleta física. (este color es blanco para la paleta física predeterminada).

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. Para obtener información de error extendida, llame a GetLastError.

Comentarios

BitBlt solo realiza el recorte en el controlador de dominio de destino.

Si una transformación de rotación o de descimación está en vigor en el contexto del dispositivo de origen, BitBlt devuelve un error. Si existen otras transformaciones en el contexto del dispositivo de origen (y una transformación coincidente no está en vigor en el contexto del dispositivo de destino), el rectángulo del contexto del dispositivo de destino se estira, comprime o gira, según sea necesario.

Si los formatos de color de los contextos de dispositivo de origen y destino no coinciden, la función BitBlt convierte el formato de color de origen para que coincida con el formato de destino.

Cuando se registra un metarchivo mejorado, se produce un error si el contexto de dispositivo de origen identifica un contexto de dispositivo de metarchivo mejorado.

No todos los dispositivos admiten la función BitBlt . Para obtener más información, vea la entrada de funcionalidad de RC_BITBLT ráster en la función GetDeviceCaps , así como las siguientes funciones: MaskBlt, PlgBlt y StretchBlt.

BitBlt devuelve un error si los contextos de dispositivo de origen y destino representan dispositivos diferentes. Para transferir datos entre controladores de dominio para distintos dispositivos, convierta el mapa de bits de memoria en una DIB mediante una llamada a GetDIBits. Para mostrar la DIB en el segundo dispositivo, llame a SetDIBits o StretchDIBits.

ICM: No se realiza ninguna administración de colores cuando se producen cortes.

Ejemplos

En el ejemplo de código siguiente se muestra el uso de BitBlt.

if (!BitBlt(hdcMemDC,
    0, 0,
    rcClient.right - rcClient.left, rcClient.bottom - rcClient.top,
    hdcWindow,
    0, 0,
    SRCCOPY))
{
    MessageBox(hWnd, L"BitBlt has failed", L"Failed", MB_OK);
    goto done;
}

Para ver este ejemplo en contexto, consulte Captura 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