MÉTHODE IDWriteTextAnalyzer1::ApplyCharacterSpacing (dwrite_1.h)

Article
08/23/2023

Applique l’espacement entre les caractères, en ajustant correctement les clusters de glyphes et les diacritiques.

Syntaxe

HRESULT ApplyCharacterSpacing(
        FLOAT                                 leadingSpacing,
        FLOAT                                 trailingSpacing,
        FLOAT                                 minimumAdvanceWidth,
        UINT32                                textLength,
        UINT32                                glyphCount,
  [in]  UINT16 const                          *clusterMap,
  [in]  FLOAT const                           *glyphAdvances,
  [in]  DWRITE_GLYPH_OFFSET const             *glyphOffsets,
  [in]  DWRITE_SHAPING_GLYPH_PROPERTIES const *glyphProperties,
  [out] FLOAT                                 *modifiedGlyphAdvances,
  [out] DWRITE_GLYPH_OFFSET                   *modifiedGlyphOffsets
);

Paramètres

leadingSpacing

Espacement avant chaque caractère, dans l’ordre de lecture.

trailingSpacing

Espacement après chaque caractère, dans l’ordre de lecture.

minimumAdvanceWidth

Avance minimale de chaque caractère, pour éviter que les caractères deviennent trop fins ou de largeur nulle. Cette valeur doit être égale à zéro ou supérieure.

textLength

Longueur du clustermap et du texte d’origine.

glyphCount

Nombre de glyphes.

[in] clusterMap

Mappage des plages de caractères aux plages de glyphes.

[in] glyphAdvances

Largeur avancée de chaque glyphe.

[in] glyphOffsets

Décalage de l’origine de chaque glyphe.

[in] glyphProperties

Propriétés de chaque glyphe, à partir de GetGlyphes.

[out] modifiedGlyphAdvances

Nouvelle largeur avancée de chaque glyphe.

[out] modifiedGlyphOffsets

Nouveau décalage de l’origine de chaque glyphe.

Valeur retournée

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

Notes

Les avances/décalages d’entrée et de sortie sont autorisés à alias du même tableau.

Spécifications


Client minimal pris en charge	Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 et Platform Update pour Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	dwrite_1.h
Bibliothèque	Dwrite.lib
DLL	Dwrite.dll

Voir aussi

IDWriteTextAnalyzer1

Partager via