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.

Syntax

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

El origen horizontal y vertical del glifo base se ejecuta en coordenadas previas a la transformación.

[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

Conversión de matriz desde el espacio de coordenadas del cliente a coordenadas de 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 glifos 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.

Observaciones

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

Consulte también

IDWriteFactory4