Metodo IDWriteFontFace1::GetKerningPairAdjustments (dwrite_1.h)

Recupera le regolazioni della coppia di crenatura dalla tabella crenatura del tipo di carattere.

Sintassi

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

Parametri

glyphCount

Tipo: UINT32

Numero di glifi per cui recuperare le regolazioni.

[in] glyphIndices

Tipo: const UINT16*

Matrice di ID glifo per cui recuperare le modifiche.

[out] glyphAdvanceAdjustments

Tipo: INT32*

I progressi, restituiti nelle unità di progettazione del tipo di carattere, per ogni glifo. L'ultima regolazione del glifo è zero.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

GetKerningPairAdjustments non è una sostituzione diretta per getKerningPairs basato su caratteri GDI, ma serve lo stesso ruolo, senza che il client debba memorizzarli nella cache in locale. GetKerningPairAdjustments usa anche i caratteri dell'ID glifo direttamente anziché UCS-2 (come la tabella crenatura li archivia), evitando così il crollo e l'ambiguità del glifo, ad esempio il trattino e il trattino, o lo spazio e lo spazio non di interruzione.

I tipi di carattere più recenti possono avere solo la crenatura GPOS anziché la crenatura della tabella a coppie legacy. Tali tipi di carattere, come Gabriola, restituiranno solo 0 per le modifiche. GetKerningPairAdjustments non virtualizza e appiattisce queste voci GPOS in coppie di crenatura.

È possibile ottenere un vantaggio per le prestazioni chiamando IDWriteFontFace1::HasKerningPairs per determinare se è necessario chiamare GetKerningPairAdjustments. Se in precedenza è stato chiamato IDWriteFontFace1::HasKerningPairs e ha restituito FALSE, è possibile evitare di chiamare GetKerningPairAdjustments perché il tipo di carattere non ha voci di coppie di coppie di crenatura. In questo caso, una chiamata a GetKerningPairAdjustments sarebbe un no-op.

Requisiti

Vedi anche

IDWriteFontFace1

IDWriteFontFace1::HasKerningPairs