ID2D1DeviceContext4::GetSvgGlyphImage-Methode (d2d1_3.h)
Ruft ein Bild der SVG-Glyphe aus dem Farbglyphencache ab. Wenn der Cache nicht bereits die angeforderte Ressource enthält, wird er erstellt. Diese Methode kann verwendet werden, um die Lebensdauer eines Glyphenbilds zu erweitern, auch wenn es aus dem Farbglyphencache entfernt wird.
Syntax
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
);
Parameter
glyphOrigin
Typ: D2D1_POINT_2F
Ursprung der Glyphe.
[in] fontFace
Typ: IDWriteFontFace*
Verweisen Sie auf ein Schriftzeichen, das Schriftzeichentyp, entsprechende Dateiverweise, Gesichtsidentifikationsdaten und verschiedene Schriftartdaten wie Metriken, Namen und Glyphenkonturen enthält.
fontEmSize
Typ: FLOAT
Der angegebene Schriftgrad wirkt sich auf die Ausgabe glyphTransform aus, was dazu führt, dass die Glyphe ordnungsgemäß skaliert wird.
glyphIndex
Typ: UINT16
Index der abzurufenden Glyphe.
isSideways
Typ: BOOL
Wenn true, gibt an, dass Glyphen 90 Grad nach links gedreht werden und vertikale Metriken verwendet werden. Die vertikale Schreibrichtung wird erreicht, indem "isSideways" als "true" angegeben wird und die gesamte Ausführung über eine Drehtransformation 90 Grad nach rechts gedreht wird.
[in, optional] worldTransform
Die Transformation, die auf das Bild angewendet werden soll.
[in, optional] defaultFillBrush
Typ: ID2D1Brush*
Beschreibt, wie der Bereich gezeichnet wird.
[in, optional] svgGlyphStyle
Typ: ID2D1SvgGlyphStyle*
Die Werte für Kontextfüllung, Kontextstrich und Kontextwert, die beim Rendern von SVG-Glyphen verwendet werden.
colorPaletteIndex
Typ: UINT32
Der Index, der zum Auswählen einer Farbpalette in einer Farbschriftart verwendet wird. Beachten Sie, dass dies nicht mit dem paletteIndex in der DWRITE_COLOR_GLYPH_RUN Struktur identisch ist, was für SVG-Glyphen nicht relevant ist.
[out] glyphTransform
Typ: D2D1_MATRIX_3X2_F*
Ausgabetransformation, die vom Raum der Glyphe in den gleichen Ausgaberaum wie die WorldTransform transformiert wird. Dazu gehören die Eingabe glyphOrigin, der Glyphenversatz aus dem GlyphOrigin und alle anderen erforderlichen Transformationen.
[out] glyphImage
Typ: ID2D1CommandList**
Enthält nach Abschluss das abgerufene Glyphenbild.
Rückgabewert
Typ: HRESULT
Diese Methode gibt einen HRESULT-Erfolgs- oder Fehlercode zurück.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | d2d1_3.h |
| DLL | D2d1.dll |