SoftwareBitmap Classe

Definizione

Spazio dei nomi:

Windows.Graphics.Imaging

Rappresenta una bitmap non compressa.

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

Ereditarietà

Object Platform::Object IInspectable SoftwareBitmap

Attributi

ActivatableAttribute ContractVersionAttribute GCPressureAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IClosable IDisposable

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Le applicazioni di esempio che usano questa classe includono l'esempio di fotogrammi fotocamera.

Per un esempio di codice che mostra come accedere ai dati pixel, vedere la proprietà WriteableBitmap.PixelBuffer (vedere anche CopyToBuffer e CopyFromBuffer).

Commenti

Questa classe fornisce una rappresentazione di una bitmap che semplifica l'uso con diverse API di immagine. Usare GetSoftwareBitmapAsync per creare un SoftwareBitmap da una risorsa di flusso, ad esempio un file di immagine.

Usare CopyToBuffer e CopyFromBuffer per copiare i dati pixel indietro e indietro tra softwareBitmap e PixelBuffer di un writeableBitmap. Usare CreateCopyFromSurfaceAsync per creare un SoftwareBitmap da un oggetto IDirect3DSurface. Usare ISoftwareBitmapNativeFactory::CreateFromMF2DBuffer2 per creare un SoftwareBitmap da un FMI2DBuffer2. Usare ISoftwareBitmapNativeFactory::CreateFromIWICBitmap per creare un SoftwareBitmap da una mappa IWICBitmap.

Costruttori

SoftwareBitmap(BitmapPixelFormat, Int32, Int32)	Inizializza una nuova istanza della classe SoftwareBitmap .
SoftwareBitmap(BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	Inizializza una nuova istanza della classe SoftwareBitmap .

Proprietà

BitmapAlphaMode	Ottiene la modalità alfa della bitmap software.
BitmapPixelFormat	Ottiene il formato pixel della bitmap software.
DpiX	Ottiene o imposta i punti per pollice della bitmap software nella direzione X.
DpiY	Ottiene o imposta i punti per pollice della bitmap software nella direzione Y.
IsReadOnly	Ottiene un valore che indica se la bitmap software può essere modificata.
PixelHeight	Ottiene l'altezza della bitmap software, in pixel.
PixelWidth	Ottiene la larghezza della bitmap software, in pixel.

Metodi

Close()	Elimina l'oggetto e le risorse associate.
Convert(SoftwareBitmap, BitmapPixelFormat)	Converte un softwareBitmap esistente in un softwareBitmap con un formato pixel diverso.
Convert(SoftwareBitmap, BitmapPixelFormat, BitmapAlphaMode)	Converte un softwareBitmap esistente in un softwareBitmap con un formato pixel o una modalità alfa diversa.
Copy(SoftwareBitmap)	Crea una copia dell'oggetto SoftwareBitmap specificato.
CopyFromBuffer(IBuffer)	Copia i dati pixel da un IBuffer in SoftwareBitmap.
CopyTo(SoftwareBitmap)	Copia l'oggetto SoftwareBitmap corrente nell'oggetto SoftwareBitmap specificato.
CopyToBuffer(IBuffer)	Copia i dati del pixel bitmap software nell'IBuffer specificato.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32)	Crea un nuovo SoftwareBitmap eseguendo una copia profonda del buffer fornito. Le modifiche ai dati nel nuovo SoftwareBitmap non effettoranno il buffer da cui è stato creato.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	Crea un nuovo SoftwareBitmap eseguendo una copia profonda del buffer fornito. Le modifiche ai dati nel nuovo SoftwareBitmap non effettoranno il buffer da cui è stato creato.
CreateCopyFromSurfaceAsync(IDirect3DSurface)	Crea in modo asincrono un nuovo SoftwareBitmap eseguendo una copia approfondita dell'oggetto IDirect3DSurface fornito. Le modifiche apportate ai dati nel nuovo SoftwareBitmap non effettoranno la superficie da cui è stata creata.
CreateCopyFromSurfaceAsync(IDirect3DSurface, BitmapAlphaMode)	Crea in modo asincrono un nuovo SoftwareBitmap eseguendo una copia approfondita dell'oggetto IDirect3DSurface fornito. Le modifiche apportate ai dati nel nuovo SoftwareBitmap non effettoranno la superficie da cui è stata creata.
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.
GetReadOnlyView()	Ottiene una rappresentazione di sola lettura dell'oggetto SoftwareBitmap .
LockBuffer(BitmapBufferAccessMode)	Ottiene un oggetto BitmapBuffer che consente di operare direttamente sui dati pixel della bitmap software.

Vedi anche

• IClosable
• Esempio di fotogrammi della fotocamera