Método IDWriteFontFace1::GetGdiCompatibleGlyphAdvances (dwrite_1.h)

Retorna os avanços alinhados a pixels para uma sequência de glifos.

Sintaxe

HRESULT GetGdiCompatibleGlyphAdvances(
                 FLOAT               emSize,
                 FLOAT               pixelsPerDip,
  [in, optional] DWRITE_MATRIX const *transform,
                 BOOL                useGdiNatural,
                 BOOL                isSideways,
                 UINT32              glyphCount,
  [in]           UINT16 const        *glyphIndices,
  [out]          INT32               *glyphAdvances
);

Parâmetros

emSize

Tipo: FLOAT

Tamanho lógico da fonte em unidades DIP. Um DIP ("pixel independente do dispositivo") é igual a 1/96 polegada.

pixelsPerDip

Tipo: FLOAT

Número de pixels físicos por DIP. Por exemplo, se o DPI da superfície de renderização for 96, esse valor será 1,0f. Se o DPI for 120, esse valor será 120.0f/96.

[in, optional] transform

Tipo: const DWRITE_MATRIX*

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 FALSE, as métricas são iguais ao texto com alias GDI (DWRITE_MEASURING_MODE_GDI_CLASSIC). Quando TRUE, as métricas são as mesmas medidas pelo GDI usando uma fonte usando CLEARTYPE_NATURAL_QUALITY (DWRITE_MEASURING_MODE_GDI_NATURAL).

isSideways

Tipo: BOOL

Recupere os avanços verticais do glifo em vez de avanços horizontais.

glyphCount

Tipo: UINT32

Total de glifos para o qual recuperar ajustes.

[in] glyphIndices

Tipo: const UINT16*

Uma matriz de IDs de glifo para recuperar avanços.

[out] glyphAdvances

Tipo: const INT32*

Os avanços retornados em unidades de design de fonte para 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.

Comentários

Isso é equivalente a chamar GetGdiCompatibleGlyphMetrics e usar apenas a largura e a altura avançadas.

Assim como GetGdiCompatibleGlyphMetrics, eles estão em unidades de design, o que significa que eles devem ser reduzidos verticalmente por DWRITE_FONT_METRICS::d esignUnitsPerEm.

Requisitos

Confira também

IDWriteFontFace1