IDWriteTextAnalyzer ::GetGlyphPlacements, méthode (dwrite.h)

Places sortie des glyphes de la méthode GetGlyphes en fonction de la police et des règles de rendu du système d’écriture.

Syntaxe

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
);

Paramètres

[in] textString

Type : const WCHAR*

Tableau de caractères contenant la chaîne d’origine d’où proviennent les glyphes.

[in] clusterMap

Type : const UINT16*

Pointeur vers le mappage des plages de caractères aux plages de glyphes. Cette valeur est retournée par GetGlyphes.

[in] textProps

Type : DWRITE_SHAPING_TEXT_PROPERTIES*

Pointeur vers un tableau de structures qui contient des propriétés de mise en forme pour chaque caractère. Cette structure est retournée par GetGlyphes.

textLength

Type : UINT32

Longueur de texte de textString.

[in] glyphIndices

Type : const UINT16*

Tableau d’index de glyphes retournés par GetGlyphes.

[in] glyphProps

Type : const DWRITE_SHAPING_GLYPH_PROPERTIES*

Pointeur vers un tableau de structures qui contiennent des propriétés de mise en forme pour chaque glyphe retourné par GetGlyphes.

glyphCount

Type : UINT32

Nombre de glyphes retournés par GetGlyphes.

fontFace

Type : IDWriteFontFace*

Pointeur vers la face de police qui est la source des glyphes de sortie.

fontEmSize

Type : FLOAT

Taille de police logique dans les DIPs.

isSideways

Type : BOOL

Indicateur booléen défini sur TRUE si le texte est destiné à être dessiné verticalement.

isRightToLeft

Type : BOOL

Indicateur booléen défini sur TRUE pour le texte de droite à gauche.

[in] scriptAnalysis

Type : const DWRITE_SCRIPT_ANALYSIS*

Pointeur vers un résultat d’analyse de script à partir d’un appel AnalyzeScript .

[in, optional] localeName

Type : const WCHAR*

Tableau de caractères contenant les paramètres régionaux à utiliser lors de la sélection de glyphes. Par exemple, le même caractère peut être mappé à différents glyphes pour ja-jp et zh-chs. Si cette valeur est NULL, le mappage par défaut basé sur le script est utilisé.

[in, optional] features

Type : const DWRITE_TYPOGRAPHIC_FEATURES**

Tableau de pointeurs vers les ensembles de caractéristiques typographiques à utiliser dans chaque plage de caractéristiques.

[in, optional] featureRangeLengths

Type : const UINT32*

Longueur de chaque plage de caractéristiques, en caractères.
La somme de toutes les longueurs doit être égale à textLength.

featureRanges

Type : UINT32

Nombre de plages de fonctionnalités.

[out] glyphAdvances

Type : FLOAT*

Lorsque cette méthode est retournée, contient la largeur avancée de chaque glyphe.

[out] glyphOffsets

Type : DWRITE_GLYPH_OFFSET*

Lorsque cette méthode est retournée, contient le décalage de l’origine de chaque glyphe.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Voir aussi

IDWriteTextAnalyzer