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 |