Метод ID2D1DeviceContext4::GetSvgGlyphImage (d2d1_3.h)

Статья
08/22/2023

Извлекает изображение глифа SVG из кэша цветных глифов. Если кэш еще не содержит запрошенный ресурс, он будет создан. Этот метод можно использовать для продления времени существования изображения глифа даже после его исключения из кэша цветных глифов.

Синтаксис

HRESULT GetSvgGlyphImage(
                 D2D1_POINT_2F           glyphOrigin,
  [in]           IDWriteFontFace         *fontFace,
                 FLOAT                   fontEmSize,
                 UINT16                  glyphIndex,
                 BOOL                    isSideways,
  [in, optional] const D2D1_MATRIX_3X2_F *worldTransform,
  [in, optional] ID2D1Brush              *defaultFillBrush,
  [in, optional] ID2D1SvgGlyphStyle      *svgGlyphStyle,
                 UINT32                  colorPaletteIndex,
  [out]          D2D1_MATRIX_3X2_F       *glyphTransform,
  [out]          ID2D1CommandList        **glyphImage
);

Параметры

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*

Преобразование, применяемого к изображению.

[in, optional] defaultFillBrush

Тип: ID2D1Brush*

Описывает, как закрашивается область.

[in, optional] svgGlyphStyle

Тип: ID2D1SvgGLyphStyle*

Значения для контекстного заполнения, контекстного росчерка и контекстного значения, которые используются при отрисовке глифов SVG.

colorPaletteIndex

Тип: UINT32

Индекс, используемый для выбора цветовой палитры в цветовом шрифте. Обратите внимание, что это не то же самое, что paletteIndex в структуре DWRITE_COLOR_GLYPH_RUN, которая не относится к глифам SVG.

[out] glyphTransform

Тип: D2D1_MATRIX_3X2_F*

Выходное преобразование, которое преобразует пространство глифа в то же выходное пространство, что и worldTransform. Сюда входит входной глифOrigin, смещение глифа от глифаOrigin и любые другие необходимые преобразования.

[out] glyphImage

Тип: ID2D1CommandList**

По завершении содержит полученное изображение глифа.

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

Тип: HRESULT

Этот метод возвращает код ошибки или успешного выполнения HRESULT.

Требования

Требование	Значение
Целевая платформа	Windows
Header	d2d1_3.h
DLL	D2d1.dll

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

ID2D1DeviceContext4