IDWriteTextAnalyzer::GetGdiCompatibleGlyphPlacements 메서드(dwrite.h)
글꼴 및 쓰기 시스템의 렌더링 규칙에 따라 GetGlyphs 메서드에서 문자 모양 출력을 배치합니다.
구문
HRESULT GetGdiCompatibleGlyphPlacements(
[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,
[in] IDWriteFontFace *fontFace,
FLOAT fontEmSize,
FLOAT pixelsPerDip,
[in, optional] DWRITE_MATRIX const *transform,
BOOL useGdiNatural,
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에서 반환된 문자 모양 수입니다.
[in] fontFace
형식: IDWriteFontFace*
출력 문자 모양에 대한 원본인 글꼴 면에 대한 포인터입니다.
fontEmSize
형식: FLOAT
DIP의 논리적 글꼴 크기입니다.
pixelsPerDip
형식: FLOAT
DIP당 실제 픽셀 수입니다.
[in, optional] transform
형식: const DWRITE_MATRIX*
문자 모양 및 해당 위치에 적용되는 선택적 변환입니다. 이 변환은 글꼴 크기 및 pixelsPerDip으로 지정된 크기 조정 후에 적용됩니다.
useGdiNatural
형식: BOOL
FALSE로 설정하면 메트릭은 GDI 별칭 텍스트의 메트릭과 동일합니다. TRUE로 설정하면 메트릭은 CLEARTYPE_NATURAL_QUALITY 사용하여 만든 글꼴을 사용하여 GDI에서 측정한 텍스트 메트릭과 동일합니다.
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 오류 코드를 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | dwrite.h |
| 라이브러리 | Dwrite.lib |
| DLL | Dwrite.dll |