Share via

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

  • Artigo

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 "base" original. Adiciona um novo parâmetro paintFeatureLevel , mas é idêntico a IDWriteFactory4::TranslateColorGlyphRun.

Sintaxe

HRESULT TranslateColorGlyphRun(
  D2D1_POINT_2F                      baselineOrigin,
  DWRITE_GLYPH_RUN const             *glyphRun,
  DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
  DWRITE_GLYPH_IMAGE_FORMATS         desiredGlyphImageFormats,
  DWRITE_PAINT_FEATURE_LEVEL         paintFeatureLevel,
  DWRITE_MEASURING_MODE              measuringMode,
  DWRITE_MATRIX const                *worldAndDpiTransform,
  UINT32                             colorPaletteIndex,
  IDWriteColorGlyphRunEnumerator1    **colorEnumerator
);

Parâmetros

baselineOrigin

Tipo: D2D1_POINT_2F

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

glyphRun

Tipo: _In_ DWRITE_GLYPH_RUN const*

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

glyphRunDescription

Tipo: _In_opt_ DWRITE_GLYPH_RUN_DESCRIPTION const*

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

desiredGlyphImageFormats

Tipo: DWRITE_GLYPH_IMAGE_FORMATS

Os formatos de dados nos quais o método deve dividir as execuções.

paintFeatureLevel

Tipo: DWRITE_PAINT_FEATURE_LEVEL

O nível de recurso de pintura com suporte do chamador. Usado quando desiredGlyphImageFormats inclui DWRITE_GLYPH_IMAGE_FORMATS_COLR_PAINT_TREE. Para obter mais informações, consulte DWRITE_PAINT_FEATURE_LEVEL.

measuringMode

Tipo: DWRITE_MEASURING_MODE

O modo de medição, que é necessário para calcular as origens de cada glifo.

worldAndDpiTransform

Tipo: _In_opt_ DWRITE_MATRIX const*

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

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.

colorEnumerator

Tipo: _COM_Outptr_ 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.

Retornar valor

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

Comentários

Chamar IDWriteFactory2::TranslateColorGlyphRun é equivalente a chamar IDWriteFactory2::TranslateColorGlyphRun e passar DWRITE_GLYPH_IMAGE_FORMATS_TRUETYPE|COLR CFF| em desiredGlyphImageFormats.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1809 (com SDK do Aplicativo Windows 1.2 ou posterior)
Cabeçalho dwrite_3.h

Confira também