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

Recupera os ajustes de par de kerning da tabela kern da fonte.

Sintaxe

HRESULT GetKerningPairAdjustments(
        UINT32       glyphCount,
  [in]  UINT16 const *glyphIndices,
  [out] INT32        *glyphAdvanceAdjustments
);

Parâmetros

glyphCount

Tipo: UINT32

Número de glifos para os qual recuperar ajustes.

[in] glyphIndices

Tipo: const UINT16*

Uma matriz de IDs de glifo para a qual recuperar ajustes.

[out] glyphAdvanceAdjustments

Tipo: INT32*

Os avanços, retornados em unidades de design de fonte, para cada glifo. O último ajuste de glifo é zero.

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

GetKerningPairAdjustments não é uma substituição direta para GetKerningPairs baseado em caracteres da GDI, mas serve à mesma função, sem que o cliente precise armazená-los em cache localmente. GetKerningPairAdjustments também usa ids de glifo diretamente em vez de caracteres UCS-2 (como a tabela kern realmente os armazena), o que evita o colapso e a ambiguidade do glifo, como o traço e o hífen, ou espaço e espaço sem interrupção.

Fontes mais recentes podem ter apenas kerning gpos em vez do kerning de tabela de pares herdado. Tais fontes, como Gabriola, só retornarão 0 para ajustes. GetKerningPairAdjustments não virtualiza e nivela essas entradas GPOS em pares de kerning.

Você pode obter um benefício de desempenho chamando IDWriteFontFace1::HasKerningPairs para determinar se você precisa chamar GetKerningPairAdjustments. Se você chamou anteriormente IDWriteFontFace1::HasKerningPairs e ele retornou FALSE, você pode evitar chamar GetKerningPairAdjustments porque a fonte não tem entradas de tabela de pares de kerning. Ou seja, nesta situação, uma chamada para GetKerningPairAdjustments seria uma no-op.

Requisitos

Confira também

IDWriteFontFace1

IDWriteFontFace1::HasKerningPairs