Función DrawDibDraw (vfw.h)
La función DrawDibDraw dibuja una DIB en la pantalla.
Sintaxis
BOOL VFWAPI DrawDibDraw(
HDRAWDIB hdd,
HDC hdc,
int xDst,
int yDst,
int dxDst,
int dyDst,
LPBITMAPINFOHEADER lpbi,
LPVOID lpBits,
int xSrc,
int ySrc,
int dxSrc,
int dySrc,
UINT wFlags
);
Parámetros
hdd
Identificador de un controlador DrawDib DC.
hdc
Identificador del controlador de dominio.
xDst
Coordenada x, en MM_TEXT coordenadas de cliente, de la esquina superior izquierda del rectángulo de destino.
yDst
Coordenada y, en MM_TEXT coordenadas de cliente, de la esquina superior izquierda del rectángulo de destino.
dxDst
Ancho, en MM_TEXT coordenadas de cliente, del rectángulo de destino. Si dxDst es −1, se utiliza el ancho del mapa de bits.
dyDst
Alto, en MM_TEXT coordenadas del cliente, del rectángulo de destino. Si dyDst es −1, se utiliza el alto del mapa de bits.
lpbi
Puntero a la estructura BITMAPINFOHEADER que contiene el formato de imagen. La tabla de colores para la DIB dentro de BITMAPINFOHEADER sigue el formato y el miembro biHeight debe ser un valor positivo; DrawDibDraw no dibujará DIB invertidos.
lpBits
Puntero al búfer que contiene los bits de mapa de bits.
xSrc
Coordenada x, en píxeles, de la esquina superior izquierda del rectángulo de origen. Las coordenadas (0,0) representan la esquina superior izquierda del mapa de bits.
ySrc
Coordenada y, en píxeles, de la esquina superior izquierda del rectángulo de origen. Las coordenadas (0,0) representan la esquina superior izquierda del mapa de bits.
dxSrc
Ancho, en píxeles, del rectángulo de origen.
dySrc
Alto, en píxeles, del rectángulo de origen.
wFlags
Marcas aplicables para dibujar. Se definen los valores siguientes.
| Valor | Significado |
|---|---|
| DDF_BACKGROUNDPAL | Se da cuenta de la paleta utilizada para dibujar en segundo plano, dejando la paleta real usada para mostrar sin cambios. Este valor solo es válido si no se establece DDF_SAME_HDC. |
| DDF_DONTDRAW | La imagen actual está descomprimida pero no dibujada. Esta marca sustituye a la marca de DDF_PREROLL . |
| DDF_FULLSCREEN | No compatible. |
| DDF_HALFTONE | Siempre dilate la DIB a una paleta estándar independientemente de la paleta del DIB. Si la aplicación usa la función DrawDibBegin , establezca este valor en DrawDibBegin en lugar de en DrawDibDraw. |
| DDF_HURRYUP | Los datos no tienen que dibujarse (es decir, se pueden quitar) y DDF_UPDATE no se usarán para recuperar esta información. DrawDib comprueba este valor solo si es necesario compilar el siguiente marco; de lo contrario, se omite el valor. Este valor se suele usar para sincronizar el vídeo y el audio. Al sincronizar datos, las aplicaciones deben enviar la imagen con este valor en caso de que el controlador necesite almacenar en búfer el marco para descomprimir fotogramas posteriores. |
| DDF_NOTKEYFRAME | Los datos DIB no son un fotograma clave. |
| DDF_SAME_HDC | Use el controlador de dominio actual y la paleta asociadas actualmente al controlador de dominio. |
| DDF_SAME_DRAW | Use los parámetros de dibujo actuales para DrawDibDraw. Use este valor solo si lpbi, dxDst, dyDst, dxSrc y dySrc no han cambiado desde el uso de DrawDibDraw o DrawDibBegin. DrawDibDraw normalmente comprueba los parámetros y, si han cambiado, DrawDibBegin prepara el controlador de dominio DrawDib para dibujar. Esta marca reemplaza las marcas DDF_SAME_DIB y DDF_SAME_SIZE . |
| DDF_UPDATE | El último mapa de bits almacenado en búfer es volver a dibujar. Si se produce un error en el dibujo con este valor, no hay disponible una imagen almacenada en búfer y es necesario especificar una nueva imagen antes de que se pueda actualizar la pantalla. |
Valor devuelto
Devuelve TRUE si es correcto o FALSE de lo contrario.
Comentarios
DDF_DONTDRAW hace que DrawDibDraw descomprima pero no muestre una imagen. Una llamada posterior a DrawDibDraw que especifica DDF_UPDATE muestra la imagen.
Si el controlador de dominio DrawDib no tiene especificado un búfer fuera de pantalla, especificar DDF_DONTDRAW hace que el fotograma se dibuje inmediatamente en la pantalla. Las llamadas posteriores a DrawDibDraw que especifican DDF_UPDATE producen un error.
Aunque se establecen en momentos diferentes, DDF_UPDATE y DDF_DONTDRAW se pueden usar conjuntamente para crear imágenes compuestas fuera de la pantalla. Una vez completada la imagen fuera de la pantalla, puede mostrar la imagen llamando a DrawDibDraw.
Requisitos
| 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 | vfw.h |
| Library | Vfw32.lib |
| Archivo DLL | Msvfw32.dll |