ID2D1DeviceContext4::GetSvgGlyphImage-Methode (d2d1_3.h)

Artikel
02/24/2024

Ruft ein Bild der SVG-Glyphe aus dem Farbglyphencache ab. Wenn der Cache die angeforderte Ressource noch nicht enthält, wird er erstellt. Diese Methode kann verwendet werden, um die Lebensdauer eines Glyphenbilds zu verlängern, auch nachdem es aus dem Farbglyphencache entfernt wurde.

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*

Verweis auf eine Schriftart, die schriftgesichtstyp, entsprechende Dateiverweise, Gesichtserkennungsdaten und verschiedene Schriftartdaten wie Metriken, Namen und Glyphengliederungen enthält.

fontEmSize

Typ: FLOAT

Die angegebene Schriftgröße wirkt sich auf die Ausgabe-GlyphTransform aus, sodass die Glyphe ordnungsgemäß skaliert wird.

glyphIndex

Typ: UINT16

Index der abzurufenden Glyphe.

isSideways

Typ: BOOL

Wenn true, gibt an, dass Glyphen um 90 Grad nach links gedreht werden und vertikale Metriken verwendet werden. Vertikales Schreiben wird erreicht, indem isSideways als true angegeben wird und die gesamte Ausführung über eine Drehtransformation um 90 Grad nach rechts gedreht wird.

[in, optional] worldTransform

Typ: const D2D1_MATRIX_3X2_F*

Die Transformation, die auf das Image angewendet werden soll.

[in, optional] defaultFillBrush

Typ: ID2D1Brush*

Beschreibt, wie der Bereich gezeichnet wird.

[in, optional] svgGlyphStyle

Typ: ID2D1SvgGlyphStyle*

Die Werte für Kontextfüllen, Kontextstriche und Kontextwert, die beim Rendern von SVG-Glyphen verwendet werden.

colorPaletteIndex

Typ: UINT32

Der Index, der zum Auswählen einer Farbpalette innerhalb einer Farbschriftart verwendet wird. Beachten Sie, dass dies nicht mit dem paletteIndex in der DWRITE_COLOR_GLYPH_RUN-Struktur identisch ist, die für SVG-Glyphen nicht relevant ist.

[out] glyphTransform

Typ: D2D1_MATRIX_3X2_F*

Ausgabetransformation, die vom Raum der Glyphe in den gleichen Ausgabebereich wie die worldTransform transformiert wird. Dies umfasst die EingabeglyphOrigin, den Offset der Glyphe von 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

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	d2d1_3.h
DLL	D2d1.dll

Weitere Informationen

ID2D1DeviceContext4

Freigeben über