Метод IDWriteFontFace4::GetGlyphImageData (dwrite_3.h)

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

Синтаксис

HRESULT GetGlyphImageData(
  [in]  UINT16                     glyphId,
        UINT32                     pixelsPerEm,
        DWRITE_GLYPH_IMAGE_FORMATS glyphImageFormat,
  [out] DWRITE_GLYPH_IMAGE_DATA    *glyphData,
  [out] void                       **glyphDataContext
);

Параметры

[in] glyphId

Тип: UINT16

Идентификатор глифа для получения данных изображения.

pixelsPerEm

Тип: UINT32

Запрошенные пиксели на эм.

glyphImageFormat

Тип: DWRITE_GLYPH_IMAGE_FORMATS

Указывает, какие форматы поддерживаются в шрифте.

[out] glyphData

Тип: DWRITE_GLYPH_IMAGE_DATA*

При возврате содержатся данные для глифа.

[out] glyphDataContext

Тип: void**

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

Тип: HRESULT

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

Замечания

ГлифDataContext должен быть выпущен через ReleaseGlyphImageData , если данные не пустые, аналогичные IDWriteFontFileStream::ReadFileFragment и IDWriteFontFileStream::ReleaseFileFragment. Указатель данных действителен до тех пор, пока idWriteFontFace существует и ReleaseGlyphImageData не был вызван.

Значение DWRITE_GLYPH_IMAGE_DATA::uniqueDataId ценно для кэширования, чтобы, если один ресурс возвращался несколько раз, существующий ресурс можно быстро извлечь, а не использовать для повторного анализа или распаковки данных.

Функция возвращает только данные SVG или растровых данных. Запрос данных TrueType/CFF/COLR возвращает DWRITE_E_INVALIDARG. Они должны быть нарисованы с помощью DrawGlyphRun или запрашиваются с помощью GetGlyphOutline. Точно один формат может быть запрошен или функция возвращает DWRITE_E_INVALIDARG. Если глиф не имеет этого формата, вызов не является ошибкой, но функция возвращает пустые данные.

Требования

См. также

IDWriteFontFace4