BitmapDecoder Clase

  • Referencia

Definición

Espacio de nombres:
Windows.Graphics.Imaging
Editar

Proporciona acceso de lectura a los datos del contenedor de mapa de bits, así como a los datos del primer fotograma.

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
Herencia
Object Platform::Object IInspectable BitmapDecoder
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute
Implementaciones
IBitmapFrame IBitmapFrameWithSoftwareBitmap

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

Este es un ejemplo parcial de creación de un objeto de descodificador. En este ejemplo se supone que seleccionó un archivo con Windows.Storage.Pickers.FileOpenPicker. Para obtener instrucciones completas sobre cómo seleccionar un archivo, crear un descodificador y descodificar una imagen, consulte Creación de imágenes.

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();
}

Comentarios

Formatos de imagen

BitmapDecoder puede descodificar los siguientes formatos.

  • JPEG
  • PNG
  • GIF
  • TIFF
  • BMP
  • ICO
  • JPEG-XR
  • Todos los formatos sin procesar de cámara instalados mediante el paquete de códecs de cámara de Microsoft.

Para obtener una lista de formatos de descodificación, consulte el tema BitmapEncoder .

La clase BitmapDecoder implementa IBitmapFrame. Proporciona acceso a los datos del contenedor, así como a los datos de la primera trama. Esto permite a las aplicaciones realizar los escenarios más comunes sin necesidad de recuperar un bitmapFrame independiente.

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1809 17763 HeifDecoderId
1809 17763 WebpDecoderId

Propiedades

BitmapAlphaMode

Modo alfa predeterminado del primer fotograma.
BitmapContainerProperties

Proporciona acceso a las propiedades del mapa de bits del contenedor.
BitmapPixelFormat

Formato de píxel que mejor se ajusta al primer fotograma.
BitmapProperties

Una vista de solo lectura de los metadatos dentro del primer fotograma.
BmpDecoderId

Identificador único del descodificador BMP.
DecoderInformation

Información sobre el descodificador de mapa de bits.
DpiX

Resolución horizontal del primer marco en puntos por pulgada.
DpiY

Resolución vertical del primer marco en puntos por pulgada.
FrameCount

Número de fotogramas dentro del archivo de imagen.
GifDecoderId

Identificador único del descodificador GIF.
HeifDecoderId

Identificador único del descodificador HEIF.
IcoDecoderId

Identificador único del descodificador ICO.
JpegDecoderId

Identificador único del descodificador JPEG.
JpegXRDecoderId

Identificador único del descodificador JPEG-XR.
OrientedPixelHeight

Alto del primer fotograma en píxeles, después de aplicar cualquier orientación EXIF al mapa de bits.
OrientedPixelWidth

Ancho del primer fotograma en píxeles, después de aplicar cualquier orientación EXIF al mapa de bits.
PixelHeight

Alto del primer fotograma en píxeles.
PixelWidth

Ancho del primer fotograma en píxeles.
PngDecoderId

Identificador único del descodificador PNG.
TiffDecoderId

Identificador único del descodificador TIFF.
WebpDecoderId

Identificador único del descodificador de WebP.

Métodos

CreateAsync(Guid, IRandomAccessStream)

Crea de forma asincrónica un nuevo bitmapDecoder mediante un códec de mapa de bits específico e inicializa mediante una secuencia.
CreateAsync(IRandomAccessStream)

Crea de forma asincrónica un bitmapDecoder e inicializa mediante una secuencia.
GetDecoderInformationEnumerator()

Los descodificadores de mapa de bits instalados en el sistema e información sobre ellos.
GetFrameAsync(UInt32)

Recupera de forma asincrónica un marco del archivo de imagen.
GetPixelDataAsync()

Solicita de forma asincrónica los datos de píxeles para el fotograma.
GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

Solicita de forma asincrónica los datos de píxeles para la trama mediante los parámetros especificados.
GetPreviewAsync()

Devuelve de forma asincrónica una secuencia que contiene la imagen de vista previa.
GetSoftwareBitmapAsync()

Obtiene de forma asincrónica una representación de SoftwareBitmap del mapa de bits descodificado.
GetSoftwareBitmapAsync(BitmapPixelFormat, BitmapAlphaMode)

Obtiene de forma asincrónica una representación de SoftwareBitmap del mapa de bits descodificado.
GetSoftwareBitmapAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

Obtiene de forma asincrónica una representación de SoftwareBitmap del mapa de bits descodificado.
GetThumbnailAsync()

Devuelve de forma asincrónica una secuencia que contiene la imagen en miniatura.

Se aplica a

Consulte también