Método ID2D1RenderTarget::FillOpacityMask(ID2D1Bitmap*,ID2D1Brush*,D2D1_OPACITY_MASK_CONTENT,constD2D1_RECT_F&,constD2D1_RECT_F&) (d2d1.h)

  • Artigo

Aplica a máscara de opacidade descrita pelo bitmap especificado para um pincel e usa esse pincel para pintar uma região do destino de renderização.

Sintaxe

void FillOpacityMask(
  [in]  ID2D1Bitmap               *opacityMask,
  [in]  ID2D1Brush                *brush,
        D2D1_OPACITY_MASK_CONTENT content,
  [ref] const D2D1_RECT_F &       destinationRectangle,
  [ref] const D2D1_RECT_F &       sourceRectangle
);

Parâmetros

[in] opacityMask

Tipo: ID2D1Bitmap*

A máscara de opacidade a ser aplicada ao pincel. O valor alfa de cada pixel na região especificada por sourceRectangle é multiplicado com o valor alfa do pincel depois que o pincel é mapeado para a área definida por destinationRectangle.

[in] brush

Tipo: ID2D1Brush*

O pincel usado para pintar a região do destino de renderização especificado por destinationRectangle.

content

Tipo: D2D1_OPACITY_MASK_CONTENT

O tipo de conteúdo que a máscara de opacidade contém. O valor é usado para determinar o espaço de cores em que a máscara de opacidade é combinada.

Nota Começando com Windows 8, o D2D1_OPACITY_MASK_CONTENT não é necessário. Consulte o método ID2D1DeviceContext::FillOpacityMask , que não tem nenhum parâmetro D2D1_OPACITY_MASK_CONTENT .
 

[ref] destinationRectangle

Tipo: const D2D1_RECT_F

A região do destino de renderização a ser pintado, em pixels independentes do dispositivo.

[ref] sourceRectangle

Tipo: const D2D1_RECT_F

A região do bitmap a ser usada como a máscara de opacidade, em pixels independentes do dispositivo.

Retornar valor

Nenhum

Comentários

Para que esse método funcione corretamente, o destino de renderização deve estar usando o modo de suavização D2D1_ANTIALIAS_MODE_ALIASED . Você pode definir o modo de suavização chamando o método ID2D1RenderTarget::SetAntialiasMode .

Esse método não retornará um código de erro se falhar. Para determinar se uma operação de desenho (como FillOpacityMask) falhou, marcar o resultado retornado pelos métodos ID2D1RenderTarget::EndDraw ou ID2D1RenderTarget::Flush.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1.h
Biblioteca D2d1.lib
DLL D2d1.dll

Confira também

ID2D1RenderTarget