Função AlphaBlend (wingdi.h)

Artigo
08/27/2023

A função AlphaBlend exibe bitmaps que têm pixels transparentes ou semitransparentes.

Sintaxe

BOOL AlphaBlend(
  [in] HDC           hdcDest,
  [in] int           xoriginDest,
  [in] int           yoriginDest,
  [in] int           wDest,
  [in] int           hDest,
  [in] HDC           hdcSrc,
  [in] int           xoriginSrc,
  [in] int           yoriginSrc,
  [in] int           wSrc,
  [in] int           hSrc,
  [in] BLENDFUNCTION ftn
);

Parâmetros

[in] hdcDest

Um identificador para o contexto do dispositivo de destino.

[in] xoriginDest

A coordenada x, em unidades lógicas, do canto superior esquerdo do retângulo de destino.

[in] yoriginDest

A coordenada y, em unidades lógicas, do canto superior esquerdo do retângulo de destino.

[in] wDest

A largura, em unidades lógicas, do retângulo de destino.

[in] hDest

A altura, em unidades lógicas, do retângulo de destino.

[in] hdcSrc

Um identificador para o contexto do dispositivo de origem.

[in] xoriginSrc

A coordenada x, em unidades lógicas, do canto superior esquerdo do retângulo de origem.

[in] yoriginSrc

A coordenada y, em unidades lógicas, do canto superior esquerdo do retângulo de origem.

[in] wSrc

A largura, em unidades lógicas, do retângulo de origem.

[in] hSrc

A altura, em unidades lógicas, do retângulo de origem.

[in] ftn

A função de combinação alfa para bitmaps de origem e destino, um valor alfa global a ser aplicado a todo o bitmap de origem e as informações de formato para o bitmap de origem. No momento, as funções de combinação de origem e destino estão limitadas a AC_SRC_OVER. Consulte as estruturas BLENDFUNCTION e EMRALPHABLEND .

Valor retornado

Se a função for bem-sucedida, o valor retornado será TRUE.

Se a função falhar, o valor retornado será FALSE.

Comentários

Se o retângulo de origem e o retângulo de destino não tiverem o mesmo tamanho, o bitmap de origem será estendido para corresponder ao retângulo de destino. Se a função SetStretchBltMode for usada, o valor iStretchMode será convertido automaticamente em COLORONCOLOR para essa função (ou seja, BLACKONWHITE, WHITEONBLACK e HALFTONE serão alterados para COLORONCOLOR).

As coordenadas de destino são transformadas usando a transformação especificada atualmente para o contexto do dispositivo de destino. As coordenadas de origem são transformadas usando a transformação especificada atualmente para o contexto do dispositivo de origem.

Ocorrerá um erro (e a função retornará FALSE) se o contexto do dispositivo de origem identificar um contexto de dispositivo de metafile aprimorado.

Se os bitmaps de destino e de origem não tiverem o mesmo formato de cor, AlphaBlend converterá o bitmap de origem para corresponder ao bitmap de destino.

O AlphaBlend não dá suporte ao espelhamento. Se a largura ou altura da origem ou destino for negativa, essa chamada falhará.

Ao renderizar em uma impressora, primeiro chame GetDeviceCaps com SHADEBLENDCAPS para determinar se a impressora dá suporte à mesclagem com AlphaBlend. Observe que, para um DC de exibição, todas as operações de mesclagem têm suporte e esses sinalizadores representam se as operações são aceleradas.

Se a origem e o destino forem a mesma superfície, ou seja, eles são a tela ou o mesmo bitmap de memória e os retângulos de origem e destino se sobrepõem, ocorre um erro e a função retorna FALSE.

O retângulo de origem deve estar completamente dentro da superfície de origem, caso contrário, ocorrerá um erro e a função retornará FALSE.

AlphaBlend falhará se a largura ou altura da origem ou destino for negativa.

O membro SourceConstantAlpha de BLENDFUNCTION especifica um valor de transparência alfa a ser usado em todo o bitmap de origem. O valor SourceConstantAlpha é combinado com qualquer valor alfa por pixel. Se SourceConstantAlpha for 0, supõe-se que a imagem seja transparente. Defina o valor SourceConstantAlpha como 255 (o que indica que a imagem é opaca) quando você só deseja usar valores alfa por pixel.

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	wingdi.h (inclua Windows.h)
Biblioteca	Msimg32.lib
DLL	Msimg32.dll