IDWriteFactory4::TranslateColorGlyphRun 메서드(dwrite_3.h)

문자 모양 실행을 원래 "기본" 실행의 색 표현을 생성하도록 렌더링할 수 있는 색 문자 모양 실행 시퀀스로 변환합니다.

구문

HRESULT TranslateColorGlyphRun(
                 D2D1_POINT_2F                      baselineOrigin,
  [in]           DWRITE_GLYPH_RUN const             *glyphRun,
  [in, optional] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
                 DWRITE_GLYPH_IMAGE_FORMATS         desiredGlyphImageFormats,
                 DWRITE_MEASURING_MODE              measuringMode,
  [in, optional] DWRITE_MATRIX const                *worldAndDpiTransform,
                 UINT32                             colorPaletteIndex,
  [out]          IDWriteColorGlyphRunEnumerator1    **colorLayers
);

매개 변수

baselineOrigin

형식: D2D1_POINT_2F

기본 문자 모양의 가로 및 세로 원점은 변환 전 좌표에서 실행됩니다.

[in] glyphRun

형식: DWRITE_GLYPH_RUN

원래 "기본" 문자 모양 실행에 대한 포인터입니다.

[in, optional] glyphRunDescription

형식: DWRITE_GLYPH_RUN_DESCRIPTION

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

desiredGlyphImageFormats

형식: DWRITE_GLYPH_IMAGE_FORMATS

실행 형식을 분할해야 하는 데이터 형식입니다.

measuringMode

형식: DWRITE_MEASURING_MODE

각 문자 모양의 원점 계산에 필요한 측정 모드입니다.

[in, optional] worldAndDpiTransform

형식: DWRITE_MATRIX

클라이언트의 좌표 공간에서 디바이스 좌표(픽셀)로 변환하는 행렬, 즉 전 세계 변환에 DPI 크기 조정을 곱합니다.

colorPaletteIndex

형식: UINT32

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

[out] colorLayers

형식: IDWriteColorGlyphRunEnumerator1**

함수가 성공하면 는 색 문자 모양 실행을 가져오는 데 사용할 수 있는 열거자 개체에 대한 포인터를 받습니다. 기본 실행에 색 문자 모양이 없는 경우 출력 포인터는 NULL이고 메서드는 DWRITE_E_NOCOLOR 반환합니다.

반환 값

형식: HRESULT

글꼴에 색 정보가 없거나 문자 모양 실행에 색 문자 모양이 없거나 지정된 색상표 인덱스가 범위를 벗어나면 DWRITE_E_NOCOLOR 반환합니다. 이 경우 클라이언트는 원래 문자 모양 실행을 렌더링해야 합니다. 그렇지 않으면 표준 HRESULT 오류 코드를 반환합니다.

설명

IDWriteFactory2::TranslateColorGlyphRun을 호출하는 것은 IDWriteFactory4::TranslateColorGlyph 실행을 지정된 형식으로 호출하는 것과 같습니다. DWRITE_GLYPH_IMAGE_FORMATS_TRUETYPE|DWRITE_GLYPH_IMAGE_FORMATS_CFF|DWRITE_GLYPH_IMAGE_FORMATS_COLR.

요구 사항

대상 플랫폼	Windows
헤더	dwrite_3.h
라이브러리	Dwrite.lib

추가 정보

IDWriteFactory4