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

Recupera los ajustes del par de kerning de la tabla kern de la fuente.

Sintaxis

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

Parámetros

glyphCount

Tipo: UINT32

Número de glifos para los que recuperar los ajustes.

[in] glyphIndices

Tipo: const UINT16*

Matriz de identificadores de glifo para recuperar ajustes.

[out] glyphAdvanceAdjustments

Tipo: INT32*

Los avances, devueltos en unidades de diseño de fuente, para cada glifo. El último ajuste del glifo es cero.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

GetKerningPairAdjustments no es un reemplazo directo de GetKerningPairs basado en caracteres de GDI, pero actúa como el mismo rol, sin que el cliente necesite almacenarlos en caché localmente. GetKerningPairAdjustments también usa los caracteres de id. de glifo directamente en lugar de UCS-2 (cómo la tabla kern realmente los almacena), lo que evita el colapso del glifo y la ambigüedad, como el guión y el guión, o el espacio y el espacio no importante.

Las fuentes más recientes pueden tener solo el kerning de GPOS en lugar del kerning heredado de la tabla de pares. Estas fuentes, como Gabriola, solo devolverán 0 para ajustes. GetKerningPairAdjustments no virtualiza ni aplana estas entradas de GPOS en pares de kerning.

Puede obtener una ventaja de rendimiento llamando a IDWriteFontFace1::HasKerningPairs para determinar si necesita llamar a GetKerningPairAdjustments. Si anteriormente llamó a IDWriteFontFace1::HasKerningPairs y devolvió FALSE, puede evitar llamar a GetKerningPairAdjustments porque la fuente no tiene entradas de tabla de pares de kerning. Es decir, en esta situación, una llamada a GetKerningPairAdjustments sería una operación no operativa.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 y Actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	dwrite_1.h
Library	Dwrite_1.lib
Archivo DLL	Dwrite_1.dll

Consulte también

IDWriteFontFace1

IDWriteFontFace1::HasKerningPairs