다음을 통해 공유

IWICBitmapFrameEncode::SetThumbnail 메서드(wincodec.h)

  • 아티클

코덱에서 지원하는 경우 프레임 썸네일을 설정합니다.

구문

HRESULT SetThumbnail(
  [in] IWICBitmapSource *pIThumbnail
);

매개 변수

[in] pIThumbnail

형식: IWICBitmapSource*

썸네일로 사용할 비트맵 원본입니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다.

기능이 인코더에서 지원되지 않는 경우 WINCODEC_ERR_UNSUPPORTEDOPERATION 반환합니다.

설명

WritePixels 또는 WriteSource를 호출하기 전에 SetThumbnail을 호출하는 것이 좋습니다. WritePixels 또는 WriteSource를 호출한 후 SetThumbnail이 호출되면 인코딩된 파일에 썸네일이 추가되지 않습니다.

  • BMP, PNG미리 보기 설정은 지원되지 않습니다. 이 함수는 WINCODEC_ERR_UNSUPPORTEDOPERATION 반환합니다.
  • Jpeg축소판 그림 설정이 지원됩니다. 원본 이미지는 8bpp 또는 24bpp JPEG로 다시 인코딩되며 JPEG의 APP1 메타데이터 블록에 기록됩니다.
  • Tiff 축소판 그림 설정이 지원됩니다. 원본 이미지는 TIFF로 다시 인코딩되고 프레임의 SubIFD 블록에 기록됩니다.
  • JPEG-XR축소판 그림 설정이 지원됩니다. 원본 이미지는 추가 8bpp 또는 24bpp 프레임으로 다시 인코딩됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 WINDOWS XP SP2, Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 wincodec.h
라이브러리 Windowscodecs.lib
DLL Windowscodecs.dll

추가 정보

개념

인코딩 개요

WIC-Enabled CODEC를 작성하는 방법

IWICBitmapFrameEncode