Метод IDWriteTextAnalyzer::GetGlyphPlacements (dwrite.h)

Places выходные данные глифов из метода GetGlyphs в соответствии с шрифтом и правилами отрисовки системы записи.

Синтаксис

HRESULT GetGlyphPlacements(
  [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,
                 IDWriteFontFace                       *fontFace,
                 FLOAT                                 fontEmSize,
                 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.

fontFace

Тип: IDWriteFontFace*

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

fontEmSize

Тип: FLOAT

Размер логического шрифта в DIP.

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 .

Требования

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

IDWriteTextAnalyzer