ID2D1DeviceContext4::GetColorBitmapGlyphImage-Methode (d2d1_3.h)

  • Artikel

Ruft ein Bild der Farb-Bitmap-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 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
);

Parameter

glyphImageFormat

Typ: DWRITE_GLYPH_IMAGE_FORMATS

Das Format für das Glyphenbild. Wenn keine Bilddaten im angeforderten Format für die angeforderte Glyphe vorhanden sind, gibt diese Methode einen Fehler zurück.

glyphOrigin

Typ: D2D1_POINT_2F

Der Ursprung für die 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

Der angegebene Schriftgrad wirkt sich auf die Wahl der Bitmap aus der Schriftart aus. Es wirkt sich auch auf die Ausgabe-GlyphTransform aus, sodass die Glyphe ordnungsgemäß skaliert wird.

glyphIndex

Typ: UINT16

Index der 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. Diese Eingabetransformation wirkt sich auf die Wahl der Bitmap aus der Schriftart aus. Es wird auch in die Ausgabe glyphTransform berücksichtigt.

dpiX

Typ: FLOAT

Punkte pro Zoll entlang der x-Achse.

dpiY

Typ: FLOAT

Punkte pro Zoll entlang der y-Achse.

[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: ID2D1Image**

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

Weitere Informationen

ID2D1DeviceContext4