Método IDWriteFontFace4::GetGlyphImageData (dwrite_3.h)
Obtiene un puntero a los datos del glifo según el formato de imagen deseado.
Sintaxis
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 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 realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de 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 idWriteFontFace exista 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. Estos deben dibujarse a través de DrawGlyphRun o consultarse 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
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | dwrite_3.h |
| Library | Dwrite.lib |