Método ID2D1BitmapBrush::SetExtendModeY (d2d1.h)

  • Artigo

Especifica como o pincel lado a lado verticalmente as áreas que se estendem além de seu bitmap.

Sintaxe

void SetExtendModeY(
  D2D1_EXTEND_MODE extendModeY
);

Parâmetros

extendModeY

Tipo: D2D1_EXTEND_MODE

Um valor que especifica como o pincel lado a lado verticalmente as áreas que se estendem além de seu bitmap.

Retornar valor

Nenhum

Comentários

Às vezes, o bitmap de um pincel de bitmap não preenche completamente a área que está sendo pintada. Quando isso acontece, Direct2D usa as configurações de modo de extensão horizontal (SetExtendModeX) e vertical (SetExtendModeY) do pincel para determinar como preencher a área restante.

A ilustração a seguir mostra os resultados de todas as combinações possíveis dos modos de extensão para um ID2D1BitmapBrush: D2D1_EXTEND_MODE_CLAMP (CLAMP), D2D1_EXTEND_MODE_WRAP (WRAP) e D2D1_EXTEND_MIRROR (MIRROR).

Ilustração de um bitmap e as imagens resultantes de vários modos de extensão

Exemplos

O exemplo a seguir mostra como definir os modos x e y-extend do pincel de bitmap como D2D1_EXTEND_MIRROR. Em seguida, ele pinta o retângulo com o ID2D1BitmapBrush.

Ele produz a saída a seguir.

Ilustração de uma imagem original e a imagem resultante da configuração dos modos x e y- extend para espelho 
m_pBitmapBrush->SetExtendModeX(D2D1_EXTEND_MODE_MIRROR);
m_pBitmapBrush->SetExtendModeY(D2D1_EXTEND_MODE_MIRROR);

m_pRenderTarget->FillRectangle(exampleRectangle, m_pBitmapBrush);

Para obter mais informações sobre pincéis de bitmap, consulte a Visão geral de pincéis.

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

ID2D1BitmapBrush

ID2D1BitmapBrush::GetExtendModeY