SoftwareBitmap Kelas

Definisi

Ruang nama:

Windows.Graphics.Imaging

Mewakili bitmap yang tidak dikompresi.

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

Warisan

Object Platform::Object IInspectable SoftwareBitmap

Atribut

ActivatableAttribute ContractVersionAttribute GCPressureAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

IClosable IDisposable

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Aplikasi sampel yang menggunakan kelas ini mencakup sampel bingkai Kamera.

Untuk contoh kode yang menunjukkan cara mengakses data piksel, lihat properti WriteableBitmap.PixelBuffer (juga lihat CopyToBuffer, dan CopyFromBuffer).

Keterangan

Kelas ini menyediakan representasi bitmap yang memudahkan penggunaan dengan API pencitraan yang berbeda. Gunakan GetSoftwareBitmapAsync untuk membuat SoftwareBitmap dari sumber daya aliran seperti file gambar.

Gunakan CopyToBuffer dan CopyFromBuffer untuk menyalin data piksel bolak-balik antara SoftwareBitmap dan PixelBuffer dari WriteableBitmap. Gunakan CreateCopyFromSurfaceAsync untuk membuat SoftwareBitmap dari IDirect3DSurface. Gunakan ISoftwareBitmapNativeFactory::CreateFromMF2DBuffer2 untuk membuat SoftwareBitmap dari IMF2DBuffer2. Gunakan ISoftwareBitmapNativeFactory::CreateFromIWICBitmap untuk membuat SoftwareBitmap dari IWICBitmap.

Konstruktor

SoftwareBitmap(BitmapPixelFormat, Int32, Int32)	Menginisialisasi instans baru kelas SoftwareBitmap .
SoftwareBitmap(BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	Menginisialisasi instans baru kelas SoftwareBitmap .

Properti

BitmapAlphaMode	Mendapatkan mode alfa dari bitmap perangkat lunak.
BitmapPixelFormat	Mendapatkan format piksel bitmap perangkat lunak.
DpiX	Mendapatkan atau mengatur titik per inci bitmap perangkat lunak ke arah X.
DpiY	Mendapatkan atau mengatur titik per inci bitmap perangkat lunak ke arah Y.
IsReadOnly	Mendapatkan nilai yang menunjukkan apakah bitmap perangkat lunak dapat dimodifikasi.
PixelHeight	Mendapatkan tinggi bitmap perangkat lunak, dalam piksel.
PixelWidth	Mendapatkan lebar bitmap perangkat lunak, dalam piksel.

Metode

Close()	Membuang objek dan sumber daya terkait.
Convert(SoftwareBitmap, BitmapPixelFormat)	Mengonversi SoftwareBitmap yang ada menjadi SoftwareBitmap dengan format piksel yang berbeda.
Convert(SoftwareBitmap, BitmapPixelFormat, BitmapAlphaMode)	Mengonversi SoftwareBitmap yang ada menjadi SoftwareBitmap dengan format piksel atau mode alfa yang berbeda.
Copy(SoftwareBitmap)	Membuat salinan objek SoftwareBitmap yang disediakan.
CopyFromBuffer(IBuffer)	Menyalin data piksel dari IBuffer ke dalam SoftwareBitmap.
CopyTo(SoftwareBitmap)	Menyalin SoftwareBitmap saat ini ke dalam objek SoftwareBitmap yang disediakan.
CopyToBuffer(IBuffer)	Menyalin data piksel bitmap perangkat lunak ke dalam IBuffer yang ditentukan.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32)	Membuat SoftwareBitmap baru dengan melakukan salinan mendalam dari buffer yang disediakan. Modifikasi pada data dalam SoftwareBitmap baru tidak akan memengaruhi buffer tempat data dibuat.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	Membuat SoftwareBitmap baru dengan melakukan salinan mendalam dari buffer yang disediakan. Modifikasi pada data dalam SoftwareBitmap baru tidak akan memengaruhi buffer tempat data dibuat.
CreateCopyFromSurfaceAsync(IDirect3DSurface)	Secara asinkron membuat SoftwareBitmap baru dengan melakukan salinan mendalam dari IDirect3DSurface yang disediakan. Modifikasi pada data dalam SoftwareBitmap baru tidak akan memengaruhi permukaan tempat data dibuat.
CreateCopyFromSurfaceAsync(IDirect3DSurface, BitmapAlphaMode)	Secara asinkron membuat SoftwareBitmap baru dengan melakukan salinan mendalam dari IDirect3DSurface yang disediakan. Modifikasi pada data dalam SoftwareBitmap baru tidak akan memengaruhi permukaan tempat data dibuat.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola.
GetReadOnlyView()	Mendapatkan representasi baca-saja dari objek SoftwareBitmap .
LockBuffer(BitmapBufferAccessMode)	Mendapatkan objek BitmapBuffer yang memungkinkan Anda beroperasi langsung pada data piksel bitmap perangkat lunak.

Lihat juga

• IClosable
• Sampel bingkai kamera