BitmapEncoder.CreateForInPlacePropertyEncodingAsync(BitmapDecoder) 메서드

정의

네임스페이스:

Windows.Graphics.Imaging

현재 위치 속성 및 메타데이터 편집을 위한 새 BitmapEncoder 를 비동기적으로 만듭니다. 새 인코더는 현재 위치에서 비트맵 속성만 편집할 수 있으며 다른 용도로는 실패합니다.

public:
 static IAsyncOperation<BitmapEncoder ^> ^ CreateForInPlacePropertyEncodingAsync(BitmapDecoder ^ bitmapDecoder);

/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<BitmapEncoder> CreateForInPlacePropertyEncodingAsync(BitmapDecoder const& bitmapDecoder);

[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<BitmapEncoder> CreateForInPlacePropertyEncodingAsync(BitmapDecoder bitmapDecoder);

function createForInPlacePropertyEncodingAsync(bitmapDecoder)

Public Shared Function CreateForInPlacePropertyEncodingAsync (bitmapDecoder As BitmapDecoder) As IAsyncOperation(Of BitmapEncoder)

매개 변수

bitmapDecoder

BitmapDecoder

편집할 이미지 데이터가 포함된 BitmapDecoder 입니다. 이 매개 변수는 ReadWrite의 액세스 모드가 있는 스트림에서 만들어야 합니다.

참고

인코더는 원래 BitmapDecoder 가 만들어진 스트림에 씁니다. 출력 스트림을 지정할 수 없습니다.

반환

IAsyncOperation<BitmapEncoder>

기존 BitmapDecoder의 데이터를 사용하여 새 BitmapEncoder의 비동기 초기화를 관리하는 개체입니다.

특성

RemoteAsyncAttribute

설명

이미지에 제한된 양의 속성을 편집하거나 작성하는 데만 사용하려는 경우에만 이 메서드를 사용하여 인코더를 검색합니다. 이 방법으로 검색된 인코더는 전체 이미지를 다시 인코딩하는 대신 빈 안쪽 여백 공간에 새 속성을 쓰기 때문에 CreateForTranscodingAsync 에서 반환된 인코더보다 성능 이점을 제공할 수 있습니다.

이러한 방식으로 검색된 인코더에 대한 몇 가지 제한 사항은 다음과 같습니다.

• 인코더에서만 이러한 메서드를 사용할 수 있습니다.
  • BitmapEncoder.BitmapProperties.GetPropertiesAsync
  • BitmapEncoder.BitmapProperties.SetPropertiesAsync
  • BitmapEncoder.FlushAsync 다른 메서드를 호출하면 실패합니다.
• 입력 BitmapDecoder 는 ReadWrite 액세스 권한이 있는 스트림에서 만든 인코더여야 합니다.
• 모든 메타데이터 형식이 빠른 메타데이터 인코딩을 지원하는 것은 아닙니다. 메타데이터를 지원하는 네이티브 메타데이터 처리기는 IFD, Exif, XMP 및 GPS입니다.
• 메타데이터 블록에는 편집하려는 속성을 저장할 충분한 패딩이 있어야 합니다. 어떤 이유로든 인코딩 작업이 실패하는 경우 CreateForTranscodingAsync를 사용하여 메타데이터를 편집하고 이미지를 다시 인코딩해야 합니다. 다시 인코딩할 때 새 패딩 또는 추가 패딩을 추가하여 나중에 현재 위치 속성 인코딩을 사용하도록 설정할 수도 있습니다. 이렇게 하려면 형식이 UInt32로 설정되고 값이 추가하려는 패딩 바이트 수로 설정된 새 BitmapTypedValue 를 만듭니다. 일반적인 값은 4096바이트입니다. 이 테이블의 메타데이터 쿼리 위치 중 하나 이상에서 이 메타데이터 항목을 설정합니다.

  메타데이터 형식	JPEG 메타데이터 쿼리	TIFF, JPEG-XR 메타데이터 쿼리
  IFD	/app1/ifd/PaddingSchema:Padding	/ifd/PaddingSchema:Padding
  Exif	/app1/ifd/exif/PaddingSchema:Padding	/ifd/exif/PaddingSchema:Padding
  Xmp	/xmp/PaddingSchema:Padding	/ifd/xmp/PaddingSchema:Padding
  GPS	/app1/ifd/gps/PaddingSchema:Padding	/ifd/gps/PaddingSchema:Padding