SoftwareBitmap 클래스

정의

네임스페이스:

Windows.Graphics.Imaging

압축되지 않은 비트맵을 나타냅니다.

public ref class SoftwareBitmap sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.GCPressure]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Graphics.Imaging.ISoftwareBitmapFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class SoftwareBitmap final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.GCPressure]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Graphics.Imaging.ISoftwareBitmapFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SoftwareBitmap : System.IDisposable

function SoftwareBitmap(format, width, height, alpha)

Public NotInheritable Class SoftwareBitmap
Implements IDisposable

상속

Object Platform::Object IInspectable SoftwareBitmap

특성

ActivatableAttribute ContractVersionAttribute GCPressureAttribute MarshalingBehaviorAttribute ThreadingAttribute

구현

IClosable IDisposable

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

이 클래스를 사용하는 샘플 애플리케이션에는 카메라 프레임 샘플이 포함됩니다.

픽셀 데이터에 액세스하는 방법을 보여 주는 코드 예제는 WriteableBitmap.PixelBuffer 속성( CopyToBuffer 및 CopyFromBuffer 참조)을 참조하세요.

설명

이 클래스는 다양한 이미징 API에서 쉽게 사용할 수 있는 비트맵의 표현을 제공합니다. GetSoftwareBitmapAsync를 사용하여 이미지 파일과 같은 스트림 리소스에서 SoftwareBitmap을 만듭니다.

CopyToBuffer 및 CopyFromBuffer를 사용하여 SoftwareBitmap과 WriteableBitmap의 PixelBuffer 간에 픽셀 데이터를 앞뒤로 복사합니다. CreateCopyFromSurfaceAsync를 사용하여 IDirect3DSurface에서 SoftwareBitmap을 만듭니다. ISoftwareBitmapNativeFactory::CreateFromMF2DBuffer2를 사용하여 IMF2DBuffer2에서 SoftwareBitmap을 만듭니다. IWICBitmap에서 SoftwareBitmap을 만들려면 ISoftwareBitmapNativeFactory::CreateFromIWICBitmap을 사용합니다.

생성자

SoftwareBitmap(BitmapPixelFormat, Int32, Int32)	SoftwareBitmap 클래스의 새 instance 초기화합니다.
SoftwareBitmap(BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	SoftwareBitmap 클래스의 새 instance 초기화합니다.

속성

BitmapAlphaMode	소프트웨어 비트맵의 알파 모드를 가져옵니다.
BitmapPixelFormat	소프트웨어 비트맵의 픽셀 형식을 가져옵니다.
DpiX	X 방향으로 소프트웨어 비트맵의 인치당 점을 가져오거나 설정합니다.
DpiY	Y 방향으로 소프트웨어 비트맵의 인치당 점을 가져오거나 설정합니다.
IsReadOnly	소프트웨어 비트맵을 수정할 수 있는지 여부를 나타내는 값을 가져옵니다.
PixelHeight	소프트웨어 비트맵의 높이를 픽셀 단위로 가져옵니다.
PixelWidth	소프트웨어 비트맵의 너비를 픽셀 단위로 가져옵니다.

메서드

Close()	개체 및 연결된 리소스를 삭제합니다.
Convert(SoftwareBitmap, BitmapPixelFormat)	기존 SoftwareBitmap 을 다른 픽셀 형식의 SoftwareBitmap 으로 변환합니다.
Convert(SoftwareBitmap, BitmapPixelFormat, BitmapAlphaMode)	기존 SoftwareBitmap 을 다른 픽셀 형식 또는 알파 모드의 SoftwareBitmap 으로 변환합니다.
Copy(SoftwareBitmap)	제공된 SoftwareBitmap 개체의 복사본을 만듭니다.
CopyFromBuffer(IBuffer)	IBuffer의 픽셀 데이터를 SoftwareBitmap에 복사합니다.
CopyTo(SoftwareBitmap)	현재 SoftwareBitmap 을 제공된 SoftwareBitmap 개체에 복사합니다.
CopyToBuffer(IBuffer)	소프트웨어 비트맵 픽셀 데이터를 지정된 IBuffer에 복사합니다.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32)	제공된 버퍼의 전체 복사본을 수행하여 새 SoftwareBitmap 을 만듭니다. 새 SoftwareBitmap 의 데이터를 수정해도 만들어진 버퍼에는 영향을 미치지 않습니다.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	제공된 버퍼의 전체 복사본을 수행하여 새 SoftwareBitmap 을 만듭니다. 새 SoftwareBitmap 의 데이터를 수정해도 만들어진 버퍼에는 영향을 미치지 않습니다.
CreateCopyFromSurfaceAsync(IDirect3DSurface)	제공된 IDirect3DSurface의 전체 복사본을 수행하여 새 SoftwareBitmap을 비동기적으로 만듭니다. 새 SoftwareBitmap 의 데이터를 수정해도 생성된 표면에는 영향을 미치지 않습니다.
CreateCopyFromSurfaceAsync(IDirect3DSurface, BitmapAlphaMode)	제공된 IDirect3DSurface의 전체 복사본을 수행하여 새 SoftwareBitmap을 비동기적으로 만듭니다. 새 SoftwareBitmap 의 데이터를 수정해도 생성된 표면에는 영향을 미치지 않습니다.
Dispose()	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.
GetReadOnlyView()	SoftwareBitmap 개체의 읽기 전용 표현을 가져옵니다.
LockBuffer(BitmapBufferAccessMode)	소프트웨어 비트맵의 픽셀 데이터에서 직접 작업할 수 있는 BitmapBuffer 개체를 가져옵니다.

추가 정보

• IClosable
• 카메라 프레임 샘플