Método IDWriteFactory4::TranslateColorGlyphRun (dwrite_3.h)

Converte uma execução de glifo em uma sequência de execuções de glifo de cor, que pode ser renderizada para produzir uma representação de cor da execução "base" original.

Sintaxe

HRESULT TranslateColorGlyphRun(
                 D2D1_POINT_2F                      baselineOrigin,
  [in]           DWRITE_GLYPH_RUN const             *glyphRun,
  [in, optional] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
                 DWRITE_GLYPH_IMAGE_FORMATS         desiredGlyphImageFormats,
                 DWRITE_MEASURING_MODE              measuringMode,
  [in, optional] DWRITE_MATRIX const                *worldAndDpiTransform,
                 UINT32                             colorPaletteIndex,
  [out]          IDWriteColorGlyphRunEnumerator1    **colorLayers
);

Parâmetros

baselineOrigin

Tipo: D2D1_POINT_2F

A origem horizontal e vertical do glifo base é executada em coordenadas de pré-transformação.

[in] glyphRun

Tipo: DWRITE_GLYPH_RUN

Ponteiro para a execução de glifo "base" original.

[in, optional] glyphRunDescription

Tipo: DWRITE_GLYPH_RUN_DESCRIPTION

Descrição opcional da execução de glifo.

desiredGlyphImageFormats

Tipo: DWRITE_GLYPH_IMAGE_FORMATS

Em quais formatos de dados as execuções devem ser divididas.

measuringMode

Tipo: DWRITE_MEASURING_MODE

Modo de medição, necessário para calcular as origens de cada glifo.

[in, optional] worldAndDpiTransform

Tipo: DWRITE_MATRIX

Conversão de matriz do espaço de coordenadas do cliente em coordenadas do dispositivo (pixels), ou seja, a transformação mundial multiplicada por qualquer dimensionamento de DPI.

colorPaletteIndex

Tipo: UINT32

Índice baseado em zero da paleta de cores a ser usada. Índices válidos são menores que o número de paletas na fonte, conforme retornado por IDWriteFontFace2::GetColorPaletteCount.

[out] colorLayers

Tipo: IDWriteColorGlyphRunEnumerator1**

Se a função for bem-sucedida, receberá um ponteiro para um objeto enumerador que pode ser usado para obter as execuções de glifo de cor. Se a execução base não tiver glifos de cor, o ponteiro de saída será NULL e o método retornará DWRITE_E_NOCOLOR.

Valor de retorno

Tipo: HRESULT

Retorna DWRITE_E_NOCOLOR se a fonte não tiver informações de cor, a execução do glifo não contiver nenhum glifo de cor ou se o índice de paleta de cores especificado estiver fora do intervalo. Nesse caso, o cliente deve renderizar a execução do glifo original. Caso contrário, retorna um código de erro HRESULT padrão.

Observações

Chamar IDWriteFactory2::TranslateColorGlyphRun é equivalente a chamar a execução IDWriteFactory4::TranslateColorGlyph com os seguintes formatos especificados: DWRITE_GLYPH_IMAGE_FORMATS_TRUETYPE|DWRITE_GLYPH_IMAGE_FORMATS_CFF|DWRITE_GLYPH_IMAGE_FORMATS_COLR.

Requirements

Consulte também

IDWriteFactory4