Geometry.Combine Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Media
Ensamblado:
PresentationCore.dll

Combina dos objetos Geometry.

Sobrecargas

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Combina las dos geometrías mediante el modo GeometryCombineMode especificado y aplica la transformación indicada a la geometría resultante.
Combine(Geometry, Geometry, GeometryCombineMode, Transform, Double, ToleranceType)

Combina las dos geometrías utilizando el factor de tolerancia y el modo GeometryCombineMode especificados y aplica la transformación indicada a la geometría resultante.

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Combina las dos geometrías mediante el modo GeometryCombineMode especificado y aplica la transformación indicada a la geometría resultante.

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

Parámetros

geometry1
Geometry

Primera geometría que se va a combinar.

geometry2
Geometry

Segunda geometría que se va a combinar.

mode
GeometryCombineMode

Uno de los valores de enumeración que especifica cómo se combinan las geometrías.

transform
Transform

Transformación que se va a aplicar a la geometría combinada o null.

Devoluciones

PathGeometry

Geometría combinada.

Comentarios

Este método usa el factor de tolerancia predeterminado (descrito por la StandardFlatteningTolerance propiedad ) al combinar geometrías. Para especificar su propio factor de tolerancia, use el Combine método .

Algunos Geometry métodos (como Combine) producen o usan una aproximación poligonal de la geometría. El factor de tolerancia especifica la distancia máxima entre puntos de esta aproximación poligonal. Los valores de tolerancia más pequeños producen mejores aproximaciones, pero requieren más procesamiento que una aproximación con un factor de tolerancia grande.

Se debe pensar detenidamente al usar Combine para realizar una unión, ya que puede ser muy costoso para la CPU. En la mayoría de los casos, un GeometryGroup o AddGeometry funcionará mejor.

Use Combine solo cuando se aplique cualquiera de las siguientes condiciones:

  • La operación geométrica no es una unión.

  • Cualquiera de las geometrías tiene un FillRule valor de EvenOdd y las geometrías son auto intersección (es decir, lo FillRule que realmente importa).

  • El tiempo no es un problema, pero el espacio es (por ejemplo, si la geometría se crea una vez y, a continuación, se almacena en caché). Normalmente, Combine genera una salida menor que AddGeometry.

  • La geometría resultante se trazará o se usará en una animación de ruta de acceso y AddGeometry no proporciona el contorno deseado.

Se aplica a

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

Combina las dos geometrías utilizando el factor de tolerancia y el modo GeometryCombineMode especificados y aplica la transformación indicada a la geometría resultante.

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

Parámetros

geometry1
Geometry

Primera geometría que se va a combinar.

geometry2
Geometry

Segunda geometría que se va a combinar.

mode
GeometryCombineMode

Uno de los valores de enumeración que especifica cómo se combinan las geometrías.

transform
Transform

Transformación que se va a aplicar a la geometría combinada o null.

tolerance
Double

Límites máximos de la distancia entre puntos en la aproximación poligonal de las geometrías. Los valores menores generan resultados más precisos pero hacen que la ejecución sea más lenta. Si tolerance es menor que 0,000001, se utiliza en su lugar 0,000001.

type
ToleranceType

Uno de los valores de ToleranceType que especifica si el factor de tolerancia es un valor absoluto o relativo en el área de la geometría.

Devoluciones

PathGeometry

Geometría combinada.

Comentarios

Algunos Geometry métodos (como Combine) producen o usan una aproximación poligonal de la geometría. El factor de tolerancia especifica la distancia máxima entre puntos de esta aproximación poligonal. Los valores de tolerancia más pequeños producen mejores aproximaciones, pero requieren más procesamiento que una aproximación con un factor de tolerancia grande.

Se debe pensar detenidamente al usar Combine para realizar una unión, ya que puede ser muy costoso para la CPU. En la mayoría de los casos, un GeometryGroup o AddGeometry funcionará mejor.

Use Combine solo cuando se aplique cualquiera de las siguientes condiciones:

  • La operación geométrica no es una unión.

  • Cualquiera de las geometrías tiene un FillRule valor de EvenOdd y las geometrías son auto intersección (es decir, lo FillRule que realmente importa).

  • El tiempo no es un problema, pero el espacio es (por ejemplo, si la geometría se crea una vez y, a continuación, se almacena en caché). Normalmente, Combine genera una salida menor que AddGeometry.

  • La geometría resultante se trazará o se usará en una animación de ruta de acceso y AddGeometry no proporciona el contorno deseado.

Se aplica a