Geometry.Combine Metod

Definition

Kombinerar två Geometry objekt.

Överlagringar

Name Description
Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Kombinerar de två geometrierna med den angivna GeometryCombineMode och tillämpar den angivna transformeringen på den resulterande geometrin.

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

Kombinerar de två geometrierna med hjälp av den angivna GeometryCombineMode och toleransfaktorn och tillämpar den angivna transformeringen på den resulterande geometrin.

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Kombinerar de två geometrierna med den angivna GeometryCombineMode och tillämpar den angivna transformeringen på den resulterande geometrin.

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

Parametrar

geometry1
Geometry

Den första geometrin att kombinera.

geometry2
Geometry

Den andra geometrin att kombinera.

mode
GeometryCombineMode

Ett av uppräkningsvärdena som anger hur geometrierna kombineras.

transform
Transform

En transformering som ska tillämpas på den kombinerade geometrin, eller null.

Returer

Den kombinerade geometrin.

Kommentarer

Den här metoden använder standardtoleransfaktorn (beskrivs av egenskapen StandardFlatteningTolerance ) när du kombinerar geometrier. Använd metoden för Combine att ange din egen toleransfaktor.

Vissa Geometry metoder (till exempel Combine) producerar eller använder en polygonisk uppskattning av geometrin. Toleransfaktorn anger det maximala avståndet mellan punkter i den här polygonala uppskattningen. Mindre toleransvärden ger bättre uppskattningar, men kräver mer bearbetning än en uppskattning med en stor toleransfaktor.

Tänk noga när du använder Combine för att utföra en union eftersom det kan vara mycket CPU-dyrt. I de flesta fall fungerar en GeometryGroup eller AddGeometry bättre.

Använd Combine endast när något av följande gäller:

  • Den geometriska åtgärden är inte en union.

  • Någon av geometrierna har ett FillRule värde av EvenOdd och geometrierna är självindelande (dvs. de FillRule faktiskt spelar roll).

  • Tiden är inte ett problem, men utrymme är (till exempel om geometrin skapas en gång och sedan cachelagras). Vanligtvis Combine ger mindre utdata än AddGeometry.

  • Den resulterande geometrin kommer att linjeras eller användas i en sökvägsanimation och AddGeometry ger inte önskad kontur.

Gäller för

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

Kombinerar de två geometrierna med hjälp av den angivna GeometryCombineMode och toleransfaktorn och tillämpar den angivna transformeringen på den resulterande geometrin.

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

Parametrar

geometry1
Geometry

Den första geometrin att kombinera.

geometry2
Geometry

Den andra geometrin att kombinera.

mode
GeometryCombineMode

Ett av uppräkningsvärdena som anger hur geometrierna kombineras.

transform
Transform

En transformering som ska tillämpas på den kombinerade geometrin, eller null.

tolerance
Double

De maximala gränserna för avståndet mellan punkter i den polygonala uppskattningen av geometrierna. Mindre värden ger mer exakta resultat men orsakar långsammare körning. Om tolerance är mindre än .000001 används .000001 i stället.

type
ToleranceType

Ett av de ToleranceType värden som anger om toleransfaktorn är ett absolut värde eller i förhållande till geometrins område.

Returer

Den kombinerade geometrin.

Kommentarer

Vissa Geometry metoder (till exempel Combine) producerar eller använder en polygonisk uppskattning av geometrin. Toleransfaktorn anger det maximala avståndet mellan punkter i den här polygonala uppskattningen. Mindre toleransvärden ger bättre uppskattningar, men kräver mer bearbetning än en uppskattning med en stor toleransfaktor.

Tänk noga när du använder Combine för att utföra en union eftersom det kan vara mycket CPU-dyrt. I de flesta fall fungerar en GeometryGroup eller AddGeometry bättre.

Använd Combine endast när något av följande gäller:

  • Den geometriska åtgärden är inte en union.

  • Någon av geometrierna har ett FillRule värde av EvenOdd och geometrierna är självindelande (dvs. de FillRule faktiskt spelar roll).

  • Tiden är inte ett problem, men utrymme är (till exempel om geometrin skapas en gång och sedan cachelagras). Vanligtvis Combine ger mindre utdata än AddGeometry.

  • Den resulterande geometrin kommer att linjeras eller användas i en sökvägsanimation och AddGeometry ger inte önskad kontur.

Gäller för