Método IDWriteTextAnalyzer::GetGdiCompatibleGlyphPlacements (dwrite.h)

Coloque la salida de glifos del método GetGlyphs según la fuente y las reglas de representación del sistema de escritura.

Sintaxis

HRESULT GetGdiCompatibleGlyphPlacements(
  [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,
  [in]           IDWriteFontFace                       *fontFace,
                 FLOAT                                 fontEmSize,
                 FLOAT                                 pixelsPerDip,
  [in, optional] DWRITE_MATRIX const                   *transform,
                 BOOL                                  useGdiNatural,
                 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 de la que 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.

[in] 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.

pixelsPerDip

Tipo: FLOAT

Número de píxeles físicos por DIP.

[in, optional] transform

Tipo: const DWRITE_MATRIX*

Transformación opcional aplicada a los glifos y sus posiciones. Esta transformación se aplica después del escalado especificado por el tamaño de fuente y píxelesPerDip.

useGdiNatural

Tipo: BOOL

Cuando se establece en FALSE, las métricas son las mismas que las métricas del texto con alias de GDI. Cuando se establece en TRUE, las métricas son las mismas que las métricas de texto medida por GDI mediante una fuente creada con CLEARTYPE_NATURAL_QUALITY.

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 texto de derecha a izquierda.

[in] scriptAnalysis

Tipo: const DWRITE_SCRIPT_ANALYSIS*

Puntero a un resultado de análisis de script de una llamadaa 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 vuelve, 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
Plataforma de destino	Windows
Encabezado	dwrite.h
Library	Dwrite.lib
Archivo DLL	Dwrite.dll

Consulte también

IDWriteTextAnalyzer