Função DrawDibBegin (vfw.h)
A função DrawDib altera os parâmetros de um DC DrawDib ou inicializa um novo DC DrawDib.
Sintaxe
BOOL VFWAPI DrawDibBegin(
HDRAWDIB hdd,
HDC hdc,
int dxDst,
int dyDst,
LPBITMAPINFOHEADER lpbi,
int dxSrc,
int dySrc,
UINT wFlags
);
Parâmetros
hdd
Manipule para um DC DrawDib.
hdc
Manipule para um DC para desenho. Esse parâmetro é opcional.
dxDst
Largura, em MM_TEXT unidades de cliente, do retângulo de destino.
dyDst
Altura, em MM_TEXT unidades de cliente, do retângulo de destino.
lpbi
Ponteiro para uma estrutura BITMAPINFOHEADER que contém o formato de imagem. A tabela de cores do DIB segue o formato de imagem e o membro biHeight deve ser um valor positivo.
dxSrc
Largura, em pixels, do retângulo de origem.
dySrc
Altura, em pixels, do retângulo de origem.
wFlags
Sinalizadores aplicáveis para a função. Os valores a seguir são definidos.
| Valor | Significado |
|---|---|
| DDF_ANIMATE | Permite animação de paleta. Se esse valor estiver presente, DrawDib reservará o máximo possível de entradas definindo PC_RESERVED nas entradas da matriz palPalEntry da estrutura LOGPALETTE e a paleta poderá ser animada usando a função DrawDibChangePalette . Se o aplicativo usar a função DrawDibBegin com a função DrawDibDraw , defina esse valor com DrawDibBegin em vez de DrawDibDraw. |
| DDF_BACKGROUNDPAL | Percebe a paleta usada para desenhar como uma tarefa em segundo plano, deixando a paleta atual usada para a exibição inalterada. (Esse valor é mutuamente exclusivo de DDF_SAME_HDC.) |
| DDF_BUFFER | Faz com que DrawDib tente usar um buffer fora da tela para que DDF_UPDATE possa ser usado. Isso desabilita a descompactação e o desenho diretamente na tela. Se DrawDib não conseguir criar um buffer fora da tela, ele descompactará ou desenhará diretamente na tela. Para obter mais informações, consulte os valores DDF_UPDATE e DDF_DONTDRAW descritos para DrawDibDraw. |
| DDF_DONTDRAW | A imagem atual não é desenhada, mas é descompactada. DDF_UPDATE pode ser usado posteriormente para desenhar a imagem. Esse sinalizador substitui o sinalizador DDF_PREROLL . |
| DDF_FULLSCREEN | Sem suporte. |
| DDF_HALFTONE | Sempre dithers o DIB para uma paleta padrão, independentemente da paleta do DIB. Se o aplicativo usar DrawDibBegin com DrawDibDraw, defina esse valor com DrawDibBegin em vez de DrawDibDraw. |
| DDF_JUSTDRAWIT | Desenha a imagem usando GDI. Proíbe as funções DrawDib de descompactar, alongar ou dithering da imagem. Isso remove DrawDib de recursos que o diferenciam da função StretchDIBits . |
| DDF_SAME_DRAW | Use os parâmetros de desenho atuais para DrawDibDraw. Use esse valor somente se lpbi, dxDest, dyDest, dxSrc e dySrc não tiverem sido alterados desde o uso de DrawDibDraw ou DrawDibBegin. Esse sinalizador substitui os sinalizadores DDF_SAME_DIB e DDF_SAME_SIZE . |
| DDF_SAME_HDC | Use o identificador dc atual e a paleta atualmente associada ao DC. |
| DDF_UPDATE | O último bitmap em buffer precisa ser redesenhado. Se o desenho falhar com esse valor, uma imagem em buffer não estará disponível e uma nova imagem precisará ser especificada antes que a exibição possa ser atualizada. |
Valor retornado
Retornará TRUE se tiver êxito ou FALSE caso contrário.
Comentários
Essa função se prepara para desenhar um DIB especificado por lpbi para o DC. A imagem é estendida até o tamanho especificado por dxDest e dyDest. Se dxDest e dyDest estiverem definidos como −1, o DIB será desenhado para uma escala 1:1 sem alongamento.
Você pode atualizar os sinalizadores de um DC DrawDib relançando DrawDibBegin, especificando os novos sinalizadores e alterando pelo menos uma das seguintes configurações: dxDest, dyDest, lpbi, dxSrc ou dySrc.
Se os parâmetros de DrawDibBegin não tiverem sido alterados, as chamadas subsequentes para a função não terão efeito.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vfw.h |
| Biblioteca | Vfw32.lib |
| DLL | Msvfw32.dll |