IDWriteFontFace4::GetGlyphImageData 메서드(dwrite_3.h)

원하는 이미지 형식에 따라 문자 모양 데이터에 대한 포인터를 가져옵니다.

구문

HRESULT GetGlyphImageData(
  [in]  UINT16                     glyphId,
        UINT32                     pixelsPerEm,
        DWRITE_GLYPH_IMAGE_FORMATS glyphImageFormat,
  [out] DWRITE_GLYPH_IMAGE_DATA    *glyphData,
  [out] void                       **glyphDataContext
);

매개 변수

[in] glyphId

형식: UINT16

이미지 데이터를 검색할 문자 모양 ID입니다.

pixelsPerEm

형식: UINT32

요청된 픽셀 수입니다.

glyphImageFormat

형식: DWRITE_GLYPH_IMAGE_FORMATS

글꼴에서 지원되는 형식을 지정합니다.

[out] glyphData

형식: DWRITE_GLYPH_IMAGE_DATA*

반환 시 문자 모양에 대한 데이터가 포함됩니다.

[out] glyphDataContext

형식: void**

반환 값

형식: HRESULT

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

설명

데이터가 비어 있지 않은 경우, IDWriteFontFileStream::ReadFileFragment 및 IDWriteFontFileStream::ReleaseFileFragment와 유사하면 glyphDataContext를 ReleaseGlyphImageData를 통해 릴리스해야 합니다. 데이터 포인터는 IDWriteFontFace 가 존재하고 ReleaseGlyphImageData 가 호출되지 않은 한 유효합니다.

DWRITE_GLYPH_IMAGE_DATA::uniqueDataId는 동일한 리소스가 두 번 이상 반환되는 경우 데이터를 재분석하거나 압축을 풀지 않고도 기존 리소스를 신속하게 검색할 수 있도록 캐싱 목적으로 유용합니다.

함수는 SVG 또는 래스터 데이터만 반환합니다. TrueType/CFF/COLR 데이터를 요청하면 DWRITE_E_INVALIDARG 반환됩니다. 대신 GetGlyphOutline을 사용하여 DrawGlyphRun을 통해 그리거나 쿼리해야 합니다. 정확히 하나의 형식이 요청되거나 함수가 DWRITE_E_INVALIDARG 반환할 수 있습니다. 문자 모양에 해당 형식이 없으면 호출은 오류가 아니지만 함수는 빈 데이터를 반환합니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	dwrite_3.h
라이브러리	Dwrite.lib

추가 정보

IDWriteFontFace4