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

Confira também

Funções DrawDib