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 |