AlphaBlend
9/9/2008
Essa função exibe bitmaps que possuem transparente ou semitransparente pixels.
Syntax
BOOL AlphaBlend(
HDC hdcDest,
int nXOriginDest,
int nYOriginDest,
int nWidthDest,
int nHeightDest,
HDC hdcSrc,
int nXOriginSrc,
int nYOriginSrc,
int nWidthSrc,
int nHeightSrc,
BLENDFUNCTION blendFunction
);
Parameters
- hdcDest
[no] Identificador para o contexto dispositivo destino.
- nXOriginDest
[no] Especifica o x-coordenar, em unidades lógicas, da upper-left corner do retângulo de destino.
- nYOriginDest
[no] Especifica a y-coordenar, em unidades lógicas, da upper-left corner do retângulo de destino.
- nWidthDest
[no] Especifica a largura, em unidades lógicas, do retângulo de destino. Este valor não pode ser negativo.
- nHeightDest
[no] Especifica a altura, em unidades lógicas, do retângulo de destino. Este valor não pode ser negativo.
- hdcSrc
[no] Identificador para o contexto dispositivo origem.
- nXOriginSrc
[no] Especifica o x-coordenar, em unidades lógicas, da upper-left corner do retângulo de origem.
- nYOriginSrc
[no] Especifica a y-coordenar, em unidades lógicas, da upper-left corner do retângulo de origem.
- nWidthSrc
[no] Especifica a largura, em unidades lógicas, do retângulo de origem. Este valor não pode ser negativo.
- nHeightSrc
[no] Especifica a altura, em unidades lógicas, do retângulo de origem. Este valor não pode ser negativo.
- blendFunction
[no] A BLENDFUNCTION estrutura que especifica a função alpha-blending de origem e destino bitmaps, uma alfa global valor a ser aplicado ao bitmap origem inteira e informações formato para o bitmap origem. As funções de combinação origem e destino estão atualmente limitadas a AC_SRC_OVER.
Return Value
Se a função for bem-sucedido, o valor de retorno é TRUE. Se a função falhar, o valor de retorno é FALSE.
Para informações de erro estendidas get, chamar GetLastError. GetLastError pode retornar o seguinte valor.
Valor | Descrição |
---|---|
ERROR_INVALID_PARAMETER |
Um ou mais da entrada parâmetros é inválido. |
Remarks
Se o retângulo origem e destino retângulo estiverem tamanhos diferentes, o bitmap origem é estendido para coincidir com o retângulo destino. Se a pasta SetStretchBltMode função for usada, o iStretchMode valor é automaticamente convertido em COLORONCOLOR para esta função.
Coordenadas de destino são transformadas usando a transformação especificada no momento para o contexto dispositivo destino. Coordenadas de origem são transformadas usando a transformação especificada no momento para o contexto dispositivo origem.
Se o contexto dispositivo origem identifica um contexto para dispositivo metarquivo avançado, ocorrerá um erro (e a função retorna FALSE).
Se não tiver o mesmo formato cor, destino e origem bitmaps AlphaBlend Converte o bitmap origem para coincidir com o bitmap destino.
AlphaBlend Não suporte espelhamento. Se tanto a largura ou altura da origem ou destino for negativo, a chamar para AlphaBlend falhará.
Ao processamento a uma impressora, primeiro chamar GetDeviceCaps Com SHADEBLENDCAPS para determinar se a impressora oferece suporte à misturando com AlphaBlend. Observe que, para um exibir DC, todas as operações blending são com suporte e esses sinalizadores representam se as operações são aceleradas.
O retângulo origem deve estar completamente dentro da superfície de origem, caso contrário ocorrerá um erro e a função retorna FALSE.
O SourceConstantaAlpha membro das BLENDFUNCTION estrutura especifica uma alfa valor de transparência para ser usado no bitmap de origem inteira. O SourceConstantAlpha valor é combinado com qualquer por-pixel alfa valores. Se SourceConstantAlpha é 0, presume-se que a imagem é transparente. Para usar somente por-pixel alfa definir valores, o SourceConstantAlpha valor para 255 para indicar que a imagem é opacidade.
Requirements
Header | windows.h |
Library | coredll.lib |
Windows Embedded CE | Windows CE 5.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |