BitmapDecoder Classe

  • Référence

Définition

Espace de noms:
Windows.Graphics.Imaging
Modifier

Fournit un accès en lecture aux données de conteneur bitmap ainsi qu’aux données de la première trame.

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
Héritage
Object Platform::Object IInspectable BitmapDecoder
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute
Implémente
IBitmapFrame IBitmapFrameWithSoftwareBitmap

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Voici un exemple partiel de création d’un objet décodeur. Cet exemple suppose que vous avez sélectionné un fichier avec Windows.Storage.Pickers.FileOpenPicker. Pour obtenir des instructions complètes sur la sélection d’un fichier, la création d’un décodeur et le décodage d’une image, consultez Création d’images

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

Remarques

Formats d’images

BitmapDecoder peut décoder les formats suivants.

  • JPEG
  • PNG
  • GIF
  • TIFF
  • BMP
  • ICO
  • JPEG-XR
  • Tous les formats bruts d’appareil photo installés à l’aide du Microsoft Camera Codec Pack.

Pour obtenir la liste des formats de décodage, consultez la rubrique BitmapEncoder .

La classe BitmapDecoder implémente IBitmapFrame. Il permet d’accéder aux données de conteneur ainsi qu’aux données de la première trame. Cela permet aux applications d’accomplir les scénarios les plus courants sans avoir à récupérer un BitmapFrame distinct.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1809 17763 HeifDecoderId
1809 17763 WebpDecoderId

Propriétés

BitmapAlphaMode

Mode alpha par défaut de la première image.
BitmapContainerProperties

Fournit l’accès aux propriétés bitmap du conteneur.
BitmapPixelFormat

Format de pixel qui correspond le mieux au premier cadre.
BitmapProperties

Vue en lecture seule des métadonnées dans le premier frame.
BmpDecoderId

Identificateur unique du décodeur BMP.
DecoderInformation

Informations sur le décodeur bitmap.
DpiX

Résolution horizontale du premier cadre en points par pouce.
DpiY

Résolution verticale du premier cadre en points par pouce.
FrameCount

Nombre de cadres dans le fichier image.
GifDecoderId

Identificateur unique du décodeur GIF.
HeifDecoderId

Identificateur unique du décodeur HEIF.
IcoDecoderId

Identificateur unique du décodeur ICO.
JpegDecoderId

Identificateur unique du décodeur JPEG.
JpegXRDecoderId

Identificateur unique du décodeur JPEG-XR.
OrientedPixelHeight

Hauteur du premier cadre en pixels, une fois qu’une orientation EXIF a été appliquée à la bitmap.
OrientedPixelWidth

Largeur du premier cadre en pixels, une fois qu’une orientation EXIF a été appliquée à la bitmap.
PixelHeight

Hauteur du premier cadre en pixels.
PixelWidth

Largeur du premier cadre en pixels.
PngDecoderId

Identificateur unique du décodeur PNG.
TiffDecoderId

Identificateur unique du décodeur TIFF.
WebpDecoderId

Identificateur unique du décodeur WebP.

Méthodes

CreateAsync(Guid, IRandomAccessStream)

Crée de façon asynchrone un nouveau BitmapDecoder à l’aide d’un codec bitmap spécifique et l’initialise à l’aide d’un flux.
CreateAsync(IRandomAccessStream)

Crée de manière asynchrone un nouveau BitmapDecoder et l’initialise à l’aide d’un flux.
GetDecoderInformationEnumerator()

Décodeurs bitmap installés sur le système et informations les concernant.
GetFrameAsync(UInt32)

Récupère de façon asynchrone un frame à partir du fichier image.
GetPixelDataAsync()

Demande de façon asynchrone les données de pixels pour le frame.
GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

Demande de manière asynchrone les données de pixel pour le frame à l’aide des paramètres spécifiés.
GetPreviewAsync()

Retourne de manière asynchrone un flux contenant l’image d’aperçu.
GetSoftwareBitmapAsync()

Obtient de façon asynchrone une représentation SoftwareBitmap de l’image bitmap décodée.
GetSoftwareBitmapAsync(BitmapPixelFormat, BitmapAlphaMode)

Obtient de façon asynchrone une représentation SoftwareBitmap de l’image bitmap décodée.
GetSoftwareBitmapAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

Obtient de façon asynchrone une représentation SoftwareBitmap de l’image bitmap décodée.
GetThumbnailAsync()

Retourne de manière asynchrone un flux contenant l’image miniature.

S’applique à

Voir aussi