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

Détermine le mode de rendu recommandé pour la police, à l’aide des paramètres de taille et de rendu spécifiés.

Syntaxe

HRESULT GetRecommendedRenderingMode(
                 FLOAT                    fontEmSize,
                 FLOAT                    dpiX,
                 FLOAT                    dpiY,
  [in, optional] DWRITE_MATRIX const      *transform,
                 BOOL                     isSideways,
                 DWRITE_OUTLINE_THRESHOLD outlineThreshold,
                 DWRITE_MEASURING_MODE    measuringMode,
  [out]          DWRITE_RENDERING_MODE    *renderingMode
);

Paramètres

fontEmSize

Type : FLOAT

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

dpiX

Type : FLOAT

Nombre de pixels physiques par DIP dans une position horizontale. 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.

dpiY

Type : FLOAT

Nombre de pixels physiques par DIP dans une position verticale. 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*

Spécifie la transformation du monde.

isSideways

Type : BOOL

Indique si les glyphes en cours d’exécution sont de côté ou non.

outlineThreshold

Type : DWRITE_OUTLINE_THRESHOLD

Une valeur de type DWRITE_OUTLINE_THRESHOLD qui spécifie la qualité du rendu des contours du système graphique affecte le seuil de taille au-dessus duquel le rendu du plan est utilisé.

measuringMode

Type : DWRITE_MEASURING_MODE

Méthode de mesure qui sera utilisée pour les glyphes dans la police. Les implémentations de renderer peuvent choisir différents modes de rendu pour différentes méthodes de mesure, par exemple :

• DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL pour DWRITE_MEASURING_MODE_NATURAL
• DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC pour DWRITE_MEASURING_MODE_GDI_CLASSIC
• DWRITE_RENDERING_MODE_CLEARTYPE_GDI_NATURAL pour DWRITE_MEASURING_MODE_GDI_NATURAL

[out] renderingMode

Type : DWRITE_RENDERING_MODE*

Lorsque cette méthode retourne, contient une valeur qui indique le mode de rendu recommandé à utiliser.

Valeur retournée

Type : HRESULT

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

Remarques

Cette méthode doit être utilisée pour déterminer le mode de rendu réel dans les cas où le mode de rendu de l’objet params de rendu est DWRITE_RENDERING_MODE_DEFAULT.

Configuration requise

Voir aussi

IDWriteFontFace1