IDWriteTextAnalyzer1::GetJustifiedGlyphs 메서드(dwrite_1.h)

정당화가 카시다 아랍어와 같은 문자 모양의 발전을 증가 복잡한 스크립트에 대한 새로운 문자 모양을 채웁니다.

구문

HRESULT GetJustifiedGlyphs(
                  IDWriteFontFace                       *fontFace,
                  FLOAT                                 fontEmSize,
                  DWRITE_SCRIPT_ANALYSIS                scriptAnalysis,
                  UINT32                                textLength,
                  UINT32                                glyphCount,
                  UINT32                                maxGlyphCount,
  [in, optional]  UINT16 const                          *clusterMap,
  [in]            UINT16 const                          *glyphIndices,
  [in]            FLOAT const                           *glyphAdvances,
  [in]            FLOAT const                           *justifiedGlyphAdvances,
  [in]            DWRITE_GLYPH_OFFSET const             *justifiedGlyphOffsets,
  [in]            DWRITE_SHAPING_GLYPH_PROPERTIES const *glyphProperties,
  [out]           UINT32                                *actualGlyphCount,
  [out, optional] UINT16                                *modifiedClusterMap,
  [out]           UINT16                                *modifiedGlyphIndices,
  [out]           FLOAT                                 *modifiedGlyphAdvances,
  [out]           DWRITE_GLYPH_OFFSET                   *modifiedGlyphOffsets
);

매개 변수

fontFace

형식: IDWriteFontFace*

셰이핑에 사용되는 글꼴 얼굴입니다.

NULL일 수 있습니다.

fontEmSize

형식: FLOAT

문자 모양 실행에 사용되는 글꼴 em 크기입니다.

scriptAnalysis

형식: DWRITE_SCRIPT_ANALYSIS

항목 변환기에서 텍스트의 스크립트입니다.

textLength

형식: UINT32

텍스트의 길이입니다.

glyphCount

형식: UINT32

문자 모양 수입니다.

maxGlyphCount

형식: UINT32

호출자가 할당한 최대 출력 문자 모양 수입니다.

[in, optional] clusterMap

형식: const UINT16*

셰이핑에서 생성된 Clustermap입니다.

[in] glyphIndices

형식: const UINT16*

셰이핑에서 생성된 원래 문자 모양입니다.

[in] glyphAdvances

형식: const FLOAT*

원래 문자 모양은 셰이핑에서 생성됩니다.

[in] justifiedGlyphAdvances

형식: const FLOAT*

IDWriteTextAnalyzer1::JustifyGlyphAdvances에서 양쪽 문자 모양이 진행됩니다.

[in] justifiedGlyphOffsets

형식: const DWRITE_GLYPH_OFFSET*

IDWriteTextAnalyzer1::JustifyGlyphAdvances의 양쪽 문자 모양 오프셋입니다.

[in] glyphProperties

형식: const DWRITE_SHAPING_GLYPH_PROPERTIES*

IDWriteTextAnalyzer::GetGlyphs의 각 문자 모양 속성입니다.

[out] actualGlyphCount

형식: UINT32*

수정된 배열에 기록된 새 문자 모양 개수 또는 크기가 충분히 크지 않은 경우 필요한 문자 모양 수입니다.

[out, optional] modifiedClusterMap

형식: UINT16*

클러스터맵이 업데이트되었습니다.

[out] modifiedGlyphIndices

형식: UINT16*

필요한 경우 새 문자 모양이 삽입된 문자 모양을 업데이트했습니다.

[out] modifiedGlyphAdvances

형식: FLOAT*

문자 모양이 업데이트되었습니다.

[out] modifiedGlyphOffsets

형식: DWRITE_GLYPH_OFFSET*

문자 모양 오프셋이 업데이트되었습니다.

반환 값

형식: HRESULT

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

설명

줄이 양쪽 맞춤된 후 GetJustifiedGlyphs 를 호출하고 실행당 입니다.

IDWriteTextAnalyzer1::GetScriptProperties가 해당 스크립트에 대해 null이 아닌 DWRITE_SCRIPT_PROPERTIES.justificationCharacter를 반환하는 경우 GetJustifiedGlyphs를 호출해야 합니다.

아랍어와 같은 필기체 스크립트에는 GetJustifiedGlyphs 를 주로 사용합니다. maxGlyphCount가 충분히 크지 않으면 GetJustifiedGlyphs는 오류 E_NOT_SUFFICIENT_BUFFER 반환하고 actualGlyphCount가 가리키는 변수를 필요한 문자 모양 수로 채웁니다.

요구 사항

지원되는 최소 클라이언트	Windows 7용 Windows 8 및 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2012 및 Windows Server 2008 R2용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	dwrite_1.h
라이브러리	Dwrite.lib
DLL	Dwrite.dll

추가 정보

IDWriteTextAnalyzer1

IDWriteTextAnalyzer1::GetScriptProperties

IDWriteTextAnalyzer1::JustifyGlyphAdvances

IDWriteTextAnalyzer::GetGlyphs