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

Places saída de glifos do método GetGlyphs de acordo com a fonte e as regras de renderização do sistema de gravação.

Sintaxe

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*

Uma matriz de caracteres que contém a cadeia de caracteres original da qual os glifos vieram.

[in] clusterMap

Tipo: const UINT16*

Um ponteiro para o mapeamento de intervalos de caracteres para intervalos de glifo. Isso é retornado por GetGlyphs.

[in] textProps

Tipo: DWRITE_SHAPING_TEXT_PROPERTIES*

Um ponteiro para uma matriz de estruturas que contém propriedades de formatação para cada caractere. Essa estrutura é retornada por GetGlyphs.

textLength

Tipo: UINT32

O comprimento do texto de textString.

[in] glyphIndices

Tipo: const UINT16*

Uma matriz de índices de glifo retornados por GetGlyphs.

[in] glyphProps

Tipo: const DWRITE_SHAPING_GLYPH_PROPERTIES*

Um ponteiro para uma matriz de estruturas que contêm propriedades de formatação para cada glifo retornado por GetGlyphs.

glyphCount

Tipo: UINT32

O número de glifos retornados de GetGlyphs.

fontFace

Tipo: IDWriteFontFace*

Um ponteiro para a face da fonte que é a origem dos glifos de saída.

fontEmSize

Tipo: FLOAT

O tamanho da fonte lógica em DIPs.

isSideways

Tipo: BOOL

Um sinalizador booliano definido como TRUE se o texto se destina a ser desenhado verticalmente.

isRightToLeft

Tipo: BOOL

Um sinalizador booliano definido como TRUE para texto da direita para a esquerda.

[in] scriptAnalysis

Tipo: const DWRITE_SCRIPT_ANALYSIS*

Um ponteiro para um resultado de análise de script de uma chamada AnalyzeScript .

[in, optional] localeName

Tipo: const WCHAR*

Uma matriz de caracteres que contém a localidade a ser usada ao selecionar glifos. Por exemplo, o mesmo caractere pode ser mapeado para glifos diferentes para ja-jp versus zh-chs. Se for NULL, o mapeamento padrão com base no script será usado.

[in, optional] features

Tipo: const DWRITE_TYPOGRAPHIC_FEATURES**

Uma matriz de ponteiros para os conjuntos de recursos tipográficos a serem usados em cada intervalo de recursos.

[in, optional] featureRangeLengths

Tipo: const UINT32*

O comprimento de cada intervalo de recursos, em caracteres.
A soma de todos os comprimentos deve ser igual a textLength.

featureRanges

Tipo: UINT32

O número de intervalos de recursos.

[out] glyphAdvances

Tipo: FLOAT*

Quando este método retorna, contém a largura avançada de cada glifo.

[out] glyphOffsets

Tipo: DWRITE_GLYPH_OFFSET*

Quando este método retorna, contém o deslocamento da origem de cada glifo.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Confira também

IDWriteTextAnalyzer