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

Article
08/22/2023

Récupère une image du glyphe SVG à 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 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 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 glyphTransform de sortie, ce qui entraîne une mise à l’échelle correcte du 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 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.

[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 la même chose 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 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 : 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

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

Voir aussi

ID2D1DeviceContext4

Partager via