BitmapDecoder Třída

Reference

Definice

Obor názvů:: System.Windows.Media.Imaging

Sestavení:: PresentationCore.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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: Object

DispatcherObject
BitmapDecoder

Odvozené: 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

Více…

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 BitmapCreateOptions BitmapCacheOption 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

Sdílet prostřednictvím