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

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

구문

HRESULT GetColorBitmapGlyphImage(
                 DWRITE_GLYPH_IMAGE_FORMATS glyphImageFormat,
                 D2D1_POINT_2F              glyphOrigin,
  [in]           IDWriteFontFace            *fontFace,
                 FLOAT                      fontEmSize,
                 UINT16                     glyphIndex,
                 BOOL                       isSideways,
  [in, optional] const D2D1_MATRIX_3X2_F    *worldTransform,
                 FLOAT                      dpiX,
                 FLOAT                      dpiY,
  [out]          D2D1_MATRIX_3X2_F          *glyphTransform,
  [out]          ID2D1Image                 **glyphImage
);

매개 변수

glyphImageFormat

형식: DWRITE_GLYPH_IMAGE_FORMATS

문자 모양 이미지의 형식입니다. 요청된 문자 모양에 대해 요청된 형식의 이미지 데이터가 없으면 이 메서드는 오류를 반환합니다.

glyphOrigin

형식: D2D1_POINT_2F

문자 모양에 대한 원점입니다.

[in] fontFace

형식: IDWriteFontFace*

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

fontEmSize

형식: FLOAT

지정된 글꼴 크기는 글꼴에서 사용할 비트맵의 선택에 영향을 줍니다. 또한 출력 glyphTransform에 영향을 주어 문자 모양 크기를 적절하게 조정합니다.

glyphIndex

형식: UINT16

문자 모양 인덱스입니다.

isSideways

형식: BOOL

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

[in, optional] worldTransform

형식: const D2D1_MATRIX_3X2_F*

이미지에 적용할 변환입니다. 이 입력 변환은 글꼴에서 사용할 비트맵의 선택에 영향을 줍니다. 또한 출력 glyphTransform에 고려됩니다.

dpiX

형식: FLOAT

x축을 따라 인치당 점 수입니다.

dpiY

형식: FLOAT

y축을 따라 인치당 점 수입니다.

[out] glyphTransform

형식: D2D1_MATRIX_3X2_F*

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

[out] glyphImage

형식: ID2D1Image**

완료 시 검색된 문자 모양 이미지가 포함됩니다.

반환 값

형식: HRESULT

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

요구 사항

대상 플랫폼	Windows
헤더	d2d1_3.h
DLL	D2d1.dll

추가 정보

ID2D1DeviceContext4