ID2D1DeviceContext4::GetSvgGlyphImage 메서드(d2d1_3.h)

색 문자 모양 캐시에서 SVG 문자 모양 이미지를 검색합니다. 캐시에 요청된 리소스가 아직 포함되어 있지 않으면 캐시가 만들어집니다. 이 메서드는 색 문자 모양 캐시에서 제거된 후에도 문자 모양 이미지의 수명을 연장하는 데 사용할 수 있습니다.

구문

HRESULT GetSvgGlyphImage(
                 D2D1_POINT_2F           glyphOrigin,
  [in]           IDWriteFontFace         *fontFace,
                 FLOAT                   fontEmSize,
                 UINT16                  glyphIndex,
                 BOOL                    isSideways,
  [in, optional] const D2D1_MATRIX_3X2_F *worldTransform,
  [in, optional] ID2D1Brush              *defaultFillBrush,
  [in, optional] ID2D1SvgGlyphStyle      *svgGlyphStyle,
                 UINT32                  colorPaletteIndex,
  [out]          D2D1_MATRIX_3X2_F       *glyphTransform,
  [out]          ID2D1CommandList        **glyphImage
);

매개 변수

glyphOrigin

형식: D2D1_POINT_2F

문자 모양의 원점입니다.

[in] fontFace

형식: IDWriteFontFace*

글꼴 얼굴 유형, 적절한 파일 참조, 얼굴 식별 데이터 및 메트릭, 이름 및 문자 모양 윤곽선과 같은 다양한 글꼴 데이터가 포함된 글꼴 면에 대한 참조입니다.

fontEmSize

형식: FLOAT

지정한 글꼴 크기는 출력 문자 모양Transform에 영향을 주어 문자 모양 크기를 적절하게 조정합니다.

glyphIndex

형식: UINT16

검색할 문자 모양의 인덱스입니다.

isSideways

형식: BOOL

true이면 문자 모양이 왼쪽으로 90도 회전되고 세로 메트릭이 사용되도록 지정합니다. 세로 쓰기는 isSideways를 true로 지정하고 회전 변환을 통해 전체 실행을 오른쪽으로 90도 회전하여 달성됩니다.

[in, optional] worldTransform

형식: const D2D1_MATRIX_3X2_F*

이미지에 적용할 변환입니다.

[in, optional] defaultFillBrush

형식: ID2D1Brush*

영역을 그리는 방법을 설명합니다.

[in, optional] svgGlyphStyle

형식: ID2D1SvgGlyphStyle*

SVG 문자 모양을 렌더링할 때 사용되는 컨텍스트 채우기, 컨텍스트 스트로크 및 컨텍스트 값에 대한 값입니다.

colorPaletteIndex

형식: UINT32

색 글꼴 내에서 색상표를 선택하는 데 사용되는 인덱스입니다. 이는 SVG 문자 모양과 관련이 없는 DWRITE_COLOR_GLYPH_RUN 구조체의 paletteIndex와 동일하지 않습니다.

[out] glyphTransform

형식: D2D1_MATRIX_3X2_F*

출력 변환 - 문자 모양 공간에서 worldTransform과 동일한 출력 공간으로 변환됩니다. 여기에는 입력 glyphOrigin, glyphOrigin의 문자 모양 오프셋 및 기타 필요한 변환이 포함됩니다.

[out] glyphImage

형식: ID2D1CommandList**

완료되면 검색된 문자 모양 이미지를 포함합니다.

반환 값

형식: HRESULT

이 메서드는 HRESULT 성공 또는 오류 코드를 반환합니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	d2d1_3.h
DLL	D2d1.dll

추가 정보

ID2D1DeviceContext4