IDWriteFontFace ::GetRecommendedRenderingMode, méthode (dwrite.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                  emSize,
        FLOAT                  pixelsPerDip,
        DWRITE_MEASURING_MODE  measuringMode,
        IDWriteRenderingParams *renderingParams,
  [out] DWRITE_RENDERING_MODE  *renderingMode
);

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.

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

renderingParams

Type : IDWriteRenderingParams*

Pointeur vers un objet qui contient des paramètres de rendu tels que le niveau gamma, le contraste amélioré et le niveau ClearType. Ce paramètre est nécessaire si l’objet paramètres de rendu remplace le mode de rendu.

[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.

Spécifications

Voir aussi

IDWriteFontFace