Geometry.Combine Metoda

Definicja

Przestrzeń nazw:

System.Windows.Media

Zestaw:

PresentationCore.dll

Łączy dwa Geometry obiekty.

Przeciążenia

Combine(Geometry, Geometry, GeometryCombineMode, Transform)	Łączy dwie geometrie przy użyciu określonej GeometryCombineMode i stosuje określone przekształcenie do wynikowej geometrii.
Combine(Geometry, Geometry, GeometryCombineMode, Transform, Double, ToleranceType)	Łączy dwie geometrie przy użyciu określonego GeometryCombineMode współczynnika tolerancji i stosuje określoną transformację do wynikowej geometrii.

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Łączy dwie geometrie przy użyciu określonej GeometryCombineMode i stosuje określone przekształcenie do wynikowej geometrii.

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

Parametry

geometry1

Geometry

Pierwsza geometria do połączenia.

geometry2

Geometry

Druga geometria do połączenia.

mode

GeometryCombineMode

Jedna z wartości wyliczenia określająca sposób łączenia geometrii.

transform

Transform

Przekształcenie, które ma być stosowane do połączonej geometrii, lub null.

Zwraca

PathGeometry

Połączona geometria.

Uwagi

Ta metoda używa domyślnego współczynnika tolerancji (opisanego StandardFlatteningTolerance przez właściwość) podczas łączenia geometrii. Aby określić własny współczynnik tolerancji, użyj Combine metody .

Niektóre Geometry metody (takie jak Combine) tworzą lub używają wielokątnego przybliżenia geometrii. Współczynnik tolerancji określa maksymalną odległość między punktami w tym przybliżeniu wielokątne. Mniejsze wartości tolerancji dają lepsze przybliżenia, ale wymagają większego przetwarzania niż przybliżenie z dużym współczynnikiem tolerancji.

Uważaj, że należy wziąć udział w używaniu Combine do wykonania unii, ponieważ może to być bardzo kosztowne dla procesora CPU. W większości przypadków element GeometryGroup lub AddGeometry będzie działać lepiej.

Użyj Combine tylko wtedy, gdy ma zastosowanie dowolny z następujących elementów:

• Operacja geometryczna nie jest unionem.

• Każda z geometrii ma FillRule wartość EvenOdd , a geometrie są samozabezpieczone (tj. FillRule faktycznie ma znaczenie).

• Czas nie jest problemem, ale spacja to (na przykład jeśli geometria jest tworzona raz, a następnie buforowana). Combine Zazwyczaj generuje mniejsze dane wyjściowe niż AddGeometry.

• Wynikowa geometria zostanie pociągnięta lub użyta w animacji ścieżki i AddGeometry nie zapewnia żądanego konspektu.

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

Łączy dwie geometrie przy użyciu określonego GeometryCombineMode współczynnika tolerancji i stosuje określoną transformację do wynikowej geometrii.

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

Parametry

geometry1

Geometry

Pierwsza geometria do połączenia.

geometry2

Geometry

Druga geometria do połączenia.

mode

GeometryCombineMode

Jedna z wartości wyliczenia określająca sposób łączenia geometrii.

transform

Transform

Przekształcenie, które ma być stosowane do połączonej geometrii, lub null.

tolerance

Double

Maksymalna granica odległości między punktami w przybliżeniu wielokątne geometrii. Mniejsze wartości generują dokładniejsze wyniki, ale powodują wolniejsze wykonywanie. Jeśli tolerance wartość jest mniejsza niż .000001, zostanie użyta zamiast tego wartość .000001.

type

ToleranceType

ToleranceType Jedna z wartości określających, czy współczynnik tolerancji jest wartością bezwzględną, czy względem obszaru geometrii.

Zwraca

PathGeometry

Połączona geometria.

Uwagi

Niektóre Geometry metody (takie jak Combine) tworzą lub używają wielokątnego przybliżenia geometrii. Współczynnik tolerancji określa maksymalną odległość między punktami w tym przybliżeniu wielokątne. Mniejsze wartości tolerancji dają lepsze przybliżenia, ale wymagają większego przetwarzania niż przybliżenie z dużym współczynnikiem tolerancji.

Uważaj, że należy wziąć udział w używaniu Combine do wykonania unii, ponieważ może to być bardzo kosztowne dla procesora CPU. W większości przypadków element GeometryGroup lub AddGeometry będzie działać lepiej.

Użyj Combine tylko wtedy, gdy ma zastosowanie dowolny z następujących elementów:

• Operacja geometryczna nie jest unionem.

• Każda z geometrii ma FillRule wartość EvenOdd , a geometrie są samozabezpieczone (tj. FillRule faktycznie ma znaczenie).

• Czas nie jest problemem, ale spacja to (na przykład jeśli geometria jest tworzona raz, a następnie buforowana). Combine Zazwyczaj generuje mniejsze dane wyjściowe niż AddGeometry.

• Wynikowa geometria zostanie pociągnięta lub użyta w animacji ścieżki i AddGeometry nie zapewnia żądanego konspektu.