Geometry.Combine Метод

Определение

Объединяет два объекта Geometry.Combines two Geometry objects.

Перегрузки

Combine(Geometry, Geometry, GeometryCombineMode, Transform)

Комбинирует две геометрии с использованием заданного GeometryCombineMode и применяет к результирующей геометрии заданное преобразование.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 и коэффициента допуска и применяет к результирующей геометрии заданное преобразование.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 и применяет к результирующей геометрии заданное преобразование.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

Вторая геометрия для комбинирования.The second geometry to combine.

mode
GeometryCombineMode

Одно из значений из перечисления, задающее способ комбинирования геометрий.One of the enumeration values that specifies how the geometries are combined.

transform
Transform

Преобразование, применяемое к комбинированной геометрии, или null.A 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 для выполнения объединения, так как это может быть очень дорогостоящим процессором.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).

  • Время не имеет значение, но пространство (например, если геометрия создается один раз, а затем кэшируется).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 и коэффициента допуска и применяет к результирующей геометрии заданное преобразование.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

Вторая геометрия для комбинирования.The second geometry to combine.

mode
GeometryCombineMode

Одно из значений из перечисления, задающее способ комбинирования геометрий.One of the enumeration values that specifies how the geometries are combined.

transform
Transform

Преобразование, применяемое к комбинированной геометрии, или null.A 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, с помощью которого можно определить, является ли коэффициент допуска абсолютным значением или же он измеряется относительно области геометрии.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 для выполнения объединения, так как это может быть очень дорогостоящим процессором.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).

  • Время не имеет значение, но пространство (например, если геометрия создается один раз, а затем кэшируется).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.

Применяется к