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

  • 几何运算不是联合。

  • 其中任一 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 成本可能非常高。 在大多数情况下, GeometryGroupAddGeometry 将效果更好。

仅在以下任一项适用时使用 Combine

  • 几何运算不是联合。

  • 其中任一 FillRule 几何图形的值为 EvenOdd ,并且几何图形是自相交 (即 FillRule) 真正重要的几何图形。

  • 时间不是问题,但空间 (,例如,如果几何图形创建一次,然后缓存) 。 通常, Combine 生成的输出比 AddGeometry更小。

  • 生成的几何图形将在路径动画中划线或使用,并且 AddGeometry 不提供所需的轮廓。

适用于