Freigeben über


Geometry.Combine Methode

Definition

Kombiniert zwei Geometry-Objekte.

Überlädt

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Kombiniert die beiden Geometrien unter Verwendung des angegebenen GeometryCombineMode und wendet die angegebene Transformation auf die resultierende Geometrie an.

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

Kombiniert die beiden Geometrien unter Verwendung des angegebenen GeometryCombineMode und Toleranzfaktors und wendet die angegebene Transformation auf die resultierende Geometrie an.

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Kombiniert die beiden Geometrien unter Verwendung des angegebenen GeometryCombineMode und wendet die angegebene Transformation auf die resultierende Geometrie an.

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

Parameter

geometry1
Geometry

Die erste zu kombinierende Geometrie.

geometry2
Geometry

Die zweite zu kombinierende Geometrie.

mode
GeometryCombineMode

Einer der Enumerationswerte, die angeben, wie die Geometrien kombiniert werden.

transform
Transform

Eine auf die kombinierte Geometrie anzuwendende Transformation oder null.

Gibt zurück

Die kombinierte Geometrie.

Hinweise

Diese Methode verwendet den Standardtoleranzfaktor (beschrieben durch die StandardFlatteningTolerance -Eigenschaft) beim Kombinieren von Geometrien. Verwenden Sie die Combine -Methode, um Ihren eigenen Toleranzfaktor anzugeben.

Einige Geometry Methoden (z Combine. B. ) erzeugen oder verwenden eine polygonale Annäherung der Geometrie. Der Toleranzfaktor gibt den maximalen Abstand zwischen Punkten in dieser polygonalen Näherung an. Kleinere Toleranzwerte führen zu besseren Näherungswerten, erfordern jedoch mehr Verarbeitung als eine Näherung mit einem großen Toleranzfaktor.

Bei der Verwendung Combine einer Union sollte sorgfältig überlegt werden, da dies sehr CPU-teuer sein kann. In den meisten Fällen funktioniert ein GeometryGroup oder AddGeometry besser.

Verwenden Sie Combine nur, wenn eine der folgenden Punkte zutrifft:

  • Die geometrische Operation ist keine Union.

  • Jede der Geometrien hat einen FillRule Wert von EvenOdd , und die Geometrien überschneiden sich selbst (d. h. die FillRule tatsächliche Bedeutung).

  • Zeit ist kein Problem, aber Raum ist (z. B. wenn die Geometrie einmal erstellt und dann zwischengespeichert wird). Combine In der Regel erzeugt eine kleinere Ausgabe als AddGeometry.

  • Die resultierende Geometrie wird gezeichnet oder in einer Pfadanimation verwendet und AddGeometry bietet nicht die gewünschte Gliederung.

Gilt für:

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

Kombiniert die beiden Geometrien unter Verwendung des angegebenen GeometryCombineMode und Toleranzfaktors und wendet die angegebene Transformation auf die resultierende Geometrie an.

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

Parameter

geometry1
Geometry

Die erste zu kombinierende Geometrie.

geometry2
Geometry

Die zweite zu kombinierende Geometrie.

mode
GeometryCombineMode

Einer der Enumerationswerte, die angeben, wie die Geometrien kombiniert werden.

transform
Transform

Eine auf die kombinierte Geometrie anzuwendende Transformation oder null.

tolerance
Double

Die maximalen Grenzen für die Entfernung zwischen Punkten in der polygonalen Approximation der Geometrien. Kleinere Werte liefern genauere Ergebnisse, führen jedoch zu einer langsameren Ausführung. Wenn tolerance kleiner als 0,000001 ist, wird stattdessen 0,000001 verwendet.

type
ToleranceType

Einer der ToleranceType-Werte, die angeben, ob der Toleranzfaktor ein absoluter Wert oder relativ zum Bereich der Geometrie ist.

Gibt zurück

Die kombinierte Geometrie.

Hinweise

Einige Geometry Methoden (z Combine. B. ) erzeugen oder verwenden eine polygonale Annäherung der Geometrie. Der Toleranzfaktor gibt den maximalen Abstand zwischen Punkten in dieser polygonalen Näherung an. Kleinere Toleranzwerte führen zu besseren Näherungswerten, erfordern jedoch mehr Verarbeitung als eine Näherung mit einem großen Toleranzfaktor.

Bei der Verwendung Combine einer Union sollte sorgfältig überlegt werden, da dies sehr CPU-teuer sein kann. In den meisten Fällen funktioniert ein GeometryGroup oder AddGeometry besser.

Verwenden Sie Combine nur, wenn eine der folgenden Punkte zutrifft:

  • Die geometrische Operation ist keine Union.

  • Jede der Geometrien hat einen FillRule Wert von EvenOdd , und die Geometrien überschneiden sich selbst (d. h. die FillRule tatsächliche Bedeutung).

  • Zeit ist kein Problem, aber Raum ist (z. B. wenn die Geometrie einmal erstellt und dann zwischengespeichert wird). Combine In der Regel erzeugt eine kleinere Ausgabe als AddGeometry.

  • Die resultierende Geometrie wird gezeichnet oder in einer Pfadanimation verwendet und AddGeometry bietet nicht die gewünschte Gliederung.

Gilt für: