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 |
추가 정보
개념