IDWriteFontFace1 ::GetGdiCompatibleGlyphAdvances, méthode (dwrite_1.h)

Article
02/28/2024

Retourne les avancées alignées sur les pixels pour une séquence de glyphes.

Syntaxe

HRESULT GetGdiCompatibleGlyphAdvances(
                 FLOAT               emSize,
                 FLOAT               pixelsPerDip,
  [in, optional] DWRITE_MATRIX const *transform,
                 BOOL                useGdiNatural,
                 BOOL                isSideways,
                 UINT32              glyphCount,
  [in]           UINT16 const        *glyphIndices,
  [out]          INT32               *glyphAdvances
);

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.

pixelsPerDip

Type : FLOAT

Nombre de pixels physiques par DIP. Par exemple, si le DPI de la surface de rendu est 96, cette valeur est 1,0f. Si le DPI est 120, cette valeur est 120.0f/96.

[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

Lorsque la valeur est FALSE, les métriques sont identiques au texte sous alias GDI (DWRITE_MEASURING_MODE_GDI_CLASSIC). Lorsque la valeur EST TRUE, les métriques sont les mêmes que celles mesurées par GDI à l’aide d’une police utilisant CLEARTYPE_NATURAL_QUALITY (DWRITE_MEASURING_MODE_GDI_NATURAL).

isSideways

Type : BOOL

Récupérez les avancées verticales du glyphe plutôt que les avancées horizontales.

glyphCount

Type : UINT32

Nombre total de glyphes pour 2000 à récupérer.

[in] glyphIndices

Type : const UINT16*

Tableau d’ID de glyphe pour récupérer les avances.

[out] glyphAdvances

Type : const INT32*

Avances retournées dans les unités de conception de police pour 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.

Remarques

Cela équivaut à appeler GetGdiCompatibleGlyphMetrics et à utiliser uniquement la largeur et la hauteur avancées.

Comme GetGdiCompatibleGlyphMetrics, ceux-ci sont en unités de conception, ce qui signifie qu’ils doivent être réduits par DWRITE_FONT_METRICS ::d esignUnitsPerEm.

Configuration requise

Condition requise	Valeur
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 mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	dwrite_1.h
Bibliothèque	Dwrite_1.lib
DLL	Dwrite_1.dll

Voir aussi

IDWriteFontFace1

Partager via