IDWriteFontFace1::GetKerningPairAdjustments 메서드(dwrite_1.h)

글꼴의 커널 테이블에서 커닝 쌍 조정을 검색합니다.

구문

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

매개 변수

glyphCount

형식: UINT32

조정을 검색할 문자 모양 수입니다.

[in] glyphIndices

형식: const UINT16*

조정을 검색할 문자 모양 ID의 배열입니다.

[out] glyphAdvanceAdjustments

형식: INT32*

각 문자 모양에 대해 글꼴 디자인 단위로 반환되는 어드밴스입니다. 마지막 문자 모양 조정은 0입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

GetKerningPairAdjustments 는 GDI의 문자 기반 GetKerningPairs를 직접 대체하는 것은 아니지만 클라이언트가 로컬로 캐시할 필요 없이 동일한 역할을 합니다. GetKerningPairAdjustments 는 또한 UCS-2 문자(커른 테이블이 실제로 저장하는 방법)가 아닌 문자 모양 ID를 직접 사용하므로 대시 및 하이픈과 같은 문자 모양 축소 및 모호성, 공백 및 끊기지 않는 공간을 방지합니다.

최신 글꼴에는 레거시 쌍 테이블 커닝 대신 GPOS 커닝만 있을 수 있습니다. 가브리올라와 같은 이러한 글꼴은 조정을 위해 0만 반환합니다. GetKerningPairAdjustments 는 이러한 GPOS 항목을 가상화하고 커닝 쌍으로 평면화하지 않습니다.

IDWriteFontFace1::HasKerningPairs를 호출하여 GetKerningPairAdjustments를 호출해야 하는지 여부를 확인하여 성능 이점을 실현할 수 있습니다. 이전에 IDWriteFontFace1::HasKerningPairs를 호출하고 FALSE를 반환한 경우 글꼴에 커닝 쌍 테이블 항목이 없으므로 GetKerningPairAdjustments 를 호출하지 않아도 됩니다. 즉, 이 상황에서 GetKerningPairAdjustments 에 대한 호출은 no-op이 될 것입니다.

요구 사항

추가 정보

IDWriteFontFace1

IDWriteFontFace1::HasKerningPairs