Método IDWriteTextAnalyzer::GetGlyphPlacements (dwrite.h)
Places salida de glifos del método GetGlyphs según la fuente y las reglas de representación del sistema de escritura.
Sintaxis
HRESULT GetGlyphPlacements(
[in] WCHAR const *textString,
[in] UINT16 const *clusterMap,
[in] DWRITE_SHAPING_TEXT_PROPERTIES *textProps,
UINT32 textLength,
[in] UINT16 const *glyphIndices,
[in] DWRITE_SHAPING_GLYPH_PROPERTIES const *glyphProps,
UINT32 glyphCount,
IDWriteFontFace *fontFace,
FLOAT fontEmSize,
BOOL isSideways,
BOOL isRightToLeft,
[in] DWRITE_SCRIPT_ANALYSIS const *scriptAnalysis,
[in, optional] WCHAR const *localeName,
[in, optional] DWRITE_TYPOGRAPHIC_FEATURES const **features,
[in, optional] UINT32 const *featureRangeLengths,
UINT32 featureRanges,
[out] FLOAT *glyphAdvances,
[out] DWRITE_GLYPH_OFFSET *glyphOffsets
);
Parámetros
[in] textString
Tipo: const WCHAR*
Matriz de caracteres que contiene la cadena original a partir de la cual vinieron los glifos.
[in] clusterMap
Tipo: const UINT16*
Puntero a la asignación de intervalos de caracteres a intervalos de glifos. GetGlyphs devuelve esto.
[in] textProps
Tipo: DWRITE_SHAPING_TEXT_PROPERTIES*
Puntero a una matriz de estructuras que contiene propiedades de forma para cada carácter. GetGlyphs devuelve esta estructura.
textLength
Tipo: UINT32
Longitud de texto de textString.
[in] glyphIndices
Tipo: const UINT16*
Matriz de índices de glifo devueltos por GetGlyphs.
[in] glyphProps
Tipo: const DWRITE_SHAPING_GLYPH_PROPERTIES*
Puntero a una matriz de estructuras que contienen propiedades de forma para cada glifo devuelto por GetGlyphs.
glyphCount
Tipo: UINT32
Número de glifos devueltos de GetGlyphs.
fontFace
Tipo: IDWriteFontFace*
Puntero a la cara de fuente que es el origen de los glifos de salida.
fontEmSize
Tipo: FLOAT
Tamaño de fuente lógico en DIP.
isSideways
Tipo: BOOL
Marca booleana establecida en TRUE si el texto está pensado para dibujarse verticalmente.
isRightToLeft
Tipo: BOOL
Marca booleana establecida en TRUE para el texto de derecha a izquierda.
[in] scriptAnalysis
Tipo: const DWRITE_SCRIPT_ANALYSIS*
Puntero a un resultado de análisis de script de una llamada a AnalyzeScript .
[in, optional] localeName
Tipo: const WCHAR*
Matriz de caracteres que contiene la configuración regional que se va a usar al seleccionar glifos. Por ejemplo, el mismo carácter puede asignarse a glifos diferentes para ja-jp frente a zh-chs. Si es NULL, se usa la asignación predeterminada basada en el script.
[in, optional] features
Tipo: const DWRITE_TYPOGRAPHIC_FEATURES**
Matriz de punteros a los conjuntos de características tipográficas que se van a usar en cada intervalo de características.
[in, optional] featureRangeLengths
Tipo: const UINT32*
Longitud de cada intervalo de características, en caracteres.
La suma de todas las longitudes debe ser igual a textLength.
featureRanges
Tipo: UINT32
Número de intervalos de características.
[out] glyphAdvances
Tipo: FLOAT*
Cuando este método devuelve, contiene el ancho avanzado de cada glifo.
[out] glyphOffsets
Tipo: DWRITE_GLYPH_OFFSET*
Cuando este método devuelve , contiene el desplazamiento del origen de cada glifo.
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 |