Метод 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

См. также раздел

ID2D1DeviceContext4