Método IDWriteTextAnalyzer::GetGdiCompatibleGlyphPlacements (dwrite.h)
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 |