BitmapDecoder Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Media.Imaging

Zestaw:: PresentationCore.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje kontener dla ramek mapy bitowej. Każda ramka mapy bitowej to BitmapSource. Ta abstrakcyjna klasa udostępnia podstawowy zestaw funkcji dla wszystkich pochodnych obiektów dekodera.

public ref class BitmapDecoder abstract : System::Windows::Threading::DispatcherObject

public abstract class BitmapDecoder : System.Windows.Threading.DispatcherObject

type BitmapDecoder = class
    inherit DispatcherObject

Public MustInherit Class BitmapDecoder
Inherits DispatcherObject

Dziedziczenie: Object

DispatcherObject
BitmapDecoder

Pochodne: System.Windows.Media.Imaging.BmpBitmapDecoder

System.Windows.Media.Imaging.GifBitmapDecoder

System.Windows.Media.Imaging.IconBitmapDecoder

System.Windows.Media.Imaging.JpegBitmapDecoder

System.Windows.Media.Imaging.LateBoundBitmapDecoder

Więcej…

Przykłady

W poniższym przykładzie pokazano, jak za pomocą Create(Uri, BitmapCreateOptions, BitmapCacheOption) metody utworzyć dekoder dla danego obrazu. Pierwszy BitmapFrame z obrazów jest używany jako źródło kontrolki Image .

BitmapDecoder uriBitmap = BitmapDecoder.Create(
   new Uri("sampleImages/waterlilies.jpg", UriKind.Relative),
   BitmapCreateOptions.None,
   BitmapCacheOption.Default);

// Create an image element;
Image uriImage = new Image();
uriImage.Width = 200;
// Set image source.
uriImage.Source = uriBitmap.Frames[0];

Dim uriBitmap As BitmapDecoder = BitmapDecoder.Create(New Uri("sampleImages/waterlilies.jpg", UriKind.Relative), BitmapCreateOptions.None, BitmapCacheOption.Default)

' Create an image element;
Dim uriImage As New Image()
uriImage.Width = 200
' Set image source.
uriImage.Source = uriBitmap.Frames(0)

W poniższym przykładzie kodu pokazano, jak używać wbudowanego elementu TiffBitmapDecoder do otwierania i dekodowania mapy bitowej otagowanych plików obrazów (TIFF). BitmapSource Wynikowy element jest używany jako Source Image element .


// Open a Stream and decode a TIFF image
Stream imageStreamSource = new FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read);
TiffBitmapDecoder decoder = new TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default);
BitmapSource bitmapSource = decoder.Frames[0];

// Draw the Image
Image myImage1 = new Image();
myImage1.Source = bitmapSource;
myImage1.Stretch = Stretch.None;
myImage1.Margin = new Thickness(20);

' Open a Stream and decode a TIFF image
Dim imageStreamSource As New FileStream("tulipfarm.tif", FileMode.Open, FileAccess.Read, FileShare.Read)
Dim decoder As New TiffBitmapDecoder(imageStreamSource, BitmapCreateOptions.PreservePixelFormat, BitmapCacheOption.Default)
Dim bitmapSource As BitmapSource = decoder.Frames(0)

' Draw the Image
Dim myImage1 As New Image()
myImage1.Source = bitmapSource
myImage1.Stretch = Stretch.None
myImage1.Margin = New Thickness(20)

Uwagi

BitmapDecoder nie jest samym sobą BitmapFrame , a raczej jest kontenerem dla BitmapFrame obiektów. Każdy BitmapFrame kontener może mieć potencjalnie różne atrybuty, w tym różne rozmiary, rozdzielczości lub palety.

Jeśli nie wybrano określonego kodera-dekodera, Windows Presentation Foundation (WPF) używa automatycznego odnajdywania w czasie wykonywania do identyfikowania formatu obrazu i dopasowywania go do odpowiedniego kodera-dekodera. Ten proces odnajdywania umożliwia koder-dekoder opracowany przez niezależnego dostawcę oprogramowania (ISV) do automatycznego odnajdywania przez system. Aby wybrać określony koder-dekoder, należy użyć klasy pochodnej BitmapDecoder lub BitmapEncoder, takiej jak TiffBitmapDecoder klasa.

Otagowane formaty plików obrazów (TIFF) i Graphics Interchange Format (GIF) to jedyne zaimplementowane formaty obrazów, które obsługują wiele ramek.

Konstruktory

BitmapDecoder()

Inicjuje nowe wystąpienie klasy BitmapDecoder.

Właściwości

CodecInfo	Pobiera informacje opisujące ten koder-dekoder.
ColorContexts	Pobiera wartość reprezentującą profil kolorów skojarzony z mapą bitową, jeśli jest zdefiniowana.
Dispatcher	Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (Odziedziczone po DispatcherObject)
Frames	Pobiera zawartość pojedynczej ramki w obrębie mapy bitowej.
IsDownloading	Pobiera wartość wskazującą, czy dekoder pobiera obecnie zawartość.
Metadata	Pobiera wystąpienie BitmapMetadata , które reprezentuje globalne metadane skojarzone z tą mapą bitową, jeśli metadane są zdefiniowane.
Palette	BitmapPalette Pobiera element skojarzony z tym dekoderem.
Preview	Pobiera element BitmapSource reprezentujący globalny podgląd tej mapy bitowej, jeśli jest zdefiniowany.
Thumbnail	Pobiera obiekt BitmapSource reprezentujący miniaturę mapy bitowej, jeśli jest ona zdefiniowana.

Metody

CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
Create(Stream, BitmapCreateOptions, BitmapCacheOption)	Tworzy obiekt BitmapDecoder na podstawie Stream obiektu przy użyciu określonych BitmapCreateOptions parametrów i BitmapCacheOption.
Create(Uri, BitmapCreateOptions, BitmapCacheOption)	Tworzy obiekt BitmapDecoder na podstawie Uri obiektu przy użyciu określonych BitmapCreateOptions parametrów i BitmapCacheOption.
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)	Tworzy obiekt BitmapDecoder na podstawie Uri obiektu przy użyciu określonych BitmapCreateOptionsparametrów i BitmapCacheOption RequestCachePolicy.
CreateInPlaceBitmapMetadataWriter()	Tworzy wystąpienie InPlaceBitmapMetadataWriterklasy , które może służyć do aktualizowania metadanych mapy bitowej.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Finalize()	Zwalnia zasoby i wykonuje inne operacje oczyszczania przed odzyskaniem BitmapDecoder przez odzyskiwanie pamięci.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Konwertuje bieżącą wartość elementu BitmapDecoder na wartość String.
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)

Zdarzenia

DownloadCompleted	Występuje po zakończeniu pobierania BitmapDecoder zawartości mapy bitowej.
DownloadFailed	Występuje, gdy pobieranie zawartości mapy bitowej nie powiodło się.
DownloadProgress	Występuje, gdy nastąpił postęp pobierania BitmapDecoder zawartości mapy bitowej.

Dotyczy