ID2D1DeviceContext4::GetColorBitmapGlyphImage, méthode (d2d1_3.h)

Récupère une image du glyphe bitmap de couleur à partir du cache de glyphes de couleur. Si le cache ne contient pas encore la ressource demandée, il est créé. Cette méthode peut être utilisée pour prolonger la durée de vie d’une image de glyphe même après sa suppression du cache de glyphes de couleur.

Syntaxe

HRESULT GetColorBitmapGlyphImage(
                 DWRITE_GLYPH_IMAGE_FORMATS glyphImageFormat,
                 D2D1_POINT_2F              glyphOrigin,
  [in]           IDWriteFontFace            *fontFace,
                 FLOAT                      fontEmSize,
                 UINT16                     glyphIndex,
                 BOOL                       isSideways,
  [in, optional] const D2D1_MATRIX_3X2_F    *worldTransform,
                 FLOAT                      dpiX,
                 FLOAT                      dpiY,
  [out]          D2D1_MATRIX_3X2_F          *glyphTransform,
  [out]          ID2D1Image                 **glyphImage
);

Paramètres

glyphImageFormat

Type : DWRITE_GLYPH_IMAGE_FORMATS

Format de l’image de glyphe. S’il n’existe aucune donnée d’image dans le format demandé pour le glyphe demandé, cette méthode retourne une erreur.

glyphOrigin

Type : D2D1_POINT_2F

Origine du glyphe.

[in] fontFace

Type : IDWriteFontFace*

Référence à un visage de police qui contient le type de visage de police, les références de fichier appropriées, les données d’identification de visage et diverses données de police telles que les métriques, les noms et les contours de glyphes.

fontEmSize

Type : FLOAT

La taille de police spécifiée affecte le choix de la bitmap à utiliser à partir de la police. Cela affecte également le glyphTransform de sortie, ce qui l’oblige à mettre à l’échelle correctement le glyphe.

glyphIndex

Type : UINT16

Index du glyphe.

isSideways

Type : BOOL

Si la valeur est true, spécifie que les glyphes sont pivotés de 90 degrés vers la gauche et que des métriques verticales sont utilisées. L’écriture verticale est obtenue en spécifiant isSideways comme true et en faisant pivoter l’ensemble de l’exécution de 90 degrés vers la droite via une transformation de rotation.

[in, optional] worldTransform

Type : const D2D1_MATRIX_3X2_F*

Transformation à appliquer à l’image. Cette transformation d’entrée affecte le choix de la bitmap à utiliser à partir de la police. Il est également factorisé dans le glyphTransform de sortie.

dpiX

Type : FLOAT

Points par pouce le long de l’axe des X.

dpiY

Type : FLOAT

Points par pouce le long de l’axe y.

[out] glyphTransform

Type : D2D1_MATRIX_3X2_F*

Transformation de sortie, qui transforme de l’espace du glyphe au même espace de sortie que worldTransform. Cela inclut le glyphOrigin d’entrée, le décalage du glyphe par rapport à glyphOrigin et toutes les autres transformations requises.

[out] glyphImage

Type : ID2D1Image**

À la fin, contient l’image de glyphe récupérée.

Valeur retournée

Type : HRESULT

Cette méthode retourne un code de réussite ou d’erreur HRESULT.

Configuration requise

Plateforme cible	Windows
En-tête	d2d1_3.h
DLL	D2d1.dll

Voir aussi

ID2D1DeviceContext4