IDWriteFontFace4::GetGlyphImageData-Methode (dwrite_3.h)

Ruft einen Zeiger auf die Glyphendaten basierend auf dem gewünschten Bildformat ab.

Syntax

HRESULT GetGlyphImageData(
  [in]  UINT16                     glyphId,
        UINT32                     pixelsPerEm,
        DWRITE_GLYPH_IMAGE_FORMATS glyphImageFormat,
  [out] DWRITE_GLYPH_IMAGE_DATA    *glyphData,
  [out] void                       **glyphDataContext
);

Die Parameter

[in] glyphId

Typ: UINT16

Die ID der Glyphe zum Abrufen von Bilddaten.

pixelsPerEm

Typ: UINT32-

Angeforderte Pixel pro Em.

glyphImageFormat

Typ: DWRITE_GLYPH_IMAGE_FORMATS

Gibt an, welche Formate in der Schriftart unterstützt werden.

[out] glyphData

Typ: DWRITE_GLYPH_IMAGE_DATA*

Bei rückgabe enthält Daten für eine Glyphe.

[out] glyphDataContext

Typ: void**

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Der glyphDataContext muss über ReleaseGlyphImageData freigegeben werden, wenn die Daten nicht leer sind, ähnlich wie IDWriteFontFileStream::ReadFileFragment und IDWriteFontFileStream::ReleaseFileFragment. Der Datenzeiger ist gültig, solange die IDWriteFontFace vorhanden ist und ReleaseGlyphImageData nicht aufgerufen wurde.

Die DWRITE_GLYPH_IMAGE_DATA::uniqueDataId ist für Zwischenspeicherungszwecke nützlich, sodass eine vorhandene Ressource, wenn dieselbe Ressource mehrmals zurückgegeben wird, schnell abgerufen werden kann, anstatt die Daten zu analysieren oder zu dekomprimieren.

Die Funktion gibt nur SVG- oder Rasterdaten zurück– das Anfordern von TrueType/CFF/COLR-Daten gibt DWRITE_E_INVALIDARG zurück. Diese müssen stattdessen über DrawGlyphRun gezeichnet oder mit GetGlyphOutline abgefragt werden. Genau ein Format kann angefordert werden, sonst gibt die Funktion DWRITE_E_INVALIDARG zurück. Wenn die Glyphe nicht über dieses Format verfügt, ist der Aufruf kein Fehler, aber die Funktion gibt leere Daten zurück.

Anforderungen

Siehe auch

IDWriteFontFace4