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 |