IDWriteFactory2::TranslateColorGlyphRun 메서드(dwrite_2.h)

이 메서드는 문자 모양 실행에서 호출되어 여러 색 문자 모양 실행으로 변환합니다.

구문

HRESULT TranslateColorGlyphRun(
                 FLOAT                              baselineOriginX,
                 FLOAT                              baselineOriginY,
  [in]           DWRITE_GLYPH_RUN const             *glyphRun,
  [in, optional] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
                 DWRITE_MEASURING_MODE              measuringMode,
  [in, optional] DWRITE_MATRIX const                *worldToDeviceTransform,
                 UINT32                             colorPaletteIndex,
  [out]          IDWriteColorGlyphRunEnumerator     **colorLayers
);

매개 변수

baselineOriginX

형식: FLOAT

원래 문자 모양 실행의 가로 기준선 원점입니다.

baselineOriginY

형식: FLOAT

원래 문자 모양 실행의 세로 기준선 원점입니다.

[in] glyphRun

형식: const DWRITE_GLYPH_RUN*

모노크롬 문자 모양 ID를 포함하는 원래 문자 모양 실행.

[in, optional] glyphRunDescription

형식: const DWRITE_GLYPH_RUN_DESCRIPTION*

선택적 문자 모양 실행 설명입니다.

measuringMode

형식: DWRITE_MEASURING_MODE

실행에 색 문자 모양이 포함된 경우 문자 모양 위치를 계산하는 데 사용되는 측정 모드입니다.

[in, optional] worldToDeviceTransform

형식: const DWRITE_MATRIX*

세계 변환에 DPI 크기 조정을 곱합니다. 이는 실행에 색 문자 모양이 포함되어 있고 측정 모드가 DWRITE_MEASURING_MODE_NATURAL 않은 경우 문자 모양 위치를 계산하는 데 필요합니다. 이 매개 변수가 NULL이고 ID 변환이 가정되는 경우

colorPaletteIndex

형식: UINT32

사용할 색상표의 인덱스(0부터 시작)입니다. 유효한 인덱스는 IDWriteFontFace2::GetColorPaletteCount에서 반환한 대로 글꼴의 색상표 수보다 작습니다.

[out] colorLayers

형식: IDWriteColorGlyphRunEnumerator**

원래 문자 모양 실행에 색 문자 모양이 포함된 경우 이 매개 변수는 IDWriteColorGlyphRunEnumerator 인터페이스에 대한 포인터를 받습니다. 클라이언트는 반환된 인터페이스를 사용하여 문자 모양 실행 및 연결된 색에 대한 정보를 가져와 원래 문자 모양 실행 대신 렌더링합니다. 원래 문자 모양 실행에 색 문자 모양이 없으면 이 메서드는 DWRITE_E_NOCOLOR 반환하고 출력 포인터는 NULL입니다.

반환 값

형식: HRESULT

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

설명

코드가 색 정보가 없는 문자 모양 실행으로 이 메서드를 호출하는 경우 메서드는 DWRITE_E_NOCOLOR 반환하여 애플리케이션이 원래 문자 모양 실행을 그릴 수 있음을 알립니다. 문자 모양 실행에 색 정보가 포함된 경우 함수는 를 통해 열거할 수 있는 개체를 반환하여 실행 및 관련 색을 노출합니다. 그런 다음, 애플리케이션은 반환된 각 문자 모양 실행 및 전경색을 사용하여 DrawGlyphRun 을 호출합니다.

요구 사항

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

참고 항목

IDWriteFactory2