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