BitmapDecoder Klasse
Definition
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.
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
- Attribute
- Implementiert
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) |
Ruft asynchron eine SoftwareBitmap-Darstellung der decodierten Bitmap ab. |
GetSoftwareBitmapAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) |
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
- Beispiel für animierte GIF-Wiedergabe (XAML) (Windows 10)
- OCR-Beispiel (Windows 10)
- Beispiel für die Kameraauflösung (Windows 10)
- Beispiel für einfache Kamera-App (Windows 10)
- Videostabilisierungsbeispiel (Windows 10)
- Beispiel für kameragesichtserkennung (Windows 10)
- Beispiel für manuelle Kamerasteuerungen (Windows 10)
- Beispiel mit hohem Dynamischem Bereich (Windows 10)
- Beispiel für erweiterte Kameraerfassung