BitmapEncoder.IsThumbnailGenerated 속성

정의

네임스페이스:

Windows.Graphics.Imaging

새 축소판 그림이 자동으로 생성되는지 여부를 나타냅니다.

public:
 property bool IsThumbnailGenerated { bool get(); void set(bool value); };

bool IsThumbnailGenerated();

void IsThumbnailGenerated(bool value);

public bool IsThumbnailGenerated { get; set; }

var boolean = bitmapEncoder.isThumbnailGenerated;
bitmapEncoder.isThumbnailGenerated = boolean;

Public Property IsThumbnailGenerated As Boolean

속성 값

Boolean

bool

비트맵 인코더가 새 썸네일을 자동으로 생성할지 여부를 나타내는 값입니다. 기본값은 False입니다.

설명

이 값이 true이면 비트맵 인코더는 프레임 비트맵을 축소하여 새 썸네일을 생성합니다. 축소판 그림 크기는 GeneratedThumbnailWidth 및 GeneratedThumbnailHeight 속성에 의해 결정됩니다. 이 값이 false이면 파일에 미리 보기가 기록되지 않습니다.

CreateForTranscodingAsync 메서드를 사용하여 BitmapEncoder를 만들고 IsThumbnailGenerated가 false이면 비트맵 인코더는 기존 미리 보기 데이터를 그대로 유지합니다. 이 경우 인코딩하기 전에 비트맵을 수정한 경우 출력 파일에 이미지의 새 내용과 일치하지 않는 축소판 그림이 있을 수 있습니다.

JPEG, TIFF 및 JPEG-XR 이미지 형식만 썸네일 인코딩을 지원합니다. 인코딩되는 이미지 형식이 썸네일을 지원하지 않고 IsThumbnailGenerated를 true로 설정하면 HRESULT WINCODEC_ERR_UNSUPPORTEDOPERATIONFlushAsync 호출이 실패합니다. 이 예외를 catch하고 미리 보기 생성을 사용하지 않도록 설정한 상태에서 인코딩을 다시 시도해야 합니다. 앱이 축소판 그림을 지원하는 이미지 형식만 인코딩하는 경우 이 단계를 건너뛸 수 있습니다.

try
 {
     await encoder.FlushAsync();
 }
 catch (Exception err)
 {
     switch (err.HResult)
     {
         case unchecked ((int) 0x88982F81): //WINCODEC_ERR_UNSUPPORTEDOPERATION
             // If the encoder does not support writing a thumbnail, then try again
             // but disable thumbnail generation.
             encoder.IsThumbnailGenerated = false;
             break;
         default:
             throw err;
     }
 }

 if (encoder.IsThumbnailGenerated == false)
 {
     await encoder.FlushAsync();
 }