Geometry.Combine Metodo

Definizione

Combina due oggetti Geometry.

Overload

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Combina le due geometrie utilizzando il metodo GeometryCombineMode specificato e applica la trasformazione specificata alla geometria risultante.

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

Combina le due geometrie utilizzando il metodo GeometryCombineMode e il fattore di tolleranza specificati e applica la trasformazione specificata alla geometria risultante.

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Combina le due geometrie utilizzando il metodo GeometryCombineMode specificato e applica la trasformazione specificata alla geometria risultante.

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

Parametri

geometry1
Geometry

Prima geometria da combinare.

geometry2
Geometry

Seconda geometria da combinare.

mode
GeometryCombineMode

Uno dei valori di enumerazione che specifica il modo in cui vengono combinate le geometrie.

transform
Transform

Trasformazione da applicare alla geometria combinata oppure null.

Restituisce

Geometria combinata.

Commenti

Questo metodo usa il fattore di tolleranza predefinito (descritto dalla proprietà ) durante la StandardFlatteningTolerance combinazione delle geometrie. Per specificare il proprio fattore di tolleranza, usare il Combine metodo .

Alcuni Geometry metodi (ad esempio Combine) producono o usano un'approssimazione poligonale della geometria. Il fattore di tolleranza specifica la distanza massima tra i punti in questa approssimazione poligonale. I valori di tolleranza più piccoli producono approssimazioni migliori, ma richiedono più elaborazione rispetto a un'approssimazione con un fattore di tolleranza elevato.

È consigliabile prestare attenzione quando si usa Combine per eseguire un'unione perché può essere molto costosa dalla CPU. Nella maggior parte dei casi, un GeometryGroup oggetto o AddGeometry funzionerà meglio.

Usare Combine solo quando si applica uno dei seguenti elementi:

  • L'operazione geometrica non è un'unione.

  • Entrambe le geometrie hanno un FillRule valore e EvenOdd le geometrie sono auto-intersecanti (vale a dire che in FillRule realtà è importante).

  • Il tempo non è un problema, ma lo spazio è (ad esempio, se la geometria viene creata una sola volta e quindi memorizzata nella cache). In genere, Combine produce un output più piccolo di AddGeometry.

  • La geometria risultante verrà tracciata o usata in un'animazione di percorso e AddGeometry non fornisce il contorno desiderato.

Si applica a

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

Combina le due geometrie utilizzando il metodo GeometryCombineMode e il fattore di tolleranza specificati e applica la trasformazione specificata alla geometria risultante.

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

Parametri

geometry1
Geometry

Prima geometria da combinare.

geometry2
Geometry

Seconda geometria da combinare.

mode
GeometryCombineMode

Uno dei valori di enumerazione che specifica il modo in cui vengono combinate le geometrie.

transform
Transform

Trasformazione da applicare alla geometria combinata oppure null.

tolerance
Double

Limiti massimi della distanza tra i punti nell'approssimazione poligonale delle geometrie. Valori inferiori producono risultati più precisi ma possono rallentare l'esecuzione. Se tolerance è minore di .000001, viene utilizzato .000001.

type
ToleranceType

Uno dei valori ToleranceType che specifica se il fattore di tolleranza è un valore assoluto o un valore relativo all'area della geometria.

Restituisce

Geometria combinata.

Commenti

Alcuni Geometry metodi (ad esempio Combine) producono o usano un'approssimazione poligonale della geometria. Il fattore di tolleranza specifica la distanza massima tra i punti in questa approssimazione poligonale. I valori di tolleranza più piccoli producono approssimazioni migliori, ma richiedono più elaborazione rispetto a un'approssimazione con un fattore di tolleranza elevato.

È consigliabile prestare attenzione quando si usa Combine per eseguire un'unione perché può essere molto costosa dalla CPU. Nella maggior parte dei casi, un GeometryGroup oggetto o AddGeometry funzionerà meglio.

Usare Combine solo quando si applica uno dei seguenti elementi:

  • L'operazione geometrica non è un'unione.

  • Entrambe le geometrie hanno un FillRule valore e EvenOdd le geometrie sono auto-intersecanti (vale a dire che in FillRule realtà è importante).

  • Il tempo non è un problema, ma lo spazio è (ad esempio, se la geometria viene creata una sola volta e quindi memorizzata nella cache). In genere, Combine produce un output più piccolo di AddGeometry.

  • La geometria risultante verrà tracciata o usata in un'animazione di percorso e AddGeometry non fornisce il contorno desiderato.

Si applica a