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


CDC::GetGlyphOutline

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

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- сплайнами).

Требования

Header: afxwin.h

См. также

Ссылки

Класс CDC

Диаграмма иерархии

CDC::GetOutlineTextMetrics

GetGlyphOutline

GLYPHMETRICS

TTPOLYGONHEADER

TTPOLYCURVE