Udostępnij za pośrednictwem


BitmapDecoder Klasa

Definicja

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
BitmapDecoder
Pochodne

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

Zobacz też