Geometry.Combine Methode

Definitie

Combineert twee Geometry objecten.

Overloads

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

Combineert de twee geometrieën met behulp van de opgegeven GeometryCombineMode en past de opgegeven transformatie toe op de resulterende geometrie.

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

Combineert de twee geometrieën met behulp van de opgegeven GeometryCombineMode en tolerantiefactor en past de opgegeven transformatie toe op de resulterende geometrie.

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Combineert de twee geometrieën met behulp van de opgegeven GeometryCombineMode en past de opgegeven transformatie toe op de resulterende geometrie.

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

Parameters

geometry1
Geometry

De eerste geometrie die moet worden gecombineerd.

geometry2
Geometry

De tweede geometrie die moet worden gecombineerd.

mode
GeometryCombineMode

Een van de opsommingswaarden die aangeeft hoe de geometrieën worden gecombineerd.

transform
Transform

Een transformatie die moet worden toegepast op de gecombineerde geometrie of null.

Retouren

De gecombineerde geometrie.

Opmerkingen

Deze methode maakt gebruik van de standaardtolerantiefactor (beschreven door de StandardFlatteningTolerance eigenschap) bij het combineren van geometrieën. Als u uw eigen tolerantiefactor wilt opgeven, gebruikt u de Combine methode.

Sommige Geometry methoden (zoals Combine) produceren of gebruiken een veelhoekige benadering van de geometrie. De tolerantiefactor geeft de maximale afstand tussen punten in deze veelhoekige benadering aan. Kleinere tolerantiewaarden produceren betere benaderingen, maar vereisen meer verwerking dan een benadering met een grote tolerantiefactor.

Zorgvuldige gedachten moeten worden betrokken bij het gebruik van Combine een samenvoeging, omdat het zeer cpu-duur kan zijn. In de meeste gevallen werkt een GeometryGroup of AddGeometry beter.

Gebruik Combine alleen wanneer een van de volgende zaken van toepassing is:

  • De geometrische werking is geen samenvoeging.

  • Een van de geometrieën heeft een FillRule waarde en EvenOdd de geometrieën zijn zelf snijdend (dat wil bijvoorbeeld de FillRule eigenlijke zaken zijn).

  • Tijd is geen probleem, maar ruimte is (bijvoorbeeld als de geometrie eenmaal wordt gemaakt en vervolgens in de cache wordt opgeslagen). Combine Produceert doorgaans een kleinere uitvoer dan AddGeometry.

  • De resulterende geometrie wordt gestreken of gebruikt in een padanimatie en AddGeometry biedt geen gewenste omtrek.

Van toepassing op

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

Combineert de twee geometrieën met behulp van de opgegeven GeometryCombineMode en tolerantiefactor en past de opgegeven transformatie toe op de resulterende geometrie.

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

Parameters

geometry1
Geometry

De eerste geometrie die moet worden gecombineerd.

geometry2
Geometry

De tweede geometrie die moet worden gecombineerd.

mode
GeometryCombineMode

Een van de opsommingswaarden die aangeeft hoe de geometrieën worden gecombineerd.

transform
Transform

Een transformatie die moet worden toegepast op de gecombineerde geometrie of null.

tolerance
Double

De maximumgrenzen op de afstand tussen punten in de veelhoekige benadering van de geometrieën. Kleinere waarden produceren nauwkeurigere resultaten, maar leiden tot tragere uitvoering. Als tolerance deze kleiner is dan .000001, wordt in plaats daarvan .000001 gebruikt.

type
ToleranceType

Een van de ToleranceType waarden die aangeeft of de tolerantiefactor een absolute waarde is of ten opzichte van het gebied van de geometrie.

Retouren

De gecombineerde geometrie.

Opmerkingen

Sommige Geometry methoden (zoals Combine) produceren of gebruiken een veelhoekige benadering van de geometrie. De tolerantiefactor geeft de maximale afstand tussen punten in deze veelhoekige benadering aan. Kleinere tolerantiewaarden produceren betere benaderingen, maar vereisen meer verwerking dan een benadering met een grote tolerantiefactor.

Zorgvuldige gedachten moeten worden betrokken bij het gebruik van Combine een samenvoeging, omdat het zeer cpu-duur kan zijn. In de meeste gevallen werkt een GeometryGroup of AddGeometry beter.

Gebruik Combine alleen wanneer een van de volgende zaken van toepassing is:

  • De geometrische werking is geen samenvoeging.

  • Een van de geometrieën heeft een FillRule waarde en EvenOdd de geometrieën zijn zelf snijdend (dat wil bijvoorbeeld de FillRule eigenlijke zaken zijn).

  • Tijd is geen probleem, maar ruimte is (bijvoorbeeld als de geometrie eenmaal wordt gemaakt en vervolgens in de cache wordt opgeslagen). Combine Produceert doorgaans een kleinere uitvoer dan AddGeometry.

  • De resulterende geometrie wordt gestreken of gebruikt in een padanimatie en AddGeometry biedt geen gewenste omtrek.

Van toepassing op