IDWriteTextAnalyzer ::GetGdiCompatibleGlyphPlacements, méthode (dwrite.h)
Placez la 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 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
);
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.
[in] 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.
pixelsPerDip
Type : FLOAT
Nombre de pixels physiques par DIP.
[in, optional] transform
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
Lorsqu’elles sont définies sur FALSE, les métriques sont identiques aux métriques du texte avec alias GDI. Lorsqu’elles sont définies sur TRUE, les métriques sont les mêmes que les métriques de texte mesurées par GDI à l’aide d’une police créée avec CLEARTYPE_NATURAL_QUALITY.
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 appelAnalyzeScript .
[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. S’il s’agit de 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
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | dwrite.h |
| Bibliothèque | Dwrite.lib |
| DLL | Dwrite.dll |