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 |
|
| DLL |
|