Поделиться через

Метод ID2D1Geometry::Outline(constD2D1_MATRIX_3X2_F*,FLOAT,ID2D1SimplifiedGeometrySink*) (d2d1.h)

  • Статья

Вычисляет контур геометрии и записывает результат в id2D1SimplifiedGeometrySink.

Синтаксис

HRESULT Outline(
  [in, optional] const D2D1_MATRIX_3X2_F     *worldTransform,
                 FLOAT                       flatteningTolerance,
  [in]           ID2D1SimplifiedGeometrySink *geometrySink
);

Параметры

[in, optional] worldTransform

Тип: const D2D1_MATRIX_3X2_F*

Преобразование, применяемого к структуре геометрии, или NULL.

flatteningTolerance

Тип: FLOAT

Максимальная погрешность, допускаемая при построении многоугольной аппроксимации геометрии. Ни один из точек в многоугольном представлении не будет отличаться от исходной геометрии на большее, чем погрешность выравнивания. Чем меньше значения, тем точнее результаты и медленнее производится выполнение.

[in] geometrySink

Тип: ID2D1SimplifiedGeometrySink*

Идентификатор ID2D1SimplifiedGeometrySink, к которому добавляется преобразованная структура геометрии.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Метод Outline позволяет вызывающей объекту создать геометрию с эквивалентной заливкой входной геометрии со следующими дополнительными свойствами:

  • Выходная геометрия не содержит поперечных пересечений; то есть сегменты могут касаться, но они никогда не пересекаются.
  • Внешние фигуры в выходной геометрии ориентированы против часовой стрелки.
  • Выходная геометрия является инвариантной в режиме заполнения; то есть заливка геометрии не зависит от выбора режима заливки.

    Дополнительные сведения о режиме заполнения см . в разделе D2D1_FILL_MODE.

Кроме того, метод Outline может быть полезен при удалении избыточных частей указанных геометрических объектов, чтобы упростить сложные геометрические объекты. Он также может быть полезен в сочетании с ID2D1GeometryGroup для создания объединений между несколькими геометрическими объектами одновременно.

Требования

   
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header d2d1.h
Библиотека D2d1.lib
DLL D2d1.dll

См. также раздел

ID2D1Geometry