Geometry.Combine Méthode

Définition

Combine deux objets Geometry.

Surcharges

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Combine les deux géométries à l'aide du GeometryCombineMode spécifié et applique la transformation spécifiée à la géométrie résultante.

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

Combine les deux géométries à l'aide du facteur de tolérance GeometryCombineMode spécifié et applique la transformation spécifiée à la géométrie résultante.

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Combine les deux géométries à l'aide du GeometryCombineMode spécifié et applique la transformation spécifiée à la géométrie résultante.

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

Paramètres

geometry1
Geometry

Première géométrie à combiner.

geometry2
Geometry

Deuxième géométrie à combiner.

mode
GeometryCombineMode

Une des valeurs d'énumération qui spécifie la manière dont les géométries sont combinées.

transform
Transform

Transformation à appliquer à la géométrie combinée, ou null.

Retours

Géométrie combinée.

Remarques

Cette méthode utilise le facteur de tolérance par défaut (décrit par la propriété ) lors de la StandardFlatteningTolerance combinaison de géométries. Pour spécifier votre propre facteur de tolérance, utilisez la Combine méthode .

Certaines Geometry méthodes (telles que Combine) produisent ou utilisent une approximation polygonale de la géométrie. Le facteur de tolérance spécifie la distance maximale entre les points dans cette approximation polygonale. Les valeurs de tolérance plus petites produisent de meilleures approximations, mais nécessitent plus de traitement qu’une approximation avec un facteur de tolérance important.

Une réflexion attentive doit être impliquée lors de l’utilisation Combine pour effectuer une union, car elle peut être très coûteuse en processeur. Dans la plupart des cas, ou GeometryGroupAddGeometry fonctionne mieux.

Utilisez Combine uniquement lorsque l’un des éléments suivants s’applique :

  • L’opération géométrique n’est pas une union.

  • L’une ou l’autre des géométries a une FillRule valeur de EvenOdd et les géométries sont auto-croisées (c’est-à-dire les FillRule éléments réels).

  • Le temps n’est pas un problème, mais l’espace est (par exemple, si la géométrie est créée une fois, puis mise en cache). En règle générale, Combine produit une sortie inférieure à AddGeometry.

  • La géométrie résultante sera tracée ou utilisée dans une animation de chemin et AddGeometry ne fournit pas le contour souhaité.

S’applique à

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

Combine les deux géométries à l'aide du facteur de tolérance GeometryCombineMode spécifié et applique la transformation spécifiée à la géométrie résultante.

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

Paramètres

geometry1
Geometry

Première géométrie à combiner.

geometry2
Geometry

Deuxième géométrie à combiner.

mode
GeometryCombineMode

Une des valeurs d'énumération qui spécifie la manière dont les géométries sont combinées.

transform
Transform

Transformation à appliquer à la géométrie combinée, ou null.

tolerance
Double

Limites maximales de la distance entre les points de l'approximation polygonale des géométries. Des valeurs plus faibles permettent de générer des résultats plus précis mais ralentissent l'exécution. Si tolerance est inférieure à 0,000001, 0,000001 sera utilisé à la place.

type
ToleranceType

L'une des valeurs ToleranceType spécifiant si le facteur de tolérance est une valeur absolue ou relative à la zone de la géométrie.

Retours

Géométrie combinée.

Remarques

Certaines Geometry méthodes (telles que Combine) produisent ou utilisent une approximation polygonale de la géométrie. Le facteur de tolérance spécifie la distance maximale entre les points dans cette approximation polygonale. Les valeurs de tolérance plus petites produisent de meilleures approximations, mais nécessitent plus de traitement qu’une approximation avec un facteur de tolérance important.

Une réflexion attentive doit être impliquée lors de l’utilisation Combine pour effectuer une union, car elle peut être très coûteuse en processeur. Dans la plupart des cas, ou GeometryGroupAddGeometry fonctionne mieux.

Utilisez Combine uniquement lorsque l’un des éléments suivants s’applique :

  • L’opération géométrique n’est pas une union.

  • L’une ou l’autre des géométries a une FillRule valeur de EvenOdd et les géométries sont auto-croisées (c’est-à-dire les FillRule éléments réels).

  • Le temps n’est pas un problème, mais l’espace est (par exemple, si la géométrie est créée une fois, puis mise en cache). En règle générale, Combine produit une sortie inférieure à AddGeometry.

  • La géométrie résultante sera tracée ou utilisée dans une animation de chemin et AddGeometry ne fournit pas le contour souhaité.

S’applique à