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

  • Artigo

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

Confira também

IDWriteFontFace4