IDWriteTextAnalyzer :: GetGdiCompatibleGlyphPlacements, méthode

Placez la sortie des glyphes à partir de la méthode GetGlyphs en fonction de la police et des règles de rendu du système d’écriture.

Syntaxe

virtual HRESULT GetGdiCompatibleGlyphPlacements(
  [in]           const WCHAR                           *textString,
  [in]           const UINT16                          *clusterMap,
  [in]                 DWRITE_SHAPING_TEXT_PROPERTIES  *textProps,
                       UINT32                          textLength,
  [in]           const UINT16                          *glyphIndices,
  [in]           const DWRITE_SHAPING_GLYPH_PROPERTIES *glyphProps,
                       UINT32                          glyphCount,
  [in]                 IDWriteFontFace                 *fontFace,
                       FLOAT                           fontEmSize,
                       FLOAT                           pixelsPerDip,
  [in, optional] const DWRITE_MATRIX                   *transform,
                       BOOL                            useGdiNatural,
                       BOOL                             isSideways,
                       BOOL                             isRightToLeft,
  [in]           const DWRITE_SCRIPT_ANALYSIS          * scriptAnalysis,
  [in, optional] const WCHAR                           * localeName,
  [in, optional] const DWRITE_TYPOGRAPHIC_FEATURES     ** features,
  [in, optional] const UINT32                          * featureRangeLengths,
                       UINT32                           featureRanges,
  [out]                FLOAT                           * glyphAdvances,
  [out]                DWRITE_GLYPH_OFFSET             * glyphOffsets
) = 0;

Paramètres

textString [ dans]

Type : const WCHAR *

Tableau de caractères contenant la chaîne d’origine à partir de laquelle les glyphes sont fournis.

ClusterMap [ dans]

Type : const UINT16 *

Pointeur vers le mappage entre les plages de caractères et les plages de glyphes. Elle est retournée par GetGlyphs.

textProps [ dans]

Type : DWRITE _ _ _ Propriétés du texte de mise en forme*

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 GetGlyphs.

textLength

Type : UInt32

Longueur du texte de textString.

GlyphIndices [ dans]

Type : const UINT16 *

Tableau d’index de glyphe retournés par GetGlyphs.

glyphProps [ dans]

Type : const DWRITE mise en forme des * _ _ _ Propriétés de glyphe

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

glyphCount

Type : UInt32

Nombre de glyphes retournés par GetGlyphs.

fontFace [ dans]

Type : IDWriteFontFace*

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

fontEmSize

Type : float

Taille de police logique dans des DIP.

pixelsPerDip

Type : float

Nombre de pixels physiques par DIP.

transformation [ dans, facultatif]

Type : const DWRITE _ Matrix *

Transformation facultative appliquée aux glyphes et à leurs positions. Cette transformation est appliquée après la mise à l’échelle spécifiée par la taille de police et pixelsPerDip.

useGdiNatural

Type : bool

Quand la valeur est false, les mesures sont les mêmes que celles du texte d’alias GDI. Quand la valeur est true, les métriques sont les mêmes que les métriques du texte mesurées par GDI à l’aide d’une police créée avec la _ _ qualité naturelle CLEARTYPE.

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.

scriptAnalysis [ dans]

Type : const DWRITE _ script _ Analysis *

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

localeName [ dans, facultatif]

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 la valeur est null, le mappage par défaut basé sur le script est utilisé.

fonctionnalités [ dans, facultatif]

Type : * * const DWRITE _ , _ fonctionnalités typographiques

Tableau de pointeurs vers les jeux de fonctionnalités typographiques à utiliser dans chaque plage de fonctionnalités.

featureRangeLengths [ dans, facultatif]

Type : const UInt32 *

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

featureRanges

Type : UInt32

Nombre de plages de fonctionnalités.

glyphAdvances [ à]

Type : float *

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

GlyphOffsets [ à]

Type : _ _ décalage de glyphe DWRITE*

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 est réussie, elle retourne la valeur _ OK. Sinon, elle retourne un code d’erreur HRESULT .

Configuration requise

Condition requise Valeur
Bibliothèque
DWrite. lib
DLL
Dwrite.dll

Voir aussi

IDWriteTextAnalyzer