SoftwareBitmap 클래스

정의

네임스페이스:

Windows.Graphics.Imaging

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

public ref class SoftwareBitmap sealed : IClosable

/// [Windows.Foundation.Metadata.Activatable(Windows.Graphics.Imaging.ISoftwareBitmapFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class SoftwareBitmap final : 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.Activatable(typeof(Windows.Graphics.Imaging.ISoftwareBitmapFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class SoftwareBitmap : System.IDisposable

[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 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 속성(및 참조)을 참조CopyToBufferCopyFromBuffer하세요.

설명

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

SoftwareBitmap PixelBuffer 과 CopyFromBuffer 의 사이를 오가며 픽셀 데이터를 사용하고 CopyToBuffer 복사합니다WriteableBitmap. 에서 SoftwareBitmap 을 IDirect3DSurface만드는 데 사용합니다CreateCopyFromSurfaceAsync.

생성자

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

속성

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 데이터의 수정은 생성된 표면에 영향을 미치지 않습니다.
GetReadOnlyView()	개체의 읽기 전용 표현을 SoftwareBitmap 가져옵니다.
LockBuffer(BitmapBufferAccessMode)	BitmapBuffer 소프트웨어 비트맵의 픽셀 데이터에서 직접 작업할 수 있는 개체를 가져옵니다.

추가 정보

• IClosable
• 카메라 프레임 샘플