Método IDWriteFontFace4::GetGlyphImageData (dwrite_3.h)
Obtém um ponteiro para os dados de glifo com base no formato de imagem desejado.
Sintaxe
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
A ID do glifo para o qual recuperar dados de imagem.
pixelsPerEm
Tipo: UINT32
Pixels solicitados por em.
glyphImageFormat
Tipo: DWRITE_GLYPH_IMAGE_FORMATS
Especifica quais formatos têm suporte na fonte.
[out] glyphData
Tipo: DWRITE_GLYPH_IMAGE_DATA*
No retorno contém dados para um glifo.
[out] glyphDataContext
Tipo: void**
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ela retornará um código de erro HRESULT.
Comentários
O glyphDataContext deve ser liberado por meio de ReleaseGlyphImageData quando concluído se os dados não estiverem vazios, semelhante a IDWriteFontFileStream::ReadFileFragment e IDWriteFontFileStream::ReleaseFileFragment. O ponteiro de dados é válido desde que o IDWriteFontFace exista e ReleaseGlyphImageData não tenha sido chamado.
O DWRITE_GLYPH_IMAGE_DATA::uniqueDataId é valioso para fins de cache para que, se o mesmo recurso for retornado mais de uma vez, um recurso existente possa ser recuperado rapidamente em vez de precisar analisar novamente ou descompactar os dados.
A função retorna apenas dados SVG ou de varredura – a solicitação de dados TrueType/CFF/COLR retorna DWRITE_E_INVALIDARG. Eles devem ser desenhados por meio de DrawGlyphRun ou consultados usando GetGlyphOutline. Exatamente um formato pode ser solicitado ou então a função retorna DWRITE_E_INVALIDARG. Se o glifo não tiver esse formato, a chamada não será um erro, mas a função retornará dados vazios.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Windows |
Cabeçalho | dwrite_3.h |
Biblioteca | Dwrite.lib |