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 podem ser renderizadas para produzir uma representação de cor da execução original de "base".

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 do 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 de mundo multiplicada por qualquer escala 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 retornado

Tipo: HRESULT

Retorna DWRITE_E_NOCOLOR se a fonte não tiver informações de cor, a execução do glifo não conterá glifos de cor ou 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, retornará um código de erro HRESULT padrão.

Comentários

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

Requisitos

Plataforma de Destino	Windows
Cabeçalho	dwrite_3.h
Biblioteca	Dwrite.lib

Confira também

IDWriteFactory4