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
| Name | Beschreibung |
|---|---|
| Combine(Geometry, Geometry, GeometryCombineMode, Transform) |
Kombiniert die beiden Geometrien mithilfe der angegebenen GeometryCombineMode Geometrie 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 mithilfe der angegebenen GeometryCombineMode Geometrie 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 Geometrie, die kombiniert werden soll.
- geometry2
- Geometry
Die zweite Geometrie, die kombiniert werden soll.
- mode
- GeometryCombineMode
Einer der Enumerationswerte, der angibt, wie die Geometrien kombiniert werden.
- transform
- Transform
Eine Transformation, die auf die kombinierte Geometrie angewendet werden soll, oder null.
Gibt zurück
Die kombinierte Geometrie.
Hinweise
Diese Methode verwendet beim Kombinieren von Geometrien den Standardtoleranzfaktor (beschrieben durch die StandardFlatteningTolerance Eigenschaft). 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 Annäherung an. Kleinere Toleranzwerte erzeugen bessere Annäherungen, erfordern jedoch mehr Verarbeitung als eine Annäherung mit einem großen Toleranzfaktor.
Sorgfältige Überlegungen sollten bei der Verwendung Combine einer Union einbezogen werden, da sie sehr CPU-teuer sein kann. In den meisten Fällen funktioniert ein GeometryGroup oder AddGeometry wird besser funktionieren.
Wird nur verwendet Combine , wenn eine der folgenden Bedingungen zutrifft:
Die geometrische Operation ist keine Vereinigung.
Eine der Geometrien hat einen FillRule Wert, EvenOdd und die Geometrien sind sich selbst überschneidend (d. h. die FillRule tatsächlich wichtigen).
Zeit ist kein Problem, aber Raum ist (z. B. wenn die Geometrie einmal erstellt und dann zwischengespeichert wird). Combine Erzeugt in der Regel eine geringere Ausgabe als AddGeometry.
Die resultierende Geometrie wird in einer Pfadanimation gestrichelt oder verwendet und AddGeometry stellt nicht die gewünschte Kontur bereit.
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 Geometrie, die kombiniert werden soll.
- geometry2
- Geometry
Die zweite Geometrie, die kombiniert werden soll.
- mode
- GeometryCombineMode
Einer der Enumerationswerte, der angibt, wie die Geometrien kombiniert werden.
- transform
- Transform
Eine Transformation, die auf die kombinierte Geometrie angewendet werden soll, oder null.
- tolerance
- Double
Die maximale Grenze für den Abstand zwischen Punkten in der polygonalen Annäherung der Geometrien. Kleinere Werte erzeugen genauere Ergebnisse, verursachen jedoch eine langsamere Ausführung. Ist tolerance dies kleiner als .000001, wird stattdessen .000001 verwendet.
- type
- ToleranceType
Einer der ToleranceType Werte, der angibt, 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 Annäherung an. Kleinere Toleranzwerte erzeugen bessere Annäherungen, erfordern jedoch mehr Verarbeitung als eine Annäherung mit einem großen Toleranzfaktor.
Sorgfältige Überlegungen sollten bei der Verwendung Combine einer Union einbezogen werden, da sie sehr CPU-teuer sein kann. In den meisten Fällen funktioniert ein GeometryGroup oder AddGeometry wird besser funktionieren.
Wird nur verwendet Combine , wenn eine der folgenden Bedingungen zutrifft:
Die geometrische Operation ist keine Vereinigung.
Eine der Geometrien hat einen FillRule Wert, EvenOdd und die Geometrien sind sich selbst überschneidend (d. h. die FillRule tatsächlich wichtigen).
Zeit ist kein Problem, aber Raum ist (z. B. wenn die Geometrie einmal erstellt und dann zwischengespeichert wird). Combine Erzeugt in der Regel eine geringere Ausgabe als AddGeometry.
Die resultierende Geometrie wird in einer Pfadanimation gestrichelt oder verwendet und AddGeometry stellt nicht die gewünschte Kontur bereit.
