SoftwareBitmap Classe

Definição

Namespace:

Windows.Graphics.Imaging

Representa um bitmap descompactado.

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

Herança

Object Platform::Object IInspectable SoftwareBitmap

Atributos

ActivatableAttribute ContractVersionAttribute GCPressureAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IClosable IDisposable

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Os aplicativos de exemplo que usam essa classe incluem o exemplo Quadros de câmera.

Para obter um exemplo de código mostrando como acessar dados de pixel, consulte a propriedade WriteableBitmap.PixelBuffer (consulte também CopyToBuffer e CopyFromBuffer).

Comentários

Essa classe fornece uma representação de um bitmap que facilita o uso com diferentes APIs de imagem. Use GetSoftwareBitmapAsync para criar um SoftwareBitmap de um recurso de fluxo, como um arquivo de imagem.

Use CopyToBuffer e CopyFromBuffer para copiar dados de pixel entre um SoftwareBitmap e o PixelBuffer de um WriteableBitmap. Use CreateCopyFromSurfaceAsync para criar um SoftwareBitmap de um IDirect3DSurface. Use ISoftwareBitmapNativeFactory::CreateFromMF2DBuffer2 para criar um SoftwareBitmap de um IMF2DBuffer2. Use ISoftwareBitmapNativeFactory::CreateFromIWICBitmap para criar um SoftwareBitmap de um IWICBitmap.

Construtores

SoftwareBitmap(BitmapPixelFormat, Int32, Int32)	Inicializa uma nova instância da classe SoftwareBitmap .
SoftwareBitmap(BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	Inicializa uma nova instância da classe SoftwareBitmap .

Propriedades

BitmapAlphaMode	Obtém o modo alfa do bitmap de software.
BitmapPixelFormat	Obtém o formato de pixel do bitmap de software.
DpiX	Obtém ou define os pontos por polegada do bitmap de software na direção X.
DpiY	Obtém ou define os pontos por polegada do bitmap de software na direção Y.
IsReadOnly	Obtém um valor que indica se o bitmap de software pode ser modificado.
PixelHeight	Obtém a altura do bitmap de software, em pixels.
PixelWidth	Obtém a largura do bitmap de software, em pixels.

Métodos

Close()	Descarta o objeto e os recursos associados.
Convert(SoftwareBitmap, BitmapPixelFormat)	Converte um SoftwareBitmap existente em um SoftwareBitmap com um formato de pixel diferente.
Convert(SoftwareBitmap, BitmapPixelFormat, BitmapAlphaMode)	Converte um SoftwareBitmap existente em um SoftwareBitmap com um formato de pixel ou modo alfa diferente.
Copy(SoftwareBitmap)	Cria uma cópia do objeto SoftwareBitmap fornecido.
CopyFromBuffer(IBuffer)	Copia os dados de pixel de um IBuffer para o SoftwareBitmap.
CopyTo(SoftwareBitmap)	Copia o SoftwareBitmap atual para o objeto SoftwareBitmap fornecido.
CopyToBuffer(IBuffer)	Copia os dados de pixel de bitmap de software no IBuffer especificado.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32)	Cria um novo SoftwareBitmap executando uma cópia profunda do buffer fornecido. As modificações nos dados no novo SoftwareBitmap não afetarão o buffer do qual ele foi criado.
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	Cria um novo SoftwareBitmap executando uma cópia profunda do buffer fornecido. As modificações nos dados no novo SoftwareBitmap não afetarão o buffer do qual ele foi criado.
CreateCopyFromSurfaceAsync(IDirect3DSurface)	Cria de forma assíncrona um novo SoftwareBitmap executando uma cópia profunda do IDirect3DSurface fornecido. As modificações nos dados no novo SoftwareBitmap não afetarão a superfície da qual ele foi criado.
CreateCopyFromSurfaceAsync(IDirect3DSurface, BitmapAlphaMode)	Cria de forma assíncrona um novo SoftwareBitmap executando uma cópia profunda do IDirect3DSurface fornecido. As modificações nos dados no novo SoftwareBitmap não afetarão a superfície da qual ele foi criado.
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados.
GetReadOnlyView()	Obtém uma representação somente leitura do objeto SoftwareBitmap .
LockBuffer(BitmapBufferAccessMode)	Obtém um objeto BitmapBuffer que permite que você opere diretamente nos dados de pixel do bitmap de software.

Confira também

• IClosable
• Quadros da câmera de exemplo