Geometry.Combine Método

Definição

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Combina dois Geometry objetos.

Sobrecargas

Nome	Description
Combine(Geometry, Geometry, GeometryCombineMode, Transform)	Combina as duas geometrias usando a especificada GeometryCombineMode e aplica a transformação especificada à geometria resultante.
Combine(Geometry, Geometry, GeometryCombineMode, Transform, Double, ToleranceType)	Combina as duas geometrias usando o fator de tolerância e especificado GeometryCombineMode e aplica a transformação especificada à geometria resultante.

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Combina as duas geometrias usando a especificada GeometryCombineMode e aplica a transformação especificada à geometria resultante.

public:
 static System::Windows::Media::PathGeometry ^ Combine(System::Windows::Media::Geometry ^ geometry1, System::Windows::Media::Geometry ^ geometry2, System::Windows::Media::GeometryCombineMode mode, System::Windows::Media::Transform ^ transform);

public static System.Windows.Media.PathGeometry Combine(System.Windows.Media.Geometry geometry1, System.Windows.Media.Geometry geometry2, System.Windows.Media.GeometryCombineMode mode, System.Windows.Media.Transform transform);

static member Combine : System.Windows.Media.Geometry * System.Windows.Media.Geometry * System.Windows.Media.GeometryCombineMode * System.Windows.Media.Transform -> System.Windows.Media.PathGeometry

Public Shared Function Combine (geometry1 As Geometry, geometry2 As Geometry, mode As GeometryCombineMode, transform As Transform) As PathGeometry

Parâmetros

geometry1: Geometry

A primeira geometria a ser combinada.

geometry2: Geometry

A segunda geometria a ser combinada.

mode: GeometryCombineMode

Um dos valores de enumeração que especifica como as geometrias são combinadas.

transform: Transform

Uma transformação a ser aplicada à geometria combinada ou null.

Retornos

PathGeometry

A geometria combinada.

Comentários

Esse método usa o fator de tolerância padrão (descrito pela StandardFlatteningTolerance propriedade) ao combinar geometrias. Para especificar seu próprio fator de tolerância, use o método Combine.

Alguns métodos Geometry (como Combine) produzem ou usam uma aproximação poligonal da geometria. O fator de tolerância especifica a distância máxima entre os pontos nessa aproximação poligonal. Valores de tolerância menores produzem melhores aproximações, mas exigem mais processamento do que uma aproximação com um fator de tolerância grande.

O pensamento cuidadoso deve estar envolvido ao usar Combine para executar uma união, pois pode ser muito caro para a CPU. Na maioria dos casos, um GeometryGroup ou AddGeometry funcionará melhor.

Use Combine somente quando qualquer uma das seguintes aplicações:

A operação geométrica não é uma união.
Qualquer uma das geometrias tem um FillRule valor e EvenOdd as geometrias são auto-interseccionais (ou seja, as FillRule realmente importa).
O tempo não é uma preocupação, mas o espaço é (por exemplo, se a geometria é criada uma vez e depois armazenada em cache). Normalmente, Combine produz uma saída menor que AddGeometry.
A geometria resultante será traçada ou usada em uma animação de caminho e AddGeometry não fornecerá a estrutura de tópicos desejada.

Aplica-se a

Combine(Geometry, Geometry, GeometryCombineMode, Transform, Double, ToleranceType)

Combina as duas geometrias usando o fator de tolerância e especificado GeometryCombineMode e aplica a transformação especificada à geometria resultante.

public:
 static System::Windows::Media::PathGeometry ^ Combine(System::Windows::Media::Geometry ^ geometry1, System::Windows::Media::Geometry ^ geometry2, System::Windows::Media::GeometryCombineMode mode, System::Windows::Media::Transform ^ transform, double tolerance, System::Windows::Media::ToleranceType type);

public static System.Windows.Media.PathGeometry Combine(System.Windows.Media.Geometry geometry1, System.Windows.Media.Geometry geometry2, System.Windows.Media.GeometryCombineMode mode, System.Windows.Media.Transform transform, double tolerance, System.Windows.Media.ToleranceType type);

static member Combine : System.Windows.Media.Geometry * System.Windows.Media.Geometry * System.Windows.Media.GeometryCombineMode * System.Windows.Media.Transform * double * System.Windows.Media.ToleranceType -> System.Windows.Media.PathGeometry

Public Shared Function Combine (geometry1 As Geometry, geometry2 As Geometry, mode As GeometryCombineMode, transform As Transform, tolerance As Double, type As ToleranceType) As PathGeometry

Parâmetros

geometry1: Geometry

A primeira geometria a ser combinada.

geometry2: Geometry

A segunda geometria a ser combinada.

mode: GeometryCombineMode

Um dos valores de enumeração que especifica como as geometrias são combinadas.

transform: Transform

Uma transformação a ser aplicada à geometria combinada ou null.

tolerance: Double

Os limites máximos na distância entre os pontos na aproximação poligonal das geometrias. Valores menores produzem resultados mais precisos, mas causam uma execução mais lenta. Se tolerance for menor que .000001, .000001 será usado.

type: ToleranceType

Um dos valores ToleranceType que especifica se o fator de tolerância é um valor absoluto ou relativo à área da geometria.

Retornos

PathGeometry

A geometria combinada.

Comentários

O pensamento cuidadoso deve estar envolvido ao usar Combine para executar uma união, pois pode ser muito caro para a CPU. Na maioria dos casos, um GeometryGroup ou AddGeometry funcionará melhor.

Use Combine somente quando qualquer uma das seguintes aplicações:

A operação geométrica não é uma união.
Qualquer uma das geometrias tem um FillRule valor e EvenOdd as geometrias são auto-interseccionais (ou seja, as FillRule realmente importa).
O tempo não é uma preocupação, mas o espaço é (por exemplo, se a geometria é criada uma vez e depois armazenada em cache). Normalmente, Combine produz uma saída menor que AddGeometry.
A geometria resultante será traçada ou usada em uma animação de caminho e AddGeometry não fornecerá a estrutura de tópicos desejada.

Aplica-se a

Comentários

Esta página foi útil?