Método ID2D1DeviceContext4::GetColorBitmapGlyphImage (d2d1_3.h)

  • Artigo

Recupera uma imagem do glifo de bitmap de cor do cache de glifo de cor. Se o cache ainda não contiver o recurso solicitado, ele será criado. Esse método pode ser usado para estender o tempo de vida de uma imagem de glifo mesmo depois que ela é removida do cache de glifo de cores.

Sintaxe

HRESULT GetColorBitmapGlyphImage(
                 DWRITE_GLYPH_IMAGE_FORMATS glyphImageFormat,
                 D2D1_POINT_2F              glyphOrigin,
  [in]           IDWriteFontFace            *fontFace,
                 FLOAT                      fontEmSize,
                 UINT16                     glyphIndex,
                 BOOL                       isSideways,
  [in, optional] const D2D1_MATRIX_3X2_F    *worldTransform,
                 FLOAT                      dpiX,
                 FLOAT                      dpiY,
  [out]          D2D1_MATRIX_3X2_F          *glyphTransform,
  [out]          ID2D1Image                 **glyphImage
);

Parâmetros

glyphImageFormat

Tipo: DWRITE_GLYPH_IMAGE_FORMATS

O formato da imagem do glifo. Se não houver dados de imagem no formato solicitado para o glifo solicitado, esse método retornará um erro.

glyphOrigin

Tipo: D2D1_POINT_2F

A origem do glifo.

[in] fontFace

Tipo: IDWriteFontFace*

Referência a uma face de fonte que contém o tipo de face da fonte, referências de arquivo apropriadas, dados de identificação facial e vários dados de fonte, como métricas, nomes e estruturas de tópicos de glifo.

fontEmSize

Tipo: FLOAT

O tamanho da fonte especificado afeta a escolha de qual bitmap usar da fonte. Ele também afeta o glifo de saídaTransform, fazendo com que ele dimensione corretamente o glifo.

glyphIndex

Tipo: UINT16

Índice do glifo.

isSideways

Tipo: BOOL

Se true, especifica que os glifos são girados 90 graus para a esquerda e as métricas verticais são usadas. A gravação vertical é obtida especificando isSideways como true e girando toda a execução 90 graus para a direita por meio de uma transformação de rotação.

[in, optional] worldTransform

Tipo: const D2D1_MATRIX_3X2_F*

A transformação a ser aplicada à imagem. Essa transformação de entrada afeta a escolha de qual bitmap usar da fonte. Ele também é fatorado no glifotransform de saída.

dpiX

Tipo: FLOAT

Pontos por polegada ao longo do eixo x.

dpiY

Tipo: FLOAT

Pontos por polegada ao longo do eixo y.

[out] glyphTransform

Tipo: D2D1_MATRIX_3X2_F*

Transformação de saída, que se transforma do espaço do glifo para o mesmo espaço de saída que o worldTransform. Isso inclui o glifo de entradaOrigin, o deslocamento do glifo do glifoOrigin e quaisquer outras transformações necessárias.

[out] glyphImage

Tipo: ID2D1Imagem**

Após a conclusão, contém a imagem de glifo recuperada.

Valor retornado

Tipo: HRESULT

Esse método retorna um código de erro ou êxito HRESULT.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho d2d1_3.h
DLL D2d1.dll

Confira também

ID2D1DeviceContext4