다음을 통해 공유


IBitmapFrame.GetPixelDataAsync 메서드

정의

오버로드

GetPixelDataAsync()

프레임의 픽셀 데이터를 비동기적으로 요청합니다. 결과 픽셀 데이터 배열은 BitmapPixelFormatBitmapAlphaMode 속성에 지정된 비트맵 픽셀 형식 및 알파 모드를 사용합니다. 색 관리 및 EXIF 방향도 적용됩니다(자세한 내용은 설명 섹션 참조).

GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

지정된 매개 변수를 사용하여 프레임의 픽셀 데이터를 비동기적으로 요청합니다.

GetPixelDataAsync()

프레임의 픽셀 데이터를 비동기적으로 요청합니다. 결과 픽셀 데이터 배열은 BitmapPixelFormatBitmapAlphaMode 속성에 지정된 비트맵 픽셀 형식 및 알파 모드를 사용합니다. 색 관리 및 EXIF 방향도 적용됩니다(자세한 내용은 설명 섹션 참조).

public:
 IAsyncOperation<PixelDataProvider ^> ^ GetPixelDataAsync();
/// [Windows.Foundation.Metadata.Overload("GetPixelDataAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<PixelDataProvider> GetPixelDataAsync();
[Windows.Foundation.Metadata.Overload("GetPixelDataAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<PixelDataProvider> GetPixelDataAsync();
function getPixelDataAsync()
Public Function GetPixelDataAsync () As IAsyncOperation(Of PixelDataProvider)

반환

픽셀 데이터의 비동기 검색을 관리하는 개체입니다.

특성

설명

애플리케이션에서는 이 메서드에서 반환된 픽셀 데이터가 특정 픽셀 형식 또는 알파 모드(예: 미리 곱한 알파가 있는 Rgba8)를 사용한다고 가정해서는 안 됩니다. 대신 항상 BitmapPixelFormatBitmapAlphaMode 속성을 검사 그에 따라 데이터를 처리해야 합니다.

편의상 이 메서드는 프레임의 포함된 색 공간(있는 경우)에서 sRGB 색 공간까지 색 관리를 수행합니다. 포함된 색 프로필 데이터가 없으면 색 관리가 수행되지 않습니다. 또한 이 메서드는 프레임에서 EXIF 방향 플래그를 읽으려고 시도하며, 있는 경우 픽셀 데이터를 올바르게 방향을 지정하는 데 필요한 변환을 수행합니다.

올바른 비트맵 픽셀 너비와 높이를 검색하려면 애플리케이션에서 PixelWidthPixelHeight 속성 대신 OrientedPixelWidthOrientedPixelHeight 속성을 읽어야 합니다.

이 메서드는 다음 인수를 사용하여 GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) 메서드를 호출하는 것과 같습니다.

인수
*pixelFormat*의 값입니다.

추가 정보

적용 대상

GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

지정된 매개 변수를 사용하여 프레임의 픽셀 데이터를 비동기적으로 요청합니다.

public:
 IAsyncOperation<PixelDataProvider ^> ^ GetPixelDataAsync(BitmapPixelFormat pixelFormat, BitmapAlphaMode alphaMode, BitmapTransform ^ transform, ExifOrientationMode exifOrientationMode, ColorManagementMode colorManagementMode);
/// [Windows.Foundation.Metadata.Overload("GetPixelDataTransformedAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<PixelDataProvider> GetPixelDataAsync(BitmapPixelFormat const& pixelFormat, BitmapAlphaMode const& alphaMode, BitmapTransform const& transform, ExifOrientationMode const& exifOrientationMode, ColorManagementMode const& colorManagementMode);
[Windows.Foundation.Metadata.Overload("GetPixelDataTransformedAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<PixelDataProvider> GetPixelDataAsync(BitmapPixelFormat pixelFormat, BitmapAlphaMode alphaMode, BitmapTransform transform, ExifOrientationMode exifOrientationMode, ColorManagementMode colorManagementMode);
function getPixelDataAsync(pixelFormat, alphaMode, transform, exifOrientationMode, colorManagementMode)
Public Function GetPixelDataAsync (pixelFormat As BitmapPixelFormat, alphaMode As BitmapAlphaMode, transform As BitmapTransform, exifOrientationMode As ExifOrientationMode, colorManagementMode As ColorManagementMode) As IAsyncOperation(Of PixelDataProvider)

매개 변수

pixelFormat
BitmapPixelFormat

지정된 픽셀 형식입니다.

alphaMode
BitmapAlphaMode

지정된 알파 모드입니다.

transform
BitmapTransform

프레임에 적용할 변환 집합입니다.

exifOrientationMode
ExifOrientationMode

EXIF 방향 플래그를 무시하거나 존중해야 하는지 여부를 나타냅니다.

colorManagementMode
ColorManagementMode

픽셀 데이터가 sRGB 색 공간에 대해 색을 관리해야 하는지 여부를 나타냅니다.

반환

픽셀 데이터의 비동기 검색을 관리하는 개체입니다.

특성

설명

애플리케이션에 픽셀 데이터 배열에 대한 세분화된 제어가 필요한 경우 GetPixelDataAsync 대신 이 메서드를 사용해야 합니다.

추가 정보

적용 대상