Método IDWriteFactory2::TranslateColorGlyphRun (dwrite_2.h)

Esse método é chamado em uma execução de glifo para convertê-lo em várias execuções de glifo de cor.

Sintaxe

HRESULT TranslateColorGlyphRun(
                 FLOAT                              baselineOriginX,
                 FLOAT                              baselineOriginY,
  [in]           DWRITE_GLYPH_RUN const             *glyphRun,
  [in, optional] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
                 DWRITE_MEASURING_MODE              measuringMode,
  [in, optional] DWRITE_MATRIX const                *worldToDeviceTransform,
                 UINT32                             colorPaletteIndex,
  [out]          IDWriteColorGlyphRunEnumerator     **colorLayers
);

Parâmetros

baselineOriginX

Tipo: FLOAT

A origem da linha de base horizontal da execução de glifo original.

baselineOriginY

Tipo: FLOAT

A origem da linha de base vertical da execução de glifo original.

[in] glyphRun

Tipo: const DWRITE_GLYPH_RUN*

Execução de glifo original contendo IDs de glifo monocromáticas.

[in, optional] glyphRunDescription

Tipo: const DWRITE_GLYPH_RUN_DESCRIPTION*

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

measuringMode

Tipo: DWRITE_MEASURING_MODE

Modo de medição usado para calcular posições de glifo se a execução contiver glifos de cor.

[in, optional] worldToDeviceTransform

Tipo: const DWRITE_MATRIX*

Transformação mundial multiplicada por qualquer dimensionamento de DPI. Isso é necessário para calcular posições de glifo se a execução contiver glifos de cor e o modo de medição não for DWRITE_MEASURING_MODE_NATURAL. Se esse parâmetro for NULL e a transformação de identidade for assumida.

colorPaletteIndex

Tipo: UINT32

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

[out] colorLayers

Tipo: IDWriteColorGlyphRunEnumerator**

Se a execução de glifo original contiver glifos de cor, esse parâmetro receberá um ponteiro para uma interface IDWriteColorGlyphRunEnumerator . O cliente usa a interface retornada para obter informações sobre execuções de glifo e cores associadas para renderizar em vez da execução de glifo original. Se a execução de glifo original não contiver glifos de cor, esse método retornará DWRITE_E_NOCOLOR e o ponteiro de saída será NULL.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se o código chamar esse método com uma execução de glifo que não contém informações de cor, o método retornará DWRITE_E_NOCOLOR para informar ao aplicativo que ele pode apenas desenhar a execução do glifo original. Se a execução do glifo contiver informações de cor, a função retornará um objeto que pode ser enumerado por meio de para expor execuções e cores associadas. Em seguida, o aplicativo chama DrawGlyphRun com cada uma das execuções de glifo retornadas e cores de primeiro plano.

Requisitos

Cliente mínimo com suporte	Windows 8.1 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	dwrite_2.h
Biblioteca	Dwrite.lib
DLL	Dwrite.dll

Confira também

IDWriteFactory2