Метод ID2D1DeviceContext4::GetColorBitmapGlyphImage (d2d1_3.h)
Извлекает изображение цветного битового глифа из кэша цветового глифа. Если кэш еще не содержит запрошенный ресурс, он будет создан. Этот метод можно использовать для продления времени существования изображения глифа даже после его исключения из кэша цветных глифов.
Синтаксис
HRESULT GetColorBitmapGlyphImage(
DWRITE_GLYPH_IMAGE_FORMATS glyphImageFormat,
D2D1_POINT_2F glyphOrigin,
[in] IDWriteFontFace *fontFace,
FLOAT fontEmSize,
UINT16 glyphIndex,
BOOL isSideways,
[in, optional] const D2D1_MATRIX_3X2_F *worldTransform,
FLOAT dpiX,
FLOAT dpiY,
[out] D2D1_MATRIX_3X2_F *glyphTransform,
[out] ID2D1Image **glyphImage
);
Параметры
glyphImageFormat
Тип: DWRITE_GLYPH_IMAGE_FORMATS
Формат изображения глифа. Если для запрошенного глифа нет данных изображения в запрошенном формате, этот метод возвращает ошибку.
glyphOrigin
Тип: D2D1_POINT_2F
Источник глифа.
[in] fontFace
Тип: IDWriteFontFace*
Ссылка на лицо шрифта, которая содержит тип шрифта, соответствующие ссылки на файлы, данные идентификации лица и различные данные шрифта, такие как метрики, имена и контуры глифов.
fontEmSize
Тип: FLOAT
Указанный размер шрифта влияет на выбор растрового изображения, используемого из шрифта. Он также влияет на выходные данные глифаTransform, что приводит к правильному масштабированию глифа.
glyphIndex
Тип: UINT16
Индекс глифа.
isSideways
Тип: BOOL
Значение true указывает, что глифы поворачиваются на 90 градусов влево и используются вертикальные метрики. Вертикальное написание достигается путем указания isSideways как true и поворота всего выполнения на 90 градусов вправо с помощью преобразования поворота.
[in, optional] worldTransform
Тип: const D2D1_MATRIX_3X2_F*
Преобразование, применяемого к изображению. Это преобразование входных данных влияет на выбор растрового изображения, используемого из шрифта. Он также учитывается в выходных данных glyphTransform.
dpiX
Тип: FLOAT
Точки на дюйм вдоль оси X.
dpiY
Тип: FLOAT
Точки на дюйм вдоль оси Y.
[out] glyphTransform
Тип: D2D1_MATRIX_3X2_F*
Выходное преобразование, которое преобразует пространство глифа в то же выходное пространство, что и worldTransform. Сюда входит входной глифOrigin, смещение глифа от глифаOrigin и любые другие необходимые преобразования.
[out] glyphImage
Тип: ID2D1Image**
По завершении содержит полученное изображение глифа.
Возвращаемое значение
Тип: HRESULT
Этот метод возвращает код ошибки или успешного выполнения HRESULT.
Требования
| Целевая платформа | Windows |
| Header | d2d1_3.h |
| DLL | D2d1.dll |