Partilhar via


SoftwareBitmap Classe

Definição

Representa um bitmap descompactado.

public ref class SoftwareBitmap sealed : IClosable
/// [Windows.Foundation.Metadata.Activatable(Windows.Graphics.Imaging.ISoftwareBitmapFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class SoftwareBitmap final : 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.Activatable(typeof(Windows.Graphics.Imaging.ISoftwareBitmapFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class SoftwareBitmap : System.IDisposable
[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
Implementações

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.

Aplica-se a

Confira também