IDWriteTextAnalyzer::GetGlyphPlacements 메서드(dwrite.h)

글꼴 및 쓰기 시스템의 렌더링 규칙에 따라 GetGlyphs 메서드의 문자 모양을 Places.

구문

HRESULT GetGlyphPlacements(
  [in]           WCHAR const                           *textString,
  [in]           UINT16 const                          *clusterMap,
  [in]           DWRITE_SHAPING_TEXT_PROPERTIES        *textProps,
                 UINT32                                textLength,
  [in]           UINT16 const                          *glyphIndices,
  [in]           DWRITE_SHAPING_GLYPH_PROPERTIES const *glyphProps,
                 UINT32                                glyphCount,
                 IDWriteFontFace                       *fontFace,
                 FLOAT                                 fontEmSize,
                 BOOL                                  isSideways,
                 BOOL                                  isRightToLeft,
  [in]           DWRITE_SCRIPT_ANALYSIS const          *scriptAnalysis,
  [in, optional] WCHAR const                           *localeName,
  [in, optional] DWRITE_TYPOGRAPHIC_FEATURES const     **features,
  [in, optional] UINT32 const                          *featureRangeLengths,
                 UINT32                                featureRanges,
  [out]          FLOAT                                 *glyphAdvances,
  [out]          DWRITE_GLYPH_OFFSET                   *glyphOffsets
);

매개 변수

[in] textString

형식: const WCHAR*

문자 모양이 제공된 원래 문자열을 포함하는 문자 배열입니다.

[in] clusterMap

형식: const UINT16*

문자 범위에서 문자 모양 범위로의 매핑에 대한 포인터입니다. GetGlyphs에서 반환됩니다.

[in] textProps

형식: DWRITE_SHAPING_TEXT_PROPERTIES*

각 문자에 대한 셰이핑 속성을 포함하는 구조체 배열에 대한 포인터입니다. 이 구조체는 GetGlyphs에서 반환됩니다.

textLength

형식: UINT32

textString의 텍스트 길이입니다.

[in] glyphIndices

형식: const UINT16*

GetGlyphs에서 반환된 문자 모양 인덱스의 배열입니다.

[in] glyphProps

형식: const DWRITE_SHAPING_GLYPH_PROPERTIES*

GetGlyphs에서 반환된 각 문자 모양에 대한 셰이핑 속성을 포함하는 구조체 배열에 대한 포인터입니다.

glyphCount

형식: UINT32

GetGlyphs에서 반환된 문자 모양 수입니다.

fontFace

형식: IDWriteFontFace*

출력 문자 모양에 대한 원본인 글꼴 면에 대한 포인터입니다.

fontEmSize

형식: FLOAT

DIP의 논리적 글꼴 크기입니다.

isSideways

형식: BOOL

텍스트를 세로로 그리려는 경우 부울 플래그가 TRUE 로 설정됩니다.

isRightToLeft

형식: BOOL

오른쪽에서 왼쪽 텍스트에 대해 TRUE 로 설정된 부울 플래그입니다.

[in] scriptAnalysis

형식: const DWRITE_SCRIPT_ANALYSIS*

AnalyzeScript 호출의 스크립트 분석 결과에 대한 포인터입니다.

[in, optional] localeName

형식: const WCHAR*

문자 모양을 선택할 때 사용할 로캘이 포함된 문자 배열입니다. 예를 들어 동일한 문자는 ja-jp와 zh-chs의 다른 문자 모양에 매핑할 수 있습니다. NULL인 경우 스크립트를 기반으로 하는 기본 매핑이 사용됩니다.

[in, optional] features

형식: const DWRITE_TYPOGRAPHIC_FEATURES**

각 기능 범위에서 사용할 입력 기능 집합에 대한 포인터 배열입니다.

[in, optional] featureRangeLengths

형식: const UINT32*

각 기능 범위의 길이(문자)입니다.
모든 길이의 합계는 textLength와 같아야 합니다.

featureRanges

형식: UINT32

기능 범위의 수입니다.

[out] glyphAdvances

형식: FLOAT*

이 메서드가 반환되면 각 문자 모양의 사전 너비가 포함됩니다.

[out] glyphOffsets

형식: DWRITE_GLYPH_OFFSET*

이 메서드가 반환되면 각 문자 모양의 원점 오프셋이 포함됩니다.

반환 값

형식: HRESULT

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

요구 사항

추가 정보

IDWriteTextAnalyzer