BitmapDecoder Třída
Definice
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::DispatcherObjectpublic abstract class BitmapDecoder : System.Windows.Threading.DispatcherObjecttype BitmapDecoder = class
inherit DispatcherObjectPublic MustInherit Class BitmapDecoder
Inherits DispatcherObject- Dědičnost
- 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. |