Método IDWriteFontFace::GetGlyphRunOutline (dwrite.h)

Calcula el esquema de una ejecución de glifos llamando de nuevo a la interfaz receptora de esquema.

Sintaxis

HRESULT GetGlyphRunOutline(
                 FLOAT                     emSize,
  [in]           UINT16 const              *glyphIndices,
  [in, optional] FLOAT const               *glyphAdvances,
  [in, optional] DWRITE_GLYPH_OFFSET const *glyphOffsets,
                 UINT32                    glyphCount,
                 BOOL                      isSideways,
                 BOOL                      isRightToLeft,
                 IDWriteGeometrySink       *geometrySink
);

Parámetros

emSize

Tipo: FLOAT

Tamaño lógico de la fuente en unidades DIP. Un DIP ("píxel independiente del dispositivo") es igual a 1/96 pulgadas.

[in] glyphIndices

Tipo: const UINT16*

Matriz de índices de glifo. Los glifos están en orden lógico y la dirección de avance depende del parámetro isRightToLeft . La matriz debe asignarse y poder contener el número de elementos especificados por glyphCount.

[in, optional] glyphAdvances

Tipo: const FLOAT*

Matriz opcional de avances de glifo en DIP. El avance de un glifo es la cantidad para avanzar la posición (en la dirección de la línea base) después de dibujar el glifo. glyphAdvances contiene el número de elementos especificados por glyphCount.

[in, optional] glyphOffsets

Tipo: const DWRITE_GLYPH_OFFSET*

Matriz opcional de desplazamientos de glifo, cada una de las cuales especifica el desplazamiento a lo largo de la línea base y desplazamiento perpendicular a la línea base de un glifo en relación con la posición del lápiz actual. glyphOffsets contiene el número de elementos especificados por glyphCount.

glyphCount

Tipo: UINT32

Número de glifos en la ejecución.

isSideways

Tipo: BOOL

Si es TRUE, el ascendente del glifo se ejecuta junto con la línea base. Si es FALSE, el glifo ascendente se ejecuta perpendicular a la línea base. Por ejemplo, un alfabeto inglés en una línea base vertical tendría establecido isSideways en FALSE.

Un cliente puede representar una ejecución vertical estableciendo isSideways en TRUE y girando la geometría resultante de 90 grados a la derecha mediante una transformación. Los parámetros isSideways y isRightToLeft no pueden ser true.

isRightToLeft

Tipo: BOOL

Orden visual de los glifos. Si este parámetro es FALSE, el glifo avanza de izquierda a derecha. Si es TRUE, la dirección de avance es de derecha a izquierda. De forma predeterminada, la dirección de avance es de izquierda a derecha.

geometrySink

Tipo: IDWriteGeometrySink*

Puntero a la interfaz a la que se llama para realizar operaciones de dibujo de esquema.

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.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado dwrite.h
Library Dwrite.lib
Archivo DLL Dwrite.dll

Consulte también

IDWriteFontFace