Método ID2D1Geometry::Outline(constD2D1_MATRIX_3X2_F*,FLOAT,ID2D1SimplifiedGeometrySink*) (d2d1.h)

  • Artigo

Calcula a estrutura de tópicos da geometria e grava o resultado em um ID2D1SimplifiedGeometrySink.

Sintaxe

HRESULT Outline(
  [in, optional] const D2D1_MATRIX_3X2_F     *worldTransform,
                 FLOAT                       flatteningTolerance,
  [in]           ID2D1SimplifiedGeometrySink *geometrySink
);

Parâmetros

[in, optional] worldTransform

Tipo: const D2D1_MATRIX_3X2_F*

A transformação a ser aplicada à estrutura de tópicos de geometria ou NULL.

flatteningTolerance

Tipo: FLOAT

O erro máximo permitido ao construir uma aproximação poligonal da geometria. Nenhum ponto na representação poligonal divergirá da geometria original em mais do que a tolerância de nivelamento. Valores menores produzem resultados mais precisos, mas causam a execução lenta.

[in] geometrySink

Tipo: ID2D1SimplifiedGeometrySink*

O ID2D1SimplifiedGeometrySink ao qual a estrutura de tópicos transformada da geometria é acrescentada.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

O método Outline permite que o chamador produza uma geometria com um preenchimento equivalente à geometria de entrada, com as seguintes propriedades adicionais:

  • A geometria de saída não contém interseções transversais; ou seja, os segmentos podem tocar, mas nunca se cruzam.
  • As figuras mais externas na geometria de saída são todas orientadas no sentido anti-horário.
  • A geometria de saída é invariável no modo de preenchimento; ou seja, o preenchimento da geometria não depende da escolha do modo de preenchimento.

    Para obter mais informações sobre o modo de preenchimento, consulte D2D1_FILL_MODE.

Além disso, o método Outline pode ser útil na remoção de partes redundantes dessas geometrias para simplificar geometrias complexas. Ele também pode ser útil em combinação com ID2D1GeometryGroup para criar uniões entre várias geometrias simultaneamente.

Requisitos

   
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

ID2D1Geometry