Geometry.Combine Метод

Определение

Пространство имен:
System.Windows.Media
Сборка:
PresentationCore.dll

Объединяет два 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.

Возвращаемое значение

PathGeometry

Объединенная геометрия.

Комментарии

Этот метод использует коэффициент допуска по умолчанию (описано свойством StandardFlatteningTolerance ) при объединении геометрий. Чтобы указать собственный фактор терпимости, используйте Combine этот метод.

Некоторые Geometry методы (например Combine) создают или используют многоугольник геометрии. Коэффициент допуска указывает максимальное расстояние между точками в этом приближении многоугольника. Меньшие значения допустимости создают лучшие приближения, но требуют больше обработки, чем приближение с большим коэффициентом допуска.

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

Возвращаемое значение

PathGeometry

Объединенная геометрия.

Комментарии

Некоторые Geometry методы (например Combine) создают или используют многоугольник геометрии. Коэффициент допуска указывает максимальное расстояние между точками в этом приближении многоугольника. Меньшие значения допустимости создают лучшие приближения, но требуют больше обработки, чем приближение с большим коэффициентом допуска.

Тщательное мышление должно быть вовлечено при использовании Combine для выполнения объединения, так как это может быть очень дорогим ЦП. В большинстве случаев или GeometryGroupAddGeometry будет работать лучше.

Используйте Combine только в том случае, если применяется любой из следующих вариантов:

  • Геометрическая операция не является объединением.

  • Любой из геометрий имеет FillRule значение EvenOdd , и геометрии являются самопересекающимися (т. е. FillRule фактически важными).

  • Время не является проблемой, но пространство (например, если геометрия создается один раз, а затем кэшируется). Как правило, Combine производит меньше выходных данных, чем AddGeometry.

  • Результирующая геометрия будет обрисована или используется в анимации пути и AddGeometry не предоставляет нужную структуру.

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