Geometry.Combine メソッド

定義

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

オーバーロード

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

指定した GeometryCombineMode を使用して 2 つのジオメトリを結合し、結果のジオメトリに指定した変換を適用します。Combines the two geometries using the specified GeometryCombineMode and applies the specified transform to the resulting geometry.

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

指定した GeometryCombineMode と許容範囲の要素を使用して 2 つのジオメトリを結合し、結果のジオメトリに指定した変換を適用します。Combines the two geometries using the specified GeometryCombineMode and tolerance factor, and applies the specified transform to the resulting geometry.

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

指定した GeometryCombineMode を使用して 2 つのジオメトリを結合し、結果のジオメトリに指定した変換を適用します。Combines the two geometries using the specified GeometryCombineMode and applies the specified transform to the resulting geometry.

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

パラメーター

geometry1
Geometry

最初に結合するジオメトリ。The first geometry to combine.

geometry2
Geometry

2 番目に結合するジオメトリ。The second geometry to combine.

mode
GeometryCombineMode

ジオメトリを結合する方法を指定する列挙値の 1 つ。One of the enumeration values that specifies how the geometries are combined.

transform
Transform

結合したジオメトリに適用する変換。それ以外の場合は nullA transformation to apply to the combined geometry, or null.

戻り値

結合したジオメトリ。The combined geometry.

注釈

このメソッドは、ジオメトリを結合するときに、 StandardFlatteningTolerance既定の許容範囲 (プロパティで表される) を使用します。This method uses the default tolerance factor (described by the StandardFlatteningTolerance property) when combining geometries. 独自の許容範囲を指定するにはCombine 、メソッドを使用します。To specify your own tolerance factor, use the Combine method.

一部Geometryのメソッド ( Combineなど) は、ジオメトリの多角形近似を生成または使用します。Some Geometry methods (such as Combine) produce or use a polygonal approximation of the geometry. 許容要素は、この多角形近似の点の間の最大距離を指定します。The tolerance factor specifies the maximum distance between points in this polygonal approximation. 許容範囲の値を小さくすると、近似が向上しますが、大きな許容範囲を持つ近似よりも多くの処理が必要になります。Smaller tolerance values produce better approximations, but require more processing than an approximation with a large tolerance factor.

を使用してCombine共用体を実行する場合は、CPU コストが非常に高くなる可能性があるため、慎重に検討する必要があります。Careful thought should be involved when using Combine to perform a union as it can be very CPU-expensive. ほとんどの場合、 GeometryGroupまたはAddGeometryはより適切に動作します。In most cases, a GeometryGroup or AddGeometry will work better.

Combineのいずれかに該当する場合にのみ使用します。Use Combine only when any of the following apply:

  • ジオメトリック演算が共用体ではありません。The geometric operation is not a union.

  • ジオメトリのいずれかのFillRule EvenOdd値がであり、ジオメトリは自己交差しています ( FillRuleつまり、実際には問題になります)。Either of the geometries has a FillRule value of EvenOdd and the geometries are self-intersecting (i.e. the FillRule actually matters).

  • 時間は問題ではありませんが、space は (たとえば、ジオメトリが一度作成されてからキャッシュされた場合)、領域があります。Time is not a concern, but space is (for instance, if the geometry is created once and then cached). 通常、 CombineではよりもAddGeometry小さい出力が生成されます。Typically, Combine produces smaller output than AddGeometry.

  • 結果とAddGeometryして得られるジオメトリは、パスアニメーションで線が表示されるか、または使用されますが、目的のアウトラインは提供されません。The resulting geometry will be stroked or used in a path animation and AddGeometry does not provide the desired outline.

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

指定した GeometryCombineMode と許容範囲の要素を使用して 2 つのジオメトリを結合し、結果のジオメトリに指定した変換を適用します。Combines the two geometries using the specified GeometryCombineMode and tolerance factor, and applies the specified transform to the resulting geometry.

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

パラメーター

geometry1
Geometry

最初に結合するジオメトリ。The first geometry to combine.

geometry2
Geometry

2 番目に結合するジオメトリ。The second geometry to combine.

mode
GeometryCombineMode

ジオメトリを結合する方法を指定する列挙値の 1 つ。One of the enumeration values that specifies how the geometries are combined.

transform
Transform

結合したジオメトリに適用する変換。それ以外の場合は nullA transformation to apply to the combined geometry, or null.

tolerance
Double

ジオメトリの多角形近似における点と点の間の距離の上限。The maximum bounds on the distance between points in the polygonal approximation of the geometries. 値が小さいほど、生成される結果の精度は高まりますが、実行速度が低下します。Smaller values produce more accurate results but cause slower execution. tolerance が .000001 より小さい場合、.000001 が代わりに使用されます。If tolerance is less than .000001, .000001 is used instead.

type
ToleranceType

許容範囲の要素が絶対値か、またはこのジオメトリの領域に対して相対的かを指定する、ToleranceType 値の 1 つ。One of the ToleranceType values that specifies whether the tolerance factor is an absolute value or relative to the area of the geometry.

戻り値

結合したジオメトリ。The combined geometry.

注釈

一部Geometryのメソッド ( Combineなど) は、ジオメトリの多角形近似を生成または使用します。Some Geometry methods (such as Combine) produce or use a polygonal approximation of the geometry. 許容要素は、この多角形近似の点の間の最大距離を指定します。The tolerance factor specifies the maximum distance between points in this polygonal approximation. 許容範囲の値を小さくすると、近似が向上しますが、大きな許容範囲を持つ近似よりも多くの処理が必要になります。Smaller tolerance values produce better approximations, but require more processing than an approximation with a large tolerance factor.

を使用してCombine共用体を実行する場合は、CPU コストが非常に高くなる可能性があるため、慎重に検討する必要があります。Careful thought should be involved when using Combine to perform a union as it can be very CPU-expensive. ほとんどの場合、 GeometryGroupまたはAddGeometryはより適切に動作します。In most cases, a GeometryGroup or AddGeometry will work better.

Combineのいずれかに該当する場合にのみ使用します。Use Combine only when any of the following apply:

  • ジオメトリック演算が共用体ではありません。The geometric operation is not a union.

  • ジオメトリのいずれかのFillRule EvenOdd値がであり、ジオメトリは自己交差しています ( FillRuleつまり、実際には問題になります)。Either of the geometries has a FillRule value of EvenOdd and the geometries are self-intersecting (i.e. the FillRule actually matters).

  • 時間は問題ではありませんが、space は (たとえば、ジオメトリが一度作成されてからキャッシュされた場合)、領域があります。Time is not a concern, but space is (for instance, if the geometry is created once and then cached). 通常、 CombineではよりもAddGeometry小さい出力が生成されます。Typically, Combine produces smaller output than AddGeometry.

  • 結果とAddGeometryして得られるジオメトリは、パスアニメーションで線が表示されるか、または使用されますが、目的のアウトラインは提供されません。The resulting geometry will be stroked or used in a path animation and AddGeometry does not provide the desired outline.

適用対象