BitmapDecoder Třída

Definice

Představuje kontejner pro rastrové snímky. Každý rastrový rámeček je BitmapSource. Tato abstraktní třída poskytuje základní sadu funkcí pro všechny odvozené dekodérové objekty.

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
Dědičnost
BitmapDecoder
Odvozené

Příklady

Následující příklad ukazuje, jak použít metodu Create(Uri, BitmapCreateOptions, BitmapCacheOption) k vytvoření dekodéru pro daný obrázek. BitmapFrame První obrázek se používá jako zdroj Image ovládacího prvku.

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)

Následující příklad kódu ukazuje použití integrované TiffBitmapDecoder k otevření a dekódování tagged Image File Format (TIFF). Výsledek BitmapSource se použije jako Source Image prvek.


// 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)

Poznámky

BitmapDecoder není sama o BitmapFrame sobě. Spíše se jedná o kontejner pro BitmapFrame objekty. Každý BitmapFrame v kontejneru může mít různé atributy, včetně různých velikostí, rozlišení nebo palet.

Pokud není vybraný konkrétní kodek, Windows Presentation Foundation (WPF) používá automatické zjišťování za běhu k identifikaci formátu obrázku a jeho shody s příslušným kodekem. Tento proces zjišťování umožňuje, aby systém automaticky zjistil kodek vyvinutý nezávislým dodavatelem softwaru (ISV). Chcete-li vybrat konkrétní kodek, měl by být použit odvozený BitmapDecoder nebo BitmapEncoder, například TiffBitmapDecoder třída.

Tagged Image File Format (TIFF) a Graphics Interchange Format (GIF) jsou jediné implementované formáty obrázků, které podporují více snímků.

Konstruktory

BitmapDecoder()

Inicializuje novou instanci BitmapDecoder.

Vlastnosti

CodecInfo

Získá informace, které popisují tento kodek.

ColorContexts

Získá hodnotu, která představuje barevný profil asociované s rastrovým obrázkem, pokud je definován.

Dispatcher

Získá to DispatcherObject je přidruženoDispatcher.

(Zděděno od DispatcherObject)
Frames

Získá obsah jednotlivých snímků v rastrovém obrázku.

IsDownloading

Získá hodnotu, která označuje, zda dekodér aktuálně stahuje obsah.

Metadata

Získá instanci BitmapMetadata , která představuje globální metadata přidružená k tomuto rastrovém obrázku, pokud jsou definována metadata.

Palette

BitmapPalette Získá přidružené k tomuto dekodéru.

Preview

BitmapSource Získá, který představuje globální náhled tohoto rastrového obrázku, pokud je definován.

Thumbnail

BitmapSource Získá, který představuje miniaturu rastrového obrázku, pokud je definován.

Metody

CheckAccess()

Určuje, zda má volající vlákno přístup k tomuto DispatcherObject.

(Zděděno od DispatcherObject)
Create(Stream, BitmapCreateOptions, BitmapCacheOption)

BitmapDecoder Vytvoří ze zadaného BitmapCreateOptions objektu Stream a BitmapCacheOption.

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

BitmapDecoder Vytvoří ze zadaného BitmapCreateOptions objektu Uri a BitmapCacheOption.

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

BitmapDecoder Vytvoří ze zadaného BitmapCreateOptionsBitmapCacheOption RequestCachePolicyobjektu Uri a .

CreateInPlaceBitmapMetadataWriter()

Vytvoří instanci InPlaceBitmapMetadataWriter, kterou lze použít k aktualizaci metadat rastrového obrázku.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
Finalize()

Uvolní prostředky a provede další operace čištění před BitmapDecoder uvolněním paměti.

GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetType()

Type Získá aktuální instanci.

(Zděděno od Object)
MemberwiseClone()

Vytvoří použádnou kopii aktuálního souboru Object.

(Zděděno od Object)
ToString()

Převede aktuální hodnotu na BitmapDecoder String.

VerifyAccess()

Vynucuje, aby volající vlákno má k tomuto DispatcherObjectpřístupu přístup .

(Zděděno od DispatcherObject)

událost

DownloadCompleted

Nastane po dokončení stahování rastrového BitmapDecoder obsahu.

DownloadFailed

Nastane, když se nepodařilo stáhnout rastrový obsah.

DownloadProgress

Nastane, když BitmapDecoder došlo k pokroku při stahování obsahu rastrového obrázku.

Platí pro

Viz také