ID2D1DeviceContext4::GetSvgGlyphImage, méthode (d2d1_3.h)
Récupère une image du glyphe SVG à partir du cache de glyphe 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 avoir été supprimée du cache de glyphe de couleur.
Syntaxe
HRESULT GetSvgGlyphImage(
D2D1_POINT_2F glyphOrigin,
[in] IDWriteFontFace *fontFace,
FLOAT fontEmSize,
UINT16 glyphIndex,
BOOL isSideways,
[in, optional] const D2D1_MATRIX_3X2_F *worldTransform,
[in, optional] ID2D1Brush *defaultFillBrush,
[in, optional] ID2D1SvgGlyphStyle *svgGlyphStyle,
UINT32 colorPaletteIndex,
[out] D2D1_MATRIX_3X2_F *glyphTransform,
[out] ID2D1CommandList **glyphImage
);
Paramètres
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 des visages et diverses données de police telles que les métriques, les noms et les contours de glyphe.
fontEmSize
Type : FLOAT
La taille de police spécifiée affecte le glypheTransform de sortie, ce qui l’entraîne à mettre correctement à l’échelle le glyphe.
glyphIndex
Type : UINT16
Index du glyphe à récupérer.
isSideways
Type : BOOL
Si la valeur est true, spécifie que les glyphes sont pivotés de 90 degrés à gauche et que les métriques verticales sont utilisées. L’écriture verticale est obtenue en spécifiant isSideways comme vrai et en faisant pivoter l’ensemble de l’exécution de 90 degrés à droite via une transformation de rotation.
[in, optional] worldTransform
Type : const D2D1_MATRIX_3X2_F*
Transformation à appliquer à l’image.
[in, optional] defaultFillBrush
Type : ID2D1Brush*
Décrit comment la zone est peinte.
[in, optional] svgGlyphStyle
Type : ID2D1SvgGlyphStyle*
Valeurs de remplissage de contexte, de trait de contexte et de valeur de contexte utilisées lors du rendu des glyphes SVG.
colorPaletteIndex
Type : UINT32
Index utilisé pour sélectionner une palette de couleurs dans une police de couleur. Notez que ce n’est pas le même que la paletteIndex dans le struct DWRITE_COLOR_GLYPH_RUN, ce qui n’est pas pertinent pour les glyphes SVG.
[out] glyphTransform
Type : D2D1_MATRIX_3X2_F*
Transformation de sortie, qui transforme de l’espace du glyphe vers le même espace de sortie que worldTransform. Cela inclut le glyphe d’entréeOrigin, le décalage du glyphe par rapport au glyphOrigin et toutes les autres transformations requises.
[out] glyphImage
Type : ID2D1CommandList**
À 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 |