Metodo IDWriteFontFace4::GetGlyphImageData (dwrite_3.h)

Ottiene un puntatore ai dati del glifo in base al formato di immagine desiderato.

Sintassi

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

Parametri

[in] glyphId

Tipo: UINT16

ID del glifo per cui recuperare i dati dell'immagine.

pixelsPerEm

Tipo: UINT32

Pixel richiesti per em.

glyphImageFormat

Tipo: DWRITE_GLYPH_IMAGE_FORMATS

Specifica i formati supportati nel tipo di carattere.

[out] glyphData

Tipo: DWRITE_GLYPH_IMAGE_DATA*

Nella restituzione sono contenuti dati per un glifo.

[out] glyphDataContext

Tipo: void**

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Commenti

Se i dati non sono vuoti, è necessario rilasciare glyphDataContext tramite ReleaseGlyphImageData , in modo simile a IDWriteFontFileStream::ReadFileFragment e IDWriteFontFileStream::ReleaseFileFragment. Il puntatore dati è valido fino a quando IDWriteFontFace esiste e ReleaseGlyphImageData non è stato chiamato.

Il DWRITE_GLYPH_IMAGE_DATA::uniqueDataId è utile per scopi di memorizzazione nella cache in modo che, se la stessa risorsa viene restituita più volte, una risorsa esistente può essere recuperata rapidamente invece di dover eseguire di nuovo l'analisi o decomprimere i dati.

La funzione restituisce solo dati SVG o raster. La richiesta di dati TrueType/CFF/COLR restituisce DWRITE_E_INVALIDARG. Tali elementi devono essere disegnati tramite DrawGlyphRun o sottoposti a query usando invece GetGlyphOutline. È possibile richiedere esattamente un formato. In caso contrario, la funzione restituisce DWRITE_E_INVALIDARG. Se il glifo non ha tale formato, la chiamata non è un errore, ma la funzione restituisce dati vuoti.

Requisiti

Vedi anche

IDWriteFontFace4