BitmapDecoder Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bit eşlem çerçeveleri için bir kapsayıcıyı temsil eder. Her bit eşlem çerçevesi bir BitmapSourceşeklindedir. Bu soyut sınıf, türetilmiş tüm kod çözücü nesneleri için temel bir işlev kümesi sağlar.
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
- Devralma
- Türetilmiş
Örnekler
Aşağıdaki örnekte, belirli bir görüntü için kod çözücü oluşturmak için yönteminin nasıl kullanılacağı Create(Uri, BitmapCreateOptions, BitmapCacheOption) gösterilmektedir. Görüntünün ilki BitmapFrame bir Image denetimin kaynağı olarak kullanılır.
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)
Aşağıdaki kod örneği, Etiketli Görüntü Dosya Biçimi (TIFF) bit eşlemini açmak ve kodunu çözmek için yerleşik TiffBitmapDecoder öğesinin nasıl kullanılacağını gösterir. BitmapSource Sonuçta elde edilen öğe Image olarak Source kullanılır.
// 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)
Açıklamalar
BitmapDecoder kendisi değildir BitmapFrame ; bunun yerine nesneler için BitmapFrame bir kapsayıcıdır. Kapsayıcıdaki her BitmapFrame bir öğe farklı boyutlar, çözünürlükler veya paletler gibi farklı özniteliklere sahip olabilir.
Belirli bir codec seçilmediği sürece, Windows Presentation Foundation (WPF) görüntünün biçimini tanımlamak ve uygun codec ile eşleştirmek için otomatik çalışma zamanı bulma kullanır. Bu bulma işlemi, bağımsız bir yazılım satıcısı (ISV) tarafından geliştirilen bir codec'in sistem tarafından otomatik olarak bulunabilir olmasını sağlar. Belirli bir codec'i seçmek için türetilmiş BitmapDecoder veya BitmapEncodersınıfı gibi TiffBitmapDecoder kullanılmalıdır.
Etiketli Görüntü Dosya Biçimi (TIFF) ve Grafik Değişim Biçimi (GIF), birden çok kareyi destekleyen tek uygulanan görüntü biçimleridir.
Oluşturucular
BitmapDecoder() |
öğesinin yeni bir örneğini BitmapDecoderbaşlatır. |
Özellikler
CodecInfo |
Bu codec bileşenini açıklayan bilgileri alır. |
ColorContexts |
Tanımlanmışsa, bit eşlem ile ilişkili renk profilini temsil eden bir değer alır. |
Dispatcher |
Dispatcher Bunun DispatcherObject ilişkili olduğunu alır. (Devralındığı yer: DispatcherObject) |
Frames |
Bit eşlem içindeki tek bir çerçevenin içeriğini alır. |
IsDownloading |
Kod çözücüün şu anda içerik indirip indirmediğini belirten bir değer alır. |
Metadata |
Meta veriler tanımlanmışsa, bu bit eşlemle ilişkili genel meta verileri temsil eden bir örneğini BitmapMetadata alır. |
Palette |
Bu kod çözücüyle ilişkili öğesini BitmapPalette alır. |
Preview |
BitmapSource Tanımlanmışsa, bu bit eşlem genel önizlemesini temsil eden bir alır. |
Thumbnail |
BitmapSource Tanımlanmışsa bit eşlem küçük resmini temsil eden bir alır. |
Yöntemler
CheckAccess() |
Çağıran iş parçacığının bu DispatcherObjectöğesine erişimi olup olmadığını belirler. (Devralındığı yer: DispatcherObject) |
Create(Stream, BitmapCreateOptions, BitmapCacheOption) |
belirtilen BitmapCreateOptions ve BitmapCacheOptionkullanarak a'dan Stream oluştururBitmapDecoder. |
Create(Uri, BitmapCreateOptions, BitmapCacheOption) |
belirtilen BitmapCreateOptions ve BitmapCacheOptionkullanarak a'dan Uri oluştururBitmapDecoder. |
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) |
Belirtilen BitmapCreateOptionsve BitmapCacheOption RequestCachePolicykullanarak a'dan oluşturur.BitmapDecoder Uri |
CreateInPlaceBitmapMetadataWriter() |
bit eşlem meta InPlaceBitmapMetadataWriterverilerini güncelleştirmek için kullanılabilecek bir örneği oluşturur. |
Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
Finalize() |
kaynakları serbest kaldırır ve çöp toplama tarafından geri kazanılmadan önce BitmapDecoder diğer temizleme işlemlerini gerçekleştirir. |
GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
ToString() |
geçerli değerini değerine BitmapDecoder Stringdönüştürür. |
VerifyAccess() |
Çağıran iş parçacığının bu DispatcherObjecterişimine sahip olmasını zorlar. (Devralındığı yer: DispatcherObject) |
Ekinlikler
DownloadCompleted |
BitmapDecoder Bit eşlem içeriğinin indirilmesi tamamlandığında gerçekleşir. |
DownloadFailed |
Bit eşlem içeriği indirilemediğinde gerçekleşir. |
DownloadProgress |
bit eşlem içeriği indirilirken ilerleme kaydedildiğinde BitmapDecoder gerçekleşir. |