Freigeben über

BitmapDecoder Klasse

  • Referenz

Definition

Namespace:
Windows.Graphics.Imaging
Bearbeiten

Bietet Lesezugriff auf Bitmapcontainerdaten sowie Daten aus dem ersten Frame.

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
Vererbung
Object Platform::Object IInspectable BitmapDecoder
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute
Implementiert
IBitmapFrame IBitmapFrameWithSoftwareBitmap

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Hier sehen Sie ein teilweises Beispiel für das Erstellen eines Decoderobjekts. In diesem Beispiel wird davon ausgegangen, dass Sie eine Datei mit Windows.Storage.Pickers.FileOpenPicker ausgewählt haben. Vollständige Anweisungen zum Auswählen einer Datei, zum Erstellen eines Decoders und zum Decodieren eines Bilds finden Sie unter Imaging

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

Hinweise

Bildformate

BitmapDecoder kann die folgenden Formate decodieren.

  • JPEG
  • PNG
  • GIF
  • TIFF
  • BMP
  • ICO
  • JPEG-XR
  • Alle installierten Raw-Formate der Kamera mithilfe des Microsoft Camera Codec Pack.

Eine Liste der Decodierungsformate finden Sie im Thema BitmapEncoder .

Die BitmapDecoder-Klasse implementiert IBitmapFrame. Es bietet Zugriff auf Containerdaten sowie Daten aus dem ersten Frame. Dadurch können Anwendungen die häufigsten Szenarien ausführen, ohne einen separaten BitmapFrame abrufen zu müssen.

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
1809 17763 HeifDecoderId
1809 17763 WebpDecoderId

Eigenschaften

BitmapAlphaMode

Der Standard-Alphamodus des ersten Frames.
BitmapContainerProperties

Ermöglicht den Zugriff auf die Eigenschaften der Container-Bitmap.
BitmapPixelFormat

Das Pixelformat, das am besten zum ersten Frame passt.
BitmapProperties

Eine schreibgeschützte Ansicht der Metadaten im ersten Frame.
BmpDecoderId

Der eindeutige Bezeichner des BMP-Decoders.
DecoderInformation

Informationen zum Bitmapdecoder.
DpiX

Die horizontale Auflösung des ersten Frames in Punkt pro Zoll.
DpiY

Die vertikale Auflösung des ersten Frames in Punkt pro Zoll.
FrameCount

Die Anzahl der Frames in der Bilddatei.
GifDecoderId

Der eindeutige Bezeichner des GIF-Decoders.
HeifDecoderId

Der eindeutige Bezeichner des HEIF-Decoders.
IcoDecoderId

Der eindeutige Bezeichner des ICO-Decoders.
JpegDecoderId

Der eindeutige Bezeichner des JPEG-Decoders.
JpegXRDecoderId

Der eindeutige Bezeichner des JPEG-XR-Decoders.
OrientedPixelHeight

Die Höhe des ersten Frames in Pixel, nachdem eine EXIF-Ausrichtung auf die Bitmap angewendet wurde.
OrientedPixelWidth

Die Breite des ersten Frames in Pixel, nachdem eine EXIF-Ausrichtung auf die Bitmap angewendet wurde.
PixelHeight

Die Höhe des ersten Frames in Pixel.
PixelWidth

Die Breite des ersten Frames in Pixel.
PngDecoderId

Der eindeutige Bezeichner des PNG-Decoders.
TiffDecoderId

Der eindeutige Bezeichner des TIFF-Decoders.
WebpDecoderId

Der eindeutige Bezeichner des WebP-Decoders.

Methoden

CreateAsync(Guid, IRandomAccessStream)

Erstellt asynchron einen neuen BitmapDecoder mit einem bestimmten Bitmapcodec und initialisiert ihn mithilfe eines Datenstroms.
CreateAsync(IRandomAccessStream)

Erstellt asynchron einen neuen BitmapDecoder und initialisiert es mithilfe eines Datenstroms.
GetDecoderInformationEnumerator()

Die auf dem System installierten Bitmapdecoder und Informationen darüber.
GetFrameAsync(UInt32)

Ruft asynchron einen Frame aus der Bilddatei ab.
GetPixelDataAsync()

Fordert asynchron die Pixeldaten für den Frame an.
GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

Fordert die Pixeldaten für den Frame mithilfe der angegebenen Parameter asynchron an.
GetPreviewAsync()

Gibt asynchron einen Stream zurück, der das Vorschaubild enthält.
GetSoftwareBitmapAsync()

Ruft asynchron eine SoftwareBitmap-Darstellung der decodierten Bitmap ab.
GetSoftwareBitmapAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

Ruft asynchron eine SoftwareBitmap-Darstellung der decodierten Bitmap ab.
GetSoftwareBitmapAsync(BitmapPixelFormat, BitmapAlphaMode)

Ruft asynchron eine SoftwareBitmap-Darstellung der decodierten Bitmap ab.
GetThumbnailAsync()

Gibt asynchron einen Stream zurück, der das Miniaturbild enthält.

Gilt für:

Weitere Informationen