Geometry.Combine 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
結合兩個 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 成本。 在大部分情況下, GeometryGroup 或 AddGeometry 會更好。
只有在下列任一項適用時才使用 Combine :
幾何運算不是等位。
其中一個幾何都有 一個 FillRule 值 EvenOdd ,而幾何是自我交集 (,也就是 FillRule 實際) 很重要。
時間並不相關,但如果建立幾何一次,然後快取) ,則空間會 (。 通常會產生 Combine 比 AddGeometry 較小的輸出。
產生的幾何將會在路徑動畫中筆劃或使用,而且 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 成本。 在大部分情況下, GeometryGroup 或 AddGeometry 會更好。
只有在下列任一項適用時才使用 Combine :
幾何運算不是等位。
其中一個幾何都有 一個 FillRule 值 EvenOdd ,而幾何是自我交集 (,也就是 FillRule 實際) 很重要。
時間並不相關,但如果建立幾何一次,然後快取) ,則空間會 (。 通常會產生 Combine 比 AddGeometry 較小的輸出。
產生的幾何將會在路徑動畫中筆劃或使用,而且 AddGeometry 不提供所需的外框。