CDC::GetGlyphOutline

Статья
02/20/2013

Извлекает кривая или растровое изображение символа структуры для структуры в текущем шрифте.

DWORD GetGlyphOutline(
   UINT nChar,
   UINT nFormat,
   LPGLYPHMETRICS lpgm,
   DWORD cbBuffer,
   LPVOID lpBuffer,
   const MAT2* lpmat2
) const;

Параметры

nChar
Указывает кодировку, для которого необходимо вернуть сведения.

nFormat
Указывает формат, в котором возвращаются сведения. функцияОна может быть одним из следующих значений или 0.

Значение	Значение
GGO_BITMAP	Возвращает растровое изображение глифа.Когда функция возвращает буфер указанный в lpBuffer содержащий растровое изображение бит-в- 1 пикселя строки, начинающиеся в диапазоне doubleword.
GGO_NATIVE	Возвращает точки кривой данных в собственном формате rasterizer, используя единиц устройства.Если это значение задано, любое преобразование, указанное в lpmat2 игнорирован.

Если значение равно 0, функция nFormat заполняет структуру GLYPHMETRICS но не возвращает данные глиф- структуры.

lpgm
Указатель на структуру GLYPHMETRICS, которая описывает размещение глифов символа в ячейке.
cbBuffer
Определяет размер буфера, в котором функция копирует сведения о символе структуры.Если это значение равно 0, а параметр nFormat или значения GGO_BITMAP или GGO_NATIVE, то функция возвращает необходимый размер буфера.
lpBuffer
Указатель на буфер, в который функция копирует сведения о символе структуры.Если nFormat задает значение GGO_NATIVE, то сведения копируется в форме TTPOLYGONHEADER и структур TTPOLYCURVE.Если это значение NULL и nFormat или GGO_BITMAP или значение GGO_NATIVE, то функция возвращает необходимый размер буфера.
lpmat2
Указывает на MAT2 составляющие, содержащий матрицу преобразования символов.Этот параметр не может быть NULL, даже если значение GGO_NATIVE указано для nFormat.

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

Размер (в байтах) буфера, необходимый для восстановленного сведения, если cbBuffer 0 или lpBufferNULL.В противном случае - положительное значение, если функция завершается успешно или – 1, если ошибка.

Заметки

Приложение может выполнять циклический сдвиг извлекаемых символов в формате растрового изображения путем указания матрицу преобразования 2 by-2 в структуре указанной в lpmat2.

Структура возвращается как последовательность глифов, контуров.Каждый контур задан структурой TTPOLYGONHEADER выполните любое количество структур TTPOLYCURVE, как запросить, чтобы описать ее.Все элементы возвращаются в виде структуры POINTFX и представляют абсолютное позиционирование, относительные перемещения.Начальная точка, заданного участника pfxStart структуры TTPOLYGONHEADER точку, в которой макет для контура.Структуры TTPOLYCURVE, могут быть или записями в виде ломаной линии или записями сплайна.Записи Polyline ряд точек; линии между точками, нарисованными описывают структуру символов.Записи сплайна представляют квадратические кривые, используемые TrueType (то есть квадратическими B- сплайнами).