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

  • Article

Calcule le contour d’une série de glyphes en rappelant à l’interface de récepteur de plan.

Syntaxe

HRESULT GetGlyphRunOutline(
                 FLOAT                     emSize,
  [in]           UINT16 const              *glyphIndices,
  [in, optional] FLOAT const               *glyphAdvances,
  [in, optional] DWRITE_GLYPH_OFFSET const *glyphOffsets,
                 UINT32                    glyphCount,
                 BOOL                      isSideways,
                 BOOL                      isRightToLeft,
                 IDWriteGeometrySink       *geometrySink
);

Paramètres

emSize

Type : FLOAT

Taille logique de la police en unités DIP. Un DIP (« pixel indépendant de l’appareil ») est égal à 1/96 pouce.

[in] glyphIndices

Type : const UINT16*

Tableau d’index de glyphes. Les glyphes sont dans l’ordre logique et la direction avancée dépend du paramètre isRightToLeft . Le tableau doit être alloué et être en mesure de contenir le nombre d’éléments spécifié par glyphCount.

[in, optional] glyphAdvances

Type : const FLOAT*

Tableau facultatif d’avancées de glyphes dans les DIPs. L’avance d’un glyphe est la quantité permettant d’avancer la position (dans la direction de la ligne de base) après avoir dessiné le glyphe. glyphAdvances contient le nombre d’éléments spécifiés par glyphCount.

[in, optional] glyphOffsets

Type : const DWRITE_GLYPH_OFFSET*

Tableau facultatif de décalages de glyphes, chacun spécifiant le décalage le long de la ligne de base et le décalage perpendiculaire à la ligne de base d’un glyphe par rapport à la position actuelle du stylet. glyphOffsets contient le nombre d’éléments spécifiés par glyphCount.

glyphCount

Type : UINT32

Nombre de glyphes en cours d’exécution.

isSideways

Type : BOOL

Si la valeur est TRUE, l’ascendant du glyphe s’exécute en même temps que la ligne de base. Si la valeur est FALSE, l’ascendant de glyphe s’exécute perpendiculairement à la ligne de base. Par exemple, un alphabet anglais sur une ligne de base verticale aurait isSideways défini sur FALSE.

Un client peut restituer une exécution verticale en définissant isSideways sur TRUE et en faisant pivoter la géométrie résultante de 90 degrés vers la droite à l’aide d’une transformation. Les paramètres isSideways et isRightToLeft ne peuvent pas tous les deux avoir la valeur true.

isRightToLeft

Type : BOOL

Ordre visuel des glyphes. Si ce paramètre a la valeur FALSE, les avances de glyphes sont de gauche à droite. Si la valeur est TRUE, la direction avancée est de droite à gauche. Par défaut, la direction avancée est de gauche à droite.

geometrySink

Type : IDWriteGeometrySink*

Pointeur vers l’interface qui est rappelée pour effectuer des opérations de dessin de plan.

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
Client minimal pris en charge Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête dwrite.h
Bibliothèque Dwrite.lib
DLL Dwrite.dll

Voir aussi

IDWriteFontFace