BitmapDecoder Klasse

Referenz

Definition

Namespace:: Windows.Graphics.Imaging

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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:

Freigeben über