SoftwareBitmap Clase

Definición

Espacio de nombres:

Windows.Graphics.Imaging

Representa un mapa de bits sin comprimir.

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

Herencia

Object Platform::Object IInspectable SoftwareBitmap

Atributos

ActivatableAttribute ContractVersionAttribute GCPressureAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IClosable IDisposable

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

Las aplicaciones de ejemplo que usan esta clase incluyen el ejemplo de fotogramas de cámara.

Para obtener un ejemplo de código que muestra cómo obtener acceso a los datos de píxeles, vea la propiedad WriteableBitmap.PixelBuffer (también vea CopyToBuffer y CopyFromBuffer).

Comentarios

Esta clase proporciona una representación de un mapa de bits que facilita el uso con diferentes API de creación de imágenes. Use GetSoftwareBitmapAsync para crear un softwareBitmap a partir de un recurso de secuencia, como un archivo de imagen.

Use CopyToBuffer y CopyFromBuffer para copiar datos de píxeles entre softwareBitmap y PixelBuffer de un objeto WriteableBitmap. Use CreateCopyFromSurfaceAsync para crear un objeto SoftwareBitmap a partir de un IDirect3DSurface. Use ISoftwareBitmapNativeFactory::CreateFromMF2DBuffer2 para crear un SoftwareBitmap a partir de un IMF2DBuffer2. Use ISoftwareBitmapNativeFactory::CreateFromIWICBitmap para crear un Objeto SoftwareBitmap a partir de un objeto IWICBitmap.

Constructores

SoftwareBitmap(BitmapPixelFormat, Int32, Int32)	Inicializa una nueva instancia de la clase SoftwareBitmap .
SoftwareBitmap(BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	Inicializa una nueva instancia de la clase SoftwareBitmap .

Propiedades

BitmapAlphaMode	Obtiene el modo alfa del mapa de bits de software.
BitmapPixelFormat	Obtiene el formato de píxel del mapa de bits de software.
DpiX	Obtiene o establece los puntos por pulgada del mapa de bits de software en la dirección X.
DpiY	Obtiene o establece los puntos por pulgada del mapa de bits de software en la dirección Y.
IsReadOnly	Obtiene un valor que indica si se puede modificar el mapa de bits de software.
PixelHeight	Obtiene el alto del mapa de bits de software, en píxeles.
PixelWidth	Obtiene el ancho del mapa de bits de software, en píxeles.

Métodos

Close()	Elimina el objeto y los recursos asociados.
Convert(SoftwareBitmap, BitmapPixelFormat)	Convierte un objeto SoftwareBitmap existente en un objeto SoftwareBitmap con un formato de píxel diferente.
Convert(SoftwareBitmap, BitmapPixelFormat, BitmapAlphaMode)	Convierte un objeto SoftwareBitmap existente en un objeto SoftwareBitmap con un formato de píxel diferente o un modo alfa.
Copy(SoftwareBitmap)	Crea una copia del objeto SoftwareBitmap proporcionado.
CopyFromBuffer(IBuffer)	Copia los datos de píxeles de un IBuffer en softwareBitmap.
CopyTo(SoftwareBitmap)	Copia el objeto SoftwareBitmap actual en el objeto SoftwareBitmap proporcionado.
CopyToBuffer(IBuffer)	Copia los datos de píxeles del mapa de bits de software en el IBuffer especificado.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32)	Crea un nuevo Objeto SoftwareBitmap realizando una copia en profundidad del búfer proporcionado. Las modificaciones en los datos del nuevo SoftwareBitmap no afectarán al búfer desde el que se creó.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	Crea un nuevo Objeto SoftwareBitmap realizando una copia en profundidad del búfer proporcionado. Las modificaciones en los datos del nuevo SoftwareBitmap no afectarán al búfer desde el que se creó.
CreateCopyFromSurfaceAsync(IDirect3DSurface)	Crea de forma asincrónica un nuevo SoftwareBitmap realizando una copia profunda del IDirect3DSurface proporcionado. Las modificaciones en los datos del nuevo SoftwareBitmap no afectarán a la superficie desde la que se creó.
CreateCopyFromSurfaceAsync(IDirect3DSurface, BitmapAlphaMode)	Crea de forma asincrónica un nuevo SoftwareBitmap realizando una copia profunda del IDirect3DSurface proporcionado. Las modificaciones en los datos del nuevo SoftwareBitmap no afectarán a la superficie desde la que se creó.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.
GetReadOnlyView()	Obtiene una representación de solo lectura del objeto SoftwareBitmap .
LockBuffer(BitmapBufferAccessMode)	Obtiene un objeto BitmapBuffer que permite operar directamente en los datos de píxeles del mapa de bits de software.

Consulte también

• IClosable
• Muestra de fotogramas de cámara