SoftwareBitmap Klasse

Definition

Namespace:

Windows.Graphics.Imaging

Stellt eine nicht komprimierte Bitmap dar.

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

Vererbung

Object Platform::Object IInspectable SoftwareBitmap

Attribute

ActivatableAttribute ContractVersionAttribute GCPressureAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IClosable IDisposable

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Beispielanwendungen, die diese Klasse verwenden, umfassen das Beispiel Kameraframes.

Ein Codebeispiel zum Zugreifen auf Pixeldaten finden Sie in der WriteableBitmap.PixelBuffer-Eigenschaft (auch unter CopyToBuffer und CopyFromBuffer).

Hinweise

Diese Klasse bietet eine Darstellung einer Bitmap, die die Verwendung mit verschiedenen Imaging-APIs vereinfacht. Verwenden Sie GetSoftwareBitmapAsync , um eine SoftwareBitmap aus einer Streamressource wie einer Imagedatei zu erstellen.

Verwenden Sie CopyToBuffer und CopyFromBuffer , um Pixeldaten zwischen einer SoftwareBitmap und dem PixelBuffer einer WriteableBitmap hin- und herzukopieren. Verwenden Sie CreateCopyFromSurfaceAsync , um eine SoftwareBitmap aus einem IDirect3DSurface zu erstellen. Verwenden Sie ISoftwareBitmapNativeFactory::CreateFromMF2DBuffer2 , um eine SoftwareBitmap aus einem IMF2DBuffer2 zu erstellen. Verwenden Sie ISoftwareBitmapNativeFactory::CreateFromIWICBitmap , um eine SoftwareBitmap aus einer IWICBitmap zu erstellen.

Konstruktoren

SoftwareBitmap(BitmapPixelFormat, Int32, Int32)	Initialisiert eine neue instance der SoftwareBitmap-Klasse.
SoftwareBitmap(BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	Initialisiert eine neue instance der SoftwareBitmap-Klasse.

Eigenschaften

BitmapAlphaMode	Ruft den Alphamodus der Software-Bitmap ab.
BitmapPixelFormat	Ruft das Pixelformat der Software-Bitmap ab.
DpiX	Ruft die Punkte pro Zoll der Software-Bitmap in X-Richtung ab oder legt diese fest.
DpiY	Ruft die Punkte pro Zoll der Software-Bitmap in Y-Richtung ab oder legt diese fest.
IsReadOnly	Ruft einen Wert ab, der angibt, ob die Software-Bitmap geändert werden kann.
PixelHeight	Ruft die Höhe der Software-Bitmap in Pixel ab.
PixelWidth	Ruft die Breite der Software-Bitmap in Pixel ab.

Methoden

Close()	Entsorgt das Objekt und die zugeordneten Ressourcen.
Convert(SoftwareBitmap, BitmapPixelFormat)	Konvertiert eine vorhandene SoftwareBitmap in eine SoftwareBitmap mit einem anderen Pixelformat.
Convert(SoftwareBitmap, BitmapPixelFormat, BitmapAlphaMode)	Konvertiert eine vorhandene SoftwareBitmap in eine SoftwareBitmap mit einem anderen Pixelformat oder Alphamodus.
Copy(SoftwareBitmap)	Erstellt eine Kopie des bereitgestellten SoftwareBitmap-Objekts .
CopyFromBuffer(IBuffer)	Kopiert die Pixeldaten aus einem IBuffer in die SoftwareBitmap.
CopyTo(SoftwareBitmap)	Kopiert die aktuelle SoftwareBitmap in das bereitgestellte SoftwareBitmap-Objekt .
CopyToBuffer(IBuffer)	Kopiert die Software-Bitmappixeldaten in den angegebenen IBuffer.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32)	Erstellt eine neue SoftwareBitmap durch Ausführen einer tiefen Kopie des bereitgestellten Puffers. Änderungen an den Daten in der neuen SoftwareBitmap wirken sich nicht auf den Puffer aus, aus dem sie erstellt wurden.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	Erstellt eine neue SoftwareBitmap durch Ausführen einer tiefen Kopie des bereitgestellten Puffers. Änderungen an den Daten in der neuen SoftwareBitmap wirken sich nicht auf den Puffer aus, aus dem sie erstellt wurden.
CreateCopyFromSurfaceAsync(IDirect3DSurface)	Erstellt asynchron eine neue SoftwareBitmap , indem eine ausführliche Kopie des bereitgestellten IDirect3DSurface ausgeführt wird. Änderungen an den Daten in der neuen SoftwareBitmap wirken sich nicht auf die Oberfläche aus, auf der sie erstellt wurden.
CreateCopyFromSurfaceAsync(IDirect3DSurface, BitmapAlphaMode)	Erstellt asynchron eine neue SoftwareBitmap , indem eine ausführliche Kopie des bereitgestellten IDirect3DSurface ausgeführt wird. Änderungen an den Daten in der neuen SoftwareBitmap wirken sich nicht auf die Oberfläche aus, auf der sie erstellt wurden.
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.
GetReadOnlyView()	Ruft eine schreibgeschützte Darstellung des SoftwareBitmap-Objekts ab.
LockBuffer(BitmapBufferAccessMode)	Ruft ein BitmapBuffer-Objekt ab, mit dem Sie direkt mit den Pixeldaten der Software-Bitmap arbeiten können.

Weitere Informationen

• IClosable
• Beispiel für Kameraframes