Geometry.Combine Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.PathGeometryPublic Shared Function Combine (geometry1 As Geometry, geometry2 As Geometry, mode As GeometryCombineMode, transform As Transform) As PathGeometryParameter
- 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.PathGeometryPublic Shared Function Combine (geometry1 As Geometry, geometry2 As Geometry, mode As GeometryCombineMode, transform As Transform, tolerance As Double, type As ToleranceType) As PathGeometryParameter
- 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.
