BitmapFrame.GetPixelDataAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| GetPixelDataAsync() |
프레임의 픽셀 데이터를 비동기적으로 요청합니다. 결과 픽셀 데이터 배열은 BitmapPixelFormat 및 BitmapAlphaMode 속성에 지정된 비트맵 픽셀 형식 및 알파 모드를 사용합니다. 색 관리 및 EXIF 방향도 적용됩니다(자세한 내용은 설명 섹션 참조). |
| GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) |
지정된 매개 변수를 사용하여 프레임의 픽셀 데이터를 비동기적으로 요청합니다. |
GetPixelDataAsync()
프레임의 픽셀 데이터를 비동기적으로 요청합니다. 결과 픽셀 데이터 배열은 BitmapPixelFormat 및 BitmapAlphaMode 속성에 지정된 비트맵 픽셀 형식 및 알파 모드를 사용합니다. 색 관리 및 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)반환
픽셀 데이터의 비동기 검색을 관리하는 개체입니다.
구현
- 특성
설명
픽셀 데이터 배열은 BitmapPixelFormat 및 BitmapAlphaMode 속성에 지정된 비트맵 픽셀 형식 및 알파 모드를 사용합니다. 색 관리 및 EXIF 방향도 적용됩니다.
편의상 이 메서드는 프레임의 포함된 색 공간(있는 경우)에서 sRGB 색 공간까지 색 관리를 수행합니다. 포함된 색 프로필 데이터가 없으면 색 관리가 수행되지 않습니다. 또한 이 메서드는 프레임에서 EXIF 방향 플래그를 읽으려고 시도하며, 있는 경우 픽셀 데이터를 올바르게 방향을 지정하는 데 필요한 변환을 수행합니다.
올바른 비트맵 픽셀 너비와 높이를 검색하려면 애플리케이션에서 PixelWidth 및 PixelHeight 속성 대신 OrientedPixelWidth 및 OrientedPixelHeight 속성을 읽어야 합니다.
이 메서드는 다음 인수를 사용하여 GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) 메서드를 호출하는 것과 같습니다.
| 인수 | 값 |
|---|---|
| pixelFormat | BitmapPixelFormat 속성의 값입니다. |
| alphaMode | BitmapAlphaMode 속성의 값입니다. |
| transform | 빈 변환입니다. |
| exifOrientationMode | ExifOrientationMode 값 RespectExifOrientation입니다. |
| colorManagementMode | ColorManagementMode 값 ColorManageToSRgb입니다. |
추가 정보
- GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)
- PixelDataProvider
- 이미징
- 이미징
적용 대상
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으로 설정하면 결과 픽셀 데이터에 PixelWidth 및 PixelHeight 대신 OrientedPixelWidth 및 OrientedPixelHeight로 정의된 차원이 있습니다. 변환을 적용하는 경우 좌표 공간을 올바르게 처리하는 방법에 대한 자세한 내용은 BitmapTransform 을 참조하세요.