Geometry.Combine メソッド

  • リファレンス

定義

名前空間:
System.Windows.Media
アセンブリ:
PresentationCore.dll

2 つの Geometry オブジェクトを結合します。

オーバーロード

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

指定した GeometryCombineMode を使用して 2 つのジオメトリを結合し、結果のジオメトリに指定した変換を適用します。
Combine(Geometry, Geometry, GeometryCombineMode, Transform, Double, ToleranceType)

指定した GeometryCombineMode と許容範囲の要素を使用して 2 つのジオメトリを結合し、結果のジオメトリに指定した変換を適用します。

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

指定した GeometryCombineMode を使用して 2 つのジオメトリを結合し、結果のジオメトリに指定した変換を適用します。

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

2 番目に結合するジオメトリ。

mode
GeometryCombineMode

ジオメトリを結合する方法を指定する列挙値の 1 つ。

transform
Transform

結合したジオメトリに適用する変換。それ以外の場合は null。

戻り値

PathGeometry

結合したジオメトリ。

注釈

このメソッドは、ジオメトリを組み合わせるときに既定の StandardFlatteningTolerance 許容係数 (プロパティで記述) を使用します。 独自の許容係数を指定するには、 メソッドを使用します Combine 。

一部 Geometry のメソッド (など Combine) では、ジオメトリの多角形近似を生成または使用します。 許容係数は、この多角形近似のポイント間の最大距離を指定します。 許容値が小さいほど近似値は優れていますが、許容係数が大きい近似よりも多くの処理が必要です。

を使用 Combine して共用体を実行する場合は、CPU コストが非常に高くなる可能性があるため、慎重に考える必要があります。 ほとんどの場合、 GeometryGroup または AddGeometry の方がうまく機能します。

次のいずれかが適用される場合にのみ使用 Combine します。

  • 幾何学的な演算は和集合ではありません。

  • いずれかのジオメトリの値は FillRule であり EvenOdd 、ジオメトリは自己交差しています (つまり FillRule 、実際には重要です)。

  • 時間は問題ではありませんが、スペースは (たとえば、ジオメトリが 1 回作成されてからキャッシュされる場合) です。 通常、 Combine は より AddGeometry小さい出力を生成します。

  • 結果として得られるジオメトリは、パス アニメーションでストロークまたは使用され、 AddGeometry 目的のアウトラインは提供されません。

適用対象

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

指定した GeometryCombineMode と許容範囲の要素を使用して 2 つのジオメトリを結合し、結果のジオメトリに指定した変換を適用します。

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

2 番目に結合するジオメトリ。

mode
GeometryCombineMode

ジオメトリを結合する方法を指定する列挙値の 1 つ。

transform
Transform

結合したジオメトリに適用する変換。それ以外の場合は null。

tolerance
Double

ジオメトリの多角形近似における点と点の間の距離の上限。 値が小さいほど、生成される結果の精度は高まりますが、実行速度が低下します。 tolerance が .000001 より小さい場合、.000001 が代わりに使用されます。

type
ToleranceType

許容範囲の要素が絶対値か、またはこのジオメトリの領域に対して相対的かを指定する、ToleranceType 値の 1 つ。

戻り値

PathGeometry

結合したジオメトリ。

注釈

一部 Geometry のメソッド (など Combine) では、ジオメトリの多角形近似を生成または使用します。 許容係数は、この多角形近似のポイント間の最大距離を指定します。 許容値が小さいほど近似値は優れていますが、許容係数が大きい近似よりも多くの処理が必要です。

を使用 Combine して共用体を実行する場合は、CPU コストが非常に高くなる可能性があるため、慎重に考える必要があります。 ほとんどの場合、 GeometryGroup または AddGeometry の方がうまく機能します。

次のいずれかが適用される場合にのみ使用 Combine します。

  • 幾何学的な演算は和集合ではありません。

  • いずれかのジオメトリの値は FillRule であり EvenOdd 、ジオメトリは自己交差しています (つまり FillRule 、実際には重要です)。

  • 時間は問題ではありませんが、スペースは (たとえば、ジオメトリが 1 回作成されてからキャッシュされる場合) です。 通常、 Combine は より AddGeometry小さい出力を生成します。

  • 結果として得られるジオメトリは、パス アニメーションでストロークまたは使用され、 AddGeometry 目的のアウトラインは提供されません。

適用対象