Método IDWriteFontFace4::GetGlyphImageData (dwrite_3.h)

Obtiene un puntero a los datos del glifo según el formato de imagen deseado.

Syntax

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

Parámetros

[in] glyphId

Tipo: UINT16

Identificador del glifo para el que se van a recuperar los datos de la imagen.

pixelsPerEm

Tipo: UINT32

Píxeles solicitados por em.

glyphImageFormat

Tipo: DWRITE_GLYPH_IMAGE_FORMATS

Especifica qué formatos se admiten en la fuente.

[out] glyphData

Tipo: DWRITE_GLYPH_IMAGE_DATA*

Al devolver, contiene datos para un glifo.

[out] glyphDataContext

Tipo: void**

Valor devuelto

Tipo: HRESULT

Si este método se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT.

Observaciones

El glyphDataContext debe liberarse a través de ReleaseGlyphImageData cuando haya terminado si los datos no están vacíos, de forma similar a IDWriteFontFileStream::ReadFileFragment e IDWriteFontFileStream::ReleaseFileFragment. El puntero de datos es válido siempre que exista IDWriteFontFace y no se haya llamado a ReleaseGlyphImageData .

El DWRITE_GLYPH_IMAGE_DATA::uniqueDataId es útil con fines de almacenamiento en caché para que, si se devuelve el mismo recurso más de una vez, se puede recuperar rápidamente un recurso existente en lugar de tener que volver a analizar o descomprimir los datos.

La función solo devuelve datos SVG o ráster: la solicitud de datos TrueType/CFF/COLR devuelve DWRITE_E_INVALIDARG. Deben dibujarse a través de DrawGlyphRun o consultarlos mediante GetGlyphOutline en su lugar. Se puede solicitar exactamente un formato o, de lo contrario, la función devuelve DWRITE_E_INVALIDARG. Si el glifo no tiene ese formato, la llamada no es un error, pero la función devuelve datos vacíos.

Requisitos

Consulte también

IDWriteFontFace4