Функция PolyBezier (wingdi.h)

Статья
08/15/2024

Функция PolyBezier рисует одну или несколько кривых Bézier.

Синтаксис

BOOL PolyBezier(
  [in] HDC         hdc,
  [in] const POINT *apt,
  [in] DWORD       cpt
);

Параметры

[in] hdc

Дескриптор контекста устройства.

[in] apt

Указатель на массив структур POINT, содержащих конечные точки и контрольные точки кривых в логических единицах.

[in] cpt

Количество точек в массиве lppt. Это значение должно быть более чем в три раза больше, чем число кривых для рисования, так как каждая кривая Bézier требует двух контрольных точек и конечной точки, а начальная кривая требует дополнительной начальной точки.

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

Если функция выполнена успешно, возвращаемое значение ненулевое.

Если функция завершается ошибкой, возвращаемое значение равно нулю.

Замечания

Функция PolyBezier рисует кубическую кривую Bézier с помощью конечных точек и контрольных точек, указанных параметром lppt. Первая кривая извлекается из первой точки в четвертую точку с помощью второй и третьей точек в качестве контрольных точек. Каждая последующая кривая в последовательности нуждается ровно в три дополнительных пункта: конечная точка предыдущей кривой используется в качестве начальной точки, следующие две точки в последовательности являются контрольным точками, а третья — конечной точкой.

Текущая позиция не используется и не обновляется функцией PolyBezier. Рисунок не заполнен.

Эта функция рисует линии с помощью текущего пера.

Примеры

Пример см. в разделе перерасписи в регионе обновления.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wingdi.h (включая Windows.h)
библиотеки	Gdi32.lib
DLL	Gdi32.dll