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

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

Syntax

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

요청된 픽셀(em당)입니다.

glyphImageFormat

형식: DWRITE_GLYPH_IMAGE_FORMATS

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

[out] glyphData

형식: DWRITE_GLYPH_IMAGE_DATA*

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

[out] glyphDataContext

형식: void**

반환 값

형식: HRESULT

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

비고

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

DWRITE_GLYPH_IMAGE_DATA::uniqueDataId는 동일한 리소스가 두 번 이상 반환되는 경우 데이터를 재분석하거나 압축을 풉니다.

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

요구 사항

참고하십시오

IDWriteFontFace4