다음을 통해 공유


BitmapFrame.GetPixelDataAsync 메서드

정의

오버로드

GetPixelDataAsync()

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

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

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

GetPixelDataAsync()

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

public:
 virtual IAsyncOperation<PixelDataProvider ^> ^ GetPixelDataAsync() = 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)

반환

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

구현

특성

설명

픽셀 데이터 배열은 BitmapPixelFormatBitmapAlphaMode 속성에 지정된 비트맵 픽셀 형식 및 알파 모드를 사용합니다. 색 관리 및 EXIF 방향도 적용됩니다.

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

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

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

인수
pixelFormat BitmapPixelFormat 속성의 값입니다.
alphaMode BitmapAlphaMode 속성의 값입니다.
transform 빈 변환입니다.
exifOrientationMode ExifOrientationModeRespectExifOrientation입니다.
colorManagementMode ColorManagementModeColorManageToSRgb입니다.

추가 정보

적용 대상

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

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

public:
 virtual IAsyncOperation<PixelDataProvider ^> ^ GetPixelDataAsync(BitmapPixelFormat pixelFormat, BitmapAlphaMode alphaMode, BitmapTransform ^ transform, ExifOrientationMode exifOrientationMode, ColorManagementMode colorManagementMode) = GetPixelDataAsync;
/// [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 대신 이 메서드를 사용해야 합니다.

exifOrientationMode 매개 변수를 RespectExifOrientation으로 설정하면 결과 픽셀 데이터에 PixelWidthPixelHeight 대신 OrientedPixelWidthOrientedPixelHeight로 정의된 차원이 있습니다. 변환을 적용하는 경우 좌표 공간을 올바르게 처리하는 방법에 대한 자세한 내용은 BitmapTransform 을 참조하세요.

추가 정보

적용 대상