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

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

IDWriteTextAnalyzer