Geometry.Combine 方法

定義

結合兩個 Geometry 物件。

多載

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

使用指定的 GeometryCombineMode 結合兩個幾何,然後將指定的轉換套用至產生的幾何。

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

使用指定的 GeometryCombineMode 和容錯因數結合兩個幾何,然後將指定的轉換套用至產生的幾何。

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

使用指定的 GeometryCombineMode 結合兩個幾何,然後將指定的轉換套用至產生的幾何。

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

參數

geometry1
Geometry

要結合的第一個幾何。

geometry2
Geometry

要結合的第二個幾何。

mode
GeometryCombineMode

其中一個列舉值,指定幾何的結合方式。

transform
Transform

要套用至結合後之幾何的轉換,或為 null

傳回

結合後的幾何。

備註

此方法會在結合幾何時,使用屬性所描述 StandardFlatteningTolerance 的預設容錯因數 () 。 若要指定您自己的容錯因數,請使用 Combine 方法。

某些 Geometry 方法 (例如 Combine) 產生或使用幾何的多邊形近似值。 容錯因數會指定此多邊形近似值中點之間的最大距離。 較小的容錯值會產生較佳的近似值,但需要比具有大型容錯因數的近似值更多的處理。

使用 來執行等位時 Combine ,應該仔細考慮,因為它可能非常耗費 CPU 成本。 在大部分情況下, GeometryGroupAddGeometry 會更好。

只有在下列任一項適用時才使用 Combine

  • 幾何運算不是等位。

  • 其中一個幾何都有 一個 FillRuleEvenOdd ,而幾何是自我交集 (,也就是 FillRule 實際) 很重要。

  • 時間並不相關,但如果建立幾何一次,然後快取) ,則空間會 (。 通常會產生 CombineAddGeometry 較小的輸出。

  • 產生的幾何將會在路徑動畫中筆劃或使用,而且 AddGeometry 不提供所需的外框。

適用於

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

使用指定的 GeometryCombineMode 和容錯因數結合兩個幾何,然後將指定的轉換套用至產生的幾何。

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

參數

geometry1
Geometry

要結合的第一個幾何。

geometry2
Geometry

要結合的第二個幾何。

mode
GeometryCombineMode

其中一個列舉值,指定幾何的結合方式。

transform
Transform

要套用至結合後之幾何的轉換,或為 null

tolerance
Double

在幾何多邊形近似法中,點之間的距離上限。 值越小,產生的結果越精確,但執行過程也會比較慢。 如果 tolerance 小於 .000001,則會改用 .000001。

type
ToleranceType

其中一個 ToleranceType 值,這個值會指定容錯因數為絕對值或相對於幾何區域的值。

傳回

結合後的幾何。

備註

某些 Geometry 方法 (例如 Combine) 產生或使用幾何的多邊形近似值。 容錯因數會指定此多邊形近似值中點之間的最大距離。 較小的容錯值會產生較佳的近似值,但需要比具有大型容錯因數的近似值更多的處理。

使用 來執行等位時 Combine ,應該仔細考慮,因為它可能非常耗費 CPU 成本。 在大部分情況下, GeometryGroupAddGeometry 會更好。

只有在下列任一項適用時才使用 Combine

  • 幾何運算不是等位。

  • 其中一個幾何都有 一個 FillRuleEvenOdd ,而幾何是自我交集 (,也就是 FillRule 實際) 很重要。

  • 時間並不相關,但如果建立幾何一次,然後快取) ,則空間會 (。 通常會產生 CombineAddGeometry 較小的輸出。

  • 產生的幾何將會在路徑動畫中筆劃或使用,而且 AddGeometry 不提供所需的外框。

適用於