Método ID2D1CommandSink1::SetPrimitiveBlend1 (d2d1_2.h)
Define um novo modo de mistura primitiva.
Sintaxe
HRESULT SetPrimitiveBlend1(
D2D1_PRIMITIVE_BLEND primitiveBlend
);
Parâmetros
primitiveBlend
Tipo: D2D1_PRIMITIVE_BLEND
A mistura primitiva que se aplicará aos primitivos subsequentes.
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Se falhar, retornará um código de erro HRESULT .
Comentários
Modos de mesclagem
Para renderização aliased (exceto no modo MIN), o valor de saída O é calculado interpolando linearmente o valor blend(S, D) com o valor de pixel de destino, com base na quantidade que o primitivo cobre o pixel de destino.A tabela aqui mostra os modos de mistura primitivos para mesclagem alias e suavizada. As equações listadas na tabela usam estes elementos:
- O = Saída
- S = Origem
- SA = Alfa de origem
- D = Destino
- DA = Destino Alfa
- C = Cobertura de pixel
| Modo de mistura primitiva | Mesclagem de alias | Mesclagem suavizada | Descrição |
|---|---|---|---|
| D2D1_PRIMITIVE_BLEND_SOURCE_OVER | O = (S + (1 – SA) * D) * C + D * (1 – C) | O = S * C + D *(1 – SA *C) | O modo de combinação de origem sobre destino padrão. |
| D2D1_PRIMITIVE_BLEND_COPY | O = S * C + D * (1 – C) | O = S * C + D * (1 – C) | A origem é copiada para o destino; os pixels de destino são ignorados. |
| D2D1_PRIMITIVE_BLEND_MIN | O = Min(S + 1-SA, D) | O = Min(S * C + 1 – SA *C, D) | Os valores de pixel resultantes usam o mínimo dos valores de pixel de origem e de destino. Disponível em Windows 8 e posterior. |
| D2D1_PRIMITIVE_BLEND_ADD | O = (S + D) * C + D * (1 – C) | O = S * C + D | Os valores de pixel resultantes são a soma dos valores de pixel de origem e de destino. Disponível em Windows 8 e posterior. |
Uma ilustração dos modos de mistura primitivos com opacidade e planos de fundo variados.
A mistura primitiva será aplicada a todos os primitivos desenhados no contexto, a menos que isso seja substituído pelo parâmetro compositeMode na API DrawImage .
A mistura primitiva aplica-se ao interior de todos os primitivos desenhados no contexto. No caso de DrawImage, isso será implícito pelo retângulo da imagem, deslocamento e transformação do mundo.
Se a mistura primitiva for diferente de D2D1_PRIMITIVE_BLEND_OVER , a renderização ClearType será desativada. Se o aplicativo forçar explicitamente a renderização ClearType nesses modos, o contexto de desenho será colocado em um estado de erro. D2DERR_WRONG_STATE será retornado de EndDraw ou Flush.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8.1 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | d2d1_2.h |