Метод IDWriteFontFace::GetGdiCompatibleGlyphMetrics (dwrite.h)

Статья
08/23/2023

Получает метрики глифов в единицах разработки шрифта с возвращаемыми значениями, совместимыми с тем, что будет создавать GDI.

Синтаксис

HRESULT GetGdiCompatibleGlyphMetrics(
                 FLOAT                emSize,
                 FLOAT                pixelsPerDip,
  [in, optional] DWRITE_MATRIX const  *transform,
                 BOOL                 useGdiNatural,
  [in]           UINT16 const         *glyphIndices,
                 UINT32               glyphCount,
  [out]          DWRITE_GLYPH_METRICS *glyphMetrics,
                 BOOL                 isSideways
);

Параметры

emSize

Тип: FLOAT

Логический размер шрифта в единицах DIP.

pixelsPerDip

Тип: FLOAT

Количество физических пикселей на DIP.

[in, optional] transform

Тип: const DWRITE_MATRIX*

Необязательное преобразование, примененное к глифам и их позициям. Это преобразование применяется после масштабирования, заданного размером шрифта и пикселямиPerDip.

useGdiNatural

Тип: BOOL

Если задано значение FALSE, метрики совпадают с метриками текста с псевдонимом GDI. Если задано значение TRUE, метрики совпадают с метриками текста, измеряемыми GDI с помощью шрифта, созданного с помощью CLEARTYPE_NATURAL_QUALITY.

[in] glyphIndices

Тип: const UINT16*

Массив индексов глифов, для которых необходимо вычислить метрики.

glyphCount

Тип: UINT32

Количество элементов в массиве glyphIndices .

[out] glyphMetrics

Тип: DWRITE_GLYPH_METRICS*

Массив DWRITE_GLYPH_METRICS структур, заполненных этой функцией. Метрики находятся в единицах разработки шрифтов.

isSideways

Тип: BOOL

Значение BOOL, указывающее, используется ли шрифт при боковом выполнении. Это может повлиять на метрики глифов, если шрифт имеет симуляцию наклона, так как симуляция наклона в сторону отличается от симуляции, не являющейся косой.

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

Тип: HRESULT

Стандартный код ошибки HRESULT . Если какой-либо из входных индексов глифа выходит за пределы допустимого диапазона индекса глифа для текущего шрифта, возвращается E_INVALIDARG .

Требования


Целевая платформа	Windows
Header	dwrite.h
Библиотека	Dwrite.lib
DLL	Dwrite.dll

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

IDWriteFontFace

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