Método IDWriteFactory2::TranslateColorGlyphRun (dwrite_2.h)
Se llama a este método en una ejecución de glifo para traducirlo en varias ejecuciones de glifo de color.
Sintaxis
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
Origen de línea base horizontal de la ejecución del glifo original.
baselineOriginY
Tipo: FLOAT
Origen de línea base vertical de la ejecución del glifo original.
[in] glyphRun
Tipo: const DWRITE_GLYPH_RUN*
Glifo original que contiene identificadores de glifo monocromáticos.
[in, optional] glyphRunDescription
Tipo: const DWRITE_GLYPH_RUN_DESCRIPTION*
Descripción opcional de la ejecución del glifo.
measuringMode
Tipo: DWRITE_MEASURING_MODE
Modo de medición utilizado para calcular las posiciones del glifo si la ejecución contiene glifos de color.
[in, optional] worldToDeviceTransform
Tipo: const DWRITE_MATRIX*
Transformación mundial multiplicada por cualquier escalado de PPP. Esto es necesario para calcular las posiciones del glifo si la ejecución contiene glifos de color y el modo de medición no es DWRITE_MEASURING_MODE_NATURAL. Si este parámetro es NULL y se asume la transformación de identidad.
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: IDWriteColorGlyphRunEnumerator**
Si la ejecución del glifo original contiene glifos de color, este parámetro recibe un puntero a una interfaz IDWriteColorGlyphRunEnumerator . El cliente usa la interfaz devuelta para obtener información sobre las ejecuciones del glifo y los colores asociados para representar en lugar de la ejecución original del glifo. Si la ejecución del glifo original no contiene glifos de color, este método devuelve DWRITE_E_NOCOLOR y el puntero de salida es NULL.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Observaciones
Si el código llama a este método con una ejecución de glifo que no contiene información de color, el método devuelve DWRITE_E_NOCOLOR para que la aplicación sepa que simplemente puede dibujar la ejecución del glifo original. Si la ejecución del glifo contiene información de color, la función devuelve un objeto que se puede enumerar mediante para exponer ejecuciones y colores asociados. A continuación, la aplicación llama a DrawGlyphRun con cada uno de los glifos devueltos que se ejecuta y los colores de primer plano.
Requisitos
| Cliente mínimo compatible | Windows 8.1 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2012 R2 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | dwrite_2.h |
| Library | Dwrite.lib |
| Archivo DLL | Dwrite.dll |