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

  • Artigo

Coloque a 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 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*

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 a 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 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.

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

pixelsPerDip

Tipo: FLOAT

O número de pixels físicos por DIP.

[in, optional] transform

Tipo: const DWRITE_MATRIX*

Uma transformação opcional aplicada aos glifos e suas posições. Essa transformação é aplicada após o dimensionamento especificado pelo tamanho da fonte e pixelsPerDip.

useGdiNatural

Tipo: BOOL

Quando definido como FALSE, as métricas são as mesmas que as métricas do texto alias da GDI. Quando definidas como TRUE, as métricas são as mesmas que as métricas de texto medidas pelo GDI usando uma fonte criada com CLEARTYPE_NATURAL_QUALITY.

isSideways

Tipo: BOOL

Um sinalizador booliano definido como TRUE se o texto for destinado 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 chamadaAnalyzeScript .

[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 diferentes glifos 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 esse método retorna, contém a largura avançada de cada glifo.

[out] glyphOffsets

Tipo: DWRITE_GLYPH_OFFSET*

Quando esse 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

Requisito Valor
Plataforma de Destino Windows
Cabeçalho dwrite.h
Biblioteca Dwrite.lib
DLL Dwrite.dll

Confira também

IDWriteTextAnalyzer