IDWriteFontFace::GetGlyphIndices, méthode (dwrite.h)

Retourne le mappage nominal des points de code Unicode UCS4 aux index de glyphes tels que définis par la table de police « CMAP ».

Syntaxe

HRESULT GetGlyphIndices(
  [in]  UINT32 const *codePoints,
        UINT32       codePointCount,
  [out] UINT16       *glyphIndices
);

Paramètres

[in] codePoints

Type : const UINT32*

Tableau de points de code USC4 à partir desquels obtenir des indices de glyphes nominaux. Le tableau doit être alloué et être en mesure de contenir le nombre d’éléments spécifié par codePointCount.

codePointCount

Type : UINT32

Nombre d’éléments dans le tableau codePoints .

[out] glyphIndices

Type : UINT16*

Lorsque cette méthode retourne, contient un pointeur vers un tableau d’index de glyphes nominaux remplis par cette fonction.

Valeur retournée

Type : HRESULT

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

Notes

Notez que ce mappage est principalement fourni pour les moteurs de disposition de ligne basés sur l’API de police physique. En raison de la substitution de glyphe OpenType et de la substitution de caractères de disposition de ligne, la conversion nominale ne correspond pas toujours à la façon dont une chaîne Unicode est mappées aux index de glyphes lors du rendu à l’aide d’une police particulière. Notez également que les sélecteurs de variantes Unicode fournissent d’autres mappages de caractères à glyphes. Cet appel retourne toujours la variante par défaut.

Lorsque les caractères ne sont pas présents dans la police, cette méthode retourne l’index 0, qui est le glyphe non défini ou le glyphe « .notdef ». Si un caractère n’est pas dans une police, IDWriteFont::HasCharacter retourne false et GetUnicodeRanges ne le renvoie pas dans la plage.

Spécifications

Voir aussi

IDWriteFontFace