Метод IDWriteTextAnalyzer::GetGdiCompatibleGlyphPlacements (dwrite.h)
Разместите выходные данные глифов из метода GetGlyphs в соответствии с шрифтом и правилами отрисовки системы записи.
Синтаксис
HRESULT GetGdiCompatibleGlyphPlacements(
[in] WCHAR const *textString,
[in] UINT16 const *clusterMap,
[in] DWRITE_SHAPING_TEXT_PROPERTIES *textProps,
UINT32 textLength,
[in] UINT16 const *glyphIndices,
[in] DWRITE_SHAPING_GLYPH_PROPERTIES const *glyphProps,
UINT32 glyphCount,
[in] IDWriteFontFace *fontFace,
FLOAT fontEmSize,
FLOAT pixelsPerDip,
[in, optional] DWRITE_MATRIX const *transform,
BOOL useGdiNatural,
BOOL isSideways,
BOOL isRightToLeft,
[in] DWRITE_SCRIPT_ANALYSIS const *scriptAnalysis,
[in, optional] WCHAR const *localeName,
[in, optional] DWRITE_TYPOGRAPHIC_FEATURES const **features,
[in, optional] UINT32 const *featureRangeLengths,
UINT32 featureRanges,
[out] FLOAT *glyphAdvances,
[out] DWRITE_GLYPH_OFFSET *glyphOffsets
);
Параметры
[in] textString
Тип: const WCHAR*
Массив символов, содержащий исходную строку, из которой пришли глифы.
[in] clusterMap
Тип: const UINT16*
Указатель на сопоставление диапазонов символов с диапазонами глифов. Возвращается методом GetGlyphs.
[in] textProps
Тип: DWRITE_SHAPING_TEXT_PROPERTIES*
Указатель на массив структур, содержащий свойства формирования для каждого символа. Эта структура возвращается GetGlyphs.
textLength
Тип: UINT32
Длина текста textString.
[in] glyphIndices
Тип: const UINT16*
Массив индексов глифов, возвращаемых GetGlyphs.
[in] glyphProps
Тип: const DWRITE_SHAPING_GLYPH_PROPERTIES*
Указатель на массив структур, содержащих свойства формирования для каждого глифа, возвращаемого GetGlyphs.
glyphCount
Тип: UINT32
Количество глифов, возвращенных getGlyphs.
[in] fontFace
Тип: IDWriteFontFace*
Указатель на лицевую сторону шрифта, которая является источником выходных глифов.
fontEmSize
Тип: FLOAT
Размер логического шрифта в DIP.
pixelsPerDip
Тип: FLOAT
Количество физических пикселей на DIP.
[in, optional] transform
Тип: const DWRITE_MATRIX*
Необязательное преобразование, применяемое к глифам и их позициям. Это преобразование применяется после масштабирования, заданного размером шрифта и пикселямиPerDip.
useGdiNatural
Тип: BOOL
Если задано значение FALSE, метрики совпадают с метриками текста с псевдонимом GDI. Если задано значение TRUE, метрики совпадают с метриками текста, измеряемыми GDI с помощью шрифта, созданного с помощью CLEARTYPE_NATURAL_QUALITY.
isSideways
Тип: BOOL
Для логического флага задано значение TRUE , если текст предназначен для вертикальной отрисовки.
isRightToLeft
Тип: BOOL
Для текста справа налево логического флага задано значение TRUE .
[in] scriptAnalysis
Тип: const DWRITE_SCRIPT_ANALYSIS*
Указатель на результат анализа скрипта в результате вызоваAnalyzeScript .
[in, optional] localeName
Тип: const WCHAR*
Массив символов, содержащий языковой стандарт, используемый при выборе глифов. Например, один и тот же символ может сопоставляться с разными глифами для ja-jp и zh-chs. Если значение равно NULL, используется сопоставление по умолчанию на основе скрипта.
[in, optional] features
Тип: const DWRITE_TYPOGRAPHIC_FEATURES**
Массив указателей на наборы типографических признаков для использования в каждом диапазоне признаков.
[in, optional] featureRangeLengths
Тип: const UINT32*
Длина каждого диапазона признаков в символах.
Сумма всех длин должна быть равна textLength.
featureRanges
Тип: UINT32
Количество диапазонов признаков.
[out] glyphAdvances
Тип: FLOAT*
При возврате этим методом содержит ширину каждого глифа.
[out] glyphOffsets
Тип: DWRITE_GLYPH_OFFSET*
При возврате этим методом содержит смещение источника каждого глифа.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | dwrite.h |
| Библиотека | Dwrite.lib |
| DLL | Dwrite.dll |