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 |