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

Traduce una ejecución de glifo a una secuencia de ejecuciones de glifo de color, que se pueden representar para generar una representación de color de la ejecución "base" original.

Sintaxis

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

Origen horizontal y vertical del glifo base que se ejecuta en coordenadas de transformación previa.

[in] glyphRun

Tipo: DWRITE_GLYPH_RUN

Puntero al glifo "base" original.

[in, optional] glyphRunDescription

Tipo: DWRITE_GLYPH_RUN_DESCRIPTION

Descripción opcional de la ejecución del glifo.

desiredGlyphImageFormats

Tipo: DWRITE_GLYPH_IMAGE_FORMATS

En qué formatos de datos se deben dividir las ejecuciones.

measuringMode

Tipo: DWRITE_MEASURING_MODE

Modo de medición, necesario para calcular los orígenes de cada glifo.

[in, optional] worldAndDpiTransform

Tipo: DWRITE_MATRIX

La conversión de matriz desde el espacio de coordenadas del cliente a coordenadas del dispositivo (píxeles), es decir, la transformación del mundo multiplicada por cualquier escala de PPP.

colorPaletteIndex

Tipo: UINT32

Índice de base cero de la paleta de colores que se va a usar. Los índices válidos son menores que el número de paletas de la fuente, tal y como devuelve IDWriteFontFace2::GetColorPaletteCount.

[out] colorLayers

Tipo: IDWriteColorGlyphRunEnumerator1**

Si la función se ejecuta correctamente, recibe un puntero a un objeto enumerador que se puede usar para obtener las ejecuciones del glifo de color. Si la ejecución base no tiene glifos de color, el puntero de salida es NULL y el método devuelve DWRITE_E_NOCOLOR.

Valor devuelto

Tipo: HRESULT

Devuelve DWRITE_E_NOCOLOR si la fuente no tiene información de color, la ejecución del glifo no contiene ningún glifo de color o el índice de paleta de colores especificado está fuera del intervalo. En este caso, el cliente debe representar la ejecución del glifo original. De lo contrario, devuelve un código de error HRESULT estándar.

Comentarios

Llamar a IDWriteFactory2::TranslateColorGlyphRun equivale a llamar a IDWriteFactory4::TranslateColorGlyph con los siguientes formatos especificados: DWRITE_GLYPH_IMAGE_FORMATS_TRUETYPE|DWRITE_GLYPH_IMAGE_FORMATS_CFF|DWRITE_GLYPH_IMAGE_FORMATS_COLR.

Requisitos

Plataforma de destino	Windows
Encabezado	dwrite_3.h
Library	Dwrite.lib

Consulte también

IDWriteFactory4