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 不提供所需的轮廓。