ID2D1DeviceContext4::GetColorBitmapGlyphImage-Methode (d2d1_3.h)
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 |