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

Consulte también

IDWriteFactory2