SoftwareBitmap Classe

Définition

Espace de noms:

Windows.Graphics.Imaging

Représente une image bitmap non compressée.

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

Héritage

Object Platform::Object IInspectable SoftwareBitmap

Attributs

ActivatableAttribute ContractVersionAttribute GCPressureAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IClosable IDisposable

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Les exemples d’applications qui utilisent cette classe incluent l’exemple d’images caméra.

Pour obtenir un exemple de code montrant comment accéder aux données de pixels, consultez la propriété WriteableBitmap.PixelBuffer (également voir CopyToBuffer et CopyFromBuffer).

Remarques

Cette classe fournit une représentation d’une bitmap qui la rend facile à utiliser avec différentes API d’imagerie. Utilisez GetSoftwareBitmapAsync pour créer un SoftwareBitmap à partir d’une ressource de flux comme un fichier image.

Utilisez CopyToBuffer et CopyFromBuffer pour copier des données de pixels entre un SoftwareBitmap et le PixelBuffer d’un WriteableBitmap. Utilisez CreateCopyFromSurfaceAsync pour créer un SoftwareBitmap à partir d’un IDirect3DSurface. Utilisez ISoftwareBitmapNativeFactory::CreateFromMF2DBuffer2 pour créer un SoftwareBitmap à partir d’un IMF2DBuffer2. Utilisez ISoftwareBitmapNativeFactory::CreateFromIWICBitmap pour créer un SoftwareBitmap à partir d’un IWICBitmap.

Constructeurs

SoftwareBitmap(BitmapPixelFormat, Int32, Int32)	Initialise une nouvelle instance de la classe SoftwareBitmap.
SoftwareBitmap(BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	Initialise une nouvelle instance de la classe SoftwareBitmap.

Propriétés

BitmapAlphaMode	Obtient le mode alpha de l’image bitmap logicielle.
BitmapPixelFormat	Obtient le format de pixels de l’image bitmap logicielle.
DpiX	Obtient ou définit les points par pouce de la bitmap logicielle dans le sens X.
DpiY	Obtient ou définit les points par pouce de la bitmap logicielle dans le sens Y.
IsReadOnly	Obtient une valeur indiquant si la bitmap logicielle peut être modifiée.
PixelHeight	Obtient la hauteur de l’image bitmap logicielle, en pixels.
PixelWidth	Obtient la largeur de l’image bitmap logicielle, en pixels.

Méthodes

Close()	Supprime l’objet et les ressources associées.
Convert(SoftwareBitmap, BitmapPixelFormat)	Convertit un SoftwareBitmap existant en SoftwareBitmap avec un autre format de pixel.
Convert(SoftwareBitmap, BitmapPixelFormat, BitmapAlphaMode)	Convertit un SoftwareBitmap existant en SoftwareBitmap avec un format de pixels ou un mode alpha différent.
Copy(SoftwareBitmap)	Crée une copie de l’objet SoftwareBitmap fourni.
CopyFromBuffer(IBuffer)	Copie les données de pixels d’un IBuffer dans softwareBitmap.
CopyTo(SoftwareBitmap)	Copie le softwareBitmap actuel dans l’objet SoftwareBitmap fourni.
CopyToBuffer(IBuffer)	Copie les données de pixels bitmap du logiciel dans l’IBuffer spécifié.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32)	Crée un nouveau SoftwareBitmap en effectuant une copie approfondie de la mémoire tampon fournie. Les modifications apportées aux données dans le nouveau SoftwareBitmap n’ont pas d’effet sur la mémoire tampon à partir de laquelle elles ont été créées.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	Crée un nouveau SoftwareBitmap en effectuant une copie approfondie de la mémoire tampon fournie. Les modifications apportées aux données dans le nouveau SoftwareBitmap n’ont pas d’effet sur la mémoire tampon à partir de laquelle elles ont été créées.
CreateCopyFromSurfaceAsync(IDirect3DSurface)	Crée de manière asynchrone un nouveau SoftwareBitmap en effectuant une copie approfondie du IDirect3DSurface fourni. Les modifications apportées aux données dans le nouveau SoftwareBitmap n’ont pas d’effet sur la surface à partir de laquelle elles ont été créées.
CreateCopyFromSurfaceAsync(IDirect3DSurface, BitmapAlphaMode)	Crée de manière asynchrone un nouveau SoftwareBitmap en effectuant une copie approfondie du IDirect3DSurface fourni. Les modifications apportées aux données dans le nouveau SoftwareBitmap n’ont pas d’effet sur la surface à partir de laquelle elles ont été créées.
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.
GetReadOnlyView()	Obtient une représentation en lecture seule de l’objet SoftwareBitmap .
LockBuffer(BitmapBufferAccessMode)	Obtient un objet BitmapBuffer qui vous permet d’opérer directement sur les données de pixels du bitmap logiciel.

Voir aussi

• IClosable
• Profils d’appareil photo