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*

应用于字形及其位置的可选转换。 此转换在字体大小和 pixelPerDip 指定的缩放之后应用。

useGdiNatural

类型： BOOL

设置为 FALSE 时，指标与 GDI 别名文本的指标相同。 设置为 TRUE 时，指标与使用 CLEARTYPE_NATURAL_QUALITY 创建的字体由 GDI 测量的文本的指标相同。

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
标头	dwrite.h
Library	Dwrite.lib
DLL	Dwrite.dll

另请参阅

IDWriteTextAnalyzer