BitmapDecoder Classe

  • Referência

Definição

Namespace:
Windows.Graphics.Imaging
Editar

Fornece acesso de leitura a dados de contêiner de bitmap, bem como dados do primeiro quadro.

public ref class BitmapDecoder sealed : IBitmapFrameWithSoftwareBitmap
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BitmapDecoder final : IBitmapFrameWithSoftwareBitmap
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class BitmapDecoder : IBitmapFrameWithSoftwareBitmap
Public NotInheritable Class BitmapDecoder
Implements IBitmapFrameWithSoftwareBitmap
Herança
Object Platform::Object IInspectable BitmapDecoder
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute
Implementações
IBitmapFrame IBitmapFrameWithSoftwareBitmap

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

Aqui está um exemplo parcial de criação de um objeto decodificador. Este exemplo pressupõe que você selecionou um arquivo com Windows.Storage.Pickers.FileOpenPicker. Para obter instruções completas sobre como selecionar um arquivo, criar um decodificador e decodificar uma imagem, consulte Geração de imagens

FileOpenPicker fileOpenPicker = new FileOpenPicker();
fileOpenPicker.SuggestedStartLocation = PickerLocationId.PicturesLibrary;
fileOpenPicker.FileTypeFilter.Add(".jpg");
fileOpenPicker.ViewMode = PickerViewMode.Thumbnail;

var inputFile = await fileOpenPicker.PickSingleFileAsync();

if (inputFile == null)
{
    // The user cancelled the picking operation
    return;
}

SoftwareBitmap softwareBitmap;

using (IRandomAccessStream stream = await inputFile.OpenAsync(FileAccessMode.Read))
{
    // Create the decoder from the stream
    BitmapDecoder decoder = await BitmapDecoder.CreateAsync(stream);

    // Get the SoftwareBitmap representation of the file
    softwareBitmap = await decoder.GetSoftwareBitmapAsync();
}

Comentários

Formatos de imagem

O BitmapDecoder pode decodificar os seguintes formatos.

  • JPEG
  • PNG
  • GIF
  • TIFF
  • BMP
  • ICO
  • JPEG-XR
  • Todos os formatos brutos da Câmera instalados usando o Microsoft Camera Codec Pack.

Para obter uma lista de formatos de decodificação, consulte o tópico BitmapEncoder .

A classe BitmapDecoder implementa IBitmapFrame. Ele fornece acesso a dados de contêiner, bem como dados do primeiro quadro. Isso permite que os aplicativos realizem cenários mais comuns sem a necessidade de recuperar um BitmapFrame separado.

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
1809 17763 HeifDecoderId
1809 17763 WebpDecoderId

Propriedades

BitmapAlphaMode

O modo alfa padrão do primeiro quadro.
BitmapContainerProperties

Fornece acesso às propriedades de bitmap do contêiner.
BitmapPixelFormat

O formato de pixel que melhor se ajusta ao primeiro quadro.
BitmapProperties

Uma exibição somente leitura dos metadados no primeiro quadro.
BmpDecoderId

O identificador exclusivo do decodificador BMP.
DecoderInformation

Informações sobre o decodificador de bitmap.
DpiX

A resolução horizontal do primeiro quadro em pontos por polegada.
DpiY

A resolução vertical do primeiro quadro em pontos por polegada.
FrameCount

O número de quadros dentro do arquivo de imagem.
GifDecoderId

O identificador exclusivo do decodificador GIF.
HeifDecoderId

O identificador exclusivo do decodificador HEIF.
IcoDecoderId

O identificador exclusivo do decodificador de ICO.
JpegDecoderId

O identificador exclusivo do decodificador JPEG.
JpegXRDecoderId

O identificador exclusivo do decodificador JPEG-XR.
OrientedPixelHeight

A altura do primeiro quadro em pixels, depois que qualquer orientação EXIF tiver sido aplicada ao bitmap.
OrientedPixelWidth

A largura do primeiro quadro em pixels, depois que qualquer orientação EXIF tiver sido aplicada ao bitmap.
PixelHeight

A altura do primeiro quadro em pixels.
PixelWidth

A largura do primeiro quadro em pixels.
PngDecoderId

O identificador exclusivo do decodificador PNG.
TiffDecoderId

O identificador exclusivo do decodificador TIFF.
WebpDecoderId

O identificador exclusivo do decodificador WebP.

Métodos

CreateAsync(Guid, IRandomAccessStream)

Cria de forma assíncrona um novo BitmapDecoder usando um codec bitmap específico e o inicializa usando um fluxo.
CreateAsync(IRandomAccessStream)

Cria de forma assíncrona um novo BitmapDecoder e o inicializa usando um fluxo.
GetDecoderInformationEnumerator()

Os decodificadores de bitmap instalados no sistema e informações sobre eles.
GetFrameAsync(UInt32)

Recupera de forma assíncrona um quadro do arquivo de imagem.
GetPixelDataAsync()

Solicita de forma assíncrona os dados de pixel para o quadro.
GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

Solicita de forma assíncrona os dados de pixel para o quadro usando os parâmetros especificados.
GetPreviewAsync()

Retorna de forma assíncrona um fluxo que contém a imagem de visualização.
GetSoftwareBitmapAsync()

Obtém de forma assíncrona uma representação SoftwareBitmap do bitmap decodificado.
GetSoftwareBitmapAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

Obtém de forma assíncrona uma representação SoftwareBitmap do bitmap decodificado.
GetSoftwareBitmapAsync(BitmapPixelFormat, BitmapAlphaMode)

Obtém de forma assíncrona uma representação SoftwareBitmap do bitmap decodificado.
GetThumbnailAsync()

Retorna de forma assíncrona um fluxo que contém a imagem em miniatura.

Aplica-se a

Confira também