BitmapDecoder BitmapDecoder BitmapDecoder BitmapDecoder Class

Определение

Представляет контейнер для кадров растрового изображения.Represents a container for bitmap frames. Каждый кадр растрового изображения является объектом BitmapSource.Each bitmap frame is a BitmapSource. Этот абстрактный класс предоставляет базовый набор функций для всех производных объектов декодеров.This abstract class provides a base set of functionality for all derived decoder objects.

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
Наследование
Производный

Примеры

В следующем примере демонстрируется использование Create(Uri, BitmapCreateOptions, BitmapCacheOption) метода для создания декодера для данного изображения.The following example demonstrates how to use the Create(Uri, BitmapCreateOptions, BitmapCacheOption) method to create a decoder for a given image. Первый BitmapFrame из изображений используется в качестве источника Image элемента управления.The first BitmapFrame of the image is used as the source of an Image control.

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)

В следующем примере кода показано, как использовать встроенную в TiffBitmapDecoder для открытия и Формат TIFF (Tagged Image File Format)Tagged Image File Format (TIFF) декодирования точечного рисунка.The following code example demonstrates how to use the built in TiffBitmapDecoder to open and decode a Формат TIFF (Tagged Image File Format)Tagged Image File Format (TIFF) bitmap. Результирующий BitmapSource объект используется Source как Image элемент.The resulting BitmapSource is used as the Source of an 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)

Комментарии

BitmapDecoderне является BitmapFrame самим, а является контейнером для объектов. BitmapFrameBitmapDecoder is not a BitmapFrame itself; rather, it is a container for BitmapFrame objects. Каждый BitmapFrame в контейнере может иметь различные атрибуты, включая различные размеры, разрешения или палитры.Each BitmapFrame in the container can potentially have different attributes, including different sizes, resolutions, or palettes.

Если не выбран специальный кодек, службы Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) используют автоматическое обнаружение во время выполнения, чтобы узнать формат изображения и сопоставить его с соответствующим кодеком.Unless a specific codec is selected, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) uses automatic run-time discovery to identify the format of an image and match it with the appropriate codec. Этот процесс обнаружения позволяет автоматически обнаруживать кодек, разработанный независимый поставщик программных продуктов (ISV)independent software vendor (ISV) объектом, в системе.This discovery process allows a codec developed by an независимый поставщик программных продуктов (ISV)independent software vendor (ISV) to be automatically discoverable by the system. Чтобы выбрать конкретный кодек, следует использовать BitmapDecoder производный BitmapEncoderили, например TiffBitmapDecoder , класс.To select a specific codec, the derived BitmapDecoder or BitmapEncoder, such as the TiffBitmapDecoder class, should be used.

Формат TIFF (Tagged Image File Format)Tagged Image File Format (TIFF)и Формат GIF (Graphics Interchange Format)Graphics Interchange Format (GIF) являются единственными реализованными форматами изображений, поддерживающими несколько кадров.and Формат GIF (Graphics Interchange Format)Graphics Interchange Format (GIF) are the only implemented image formats that support multiple frames.

Конструкторы

BitmapDecoder() BitmapDecoder() BitmapDecoder() BitmapDecoder()

Инициализирует новый экземпляр BitmapDecoder.Initializes a new instance of BitmapDecoder.

Свойства

CodecInfo CodecInfo CodecInfo CodecInfo

Получает сведения, описывающие этот кодек.Gets information that describes this codec.

ColorContexts ColorContexts ColorContexts ColorContexts

Получает значение, представляющее цветовой профиль, связанный с растровым изображением, если он задан.Gets a value that represents the color profile associated with a bitmap, if one is defined.

Dispatcher Dispatcher Dispatcher Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
Frames Frames Frames Frames

Получает содержимое отдельных кадров в точечном рисунке.Gets the content of an individual frame within a bitmap.

IsDownloading IsDownloading IsDownloading IsDownloading

Получает значение, указывающее, находится ли декодер в процессе загрузки содержимого.Gets a value that indicates if the decoder is currently downloading content.

Metadata Metadata Metadata Metadata

Возвращает экземпляр класса BitmapMetadata, представляющий глобальные метаданные, связанные с этим растровым изображением, если метаданные определены.Gets an instance of BitmapMetadata that represents the global metadata associated with this bitmap, if metadata is defined.

Palette Palette Palette Palette

Получает объект BitmapPalette, связанный с этим декодером.Gets the BitmapPalette associated with this decoder.

Preview Preview Preview Preview

Возвращает объект BitmapSource, представляющий глобальный предварительный просмотр растрового изображения, если он определен.Gets a BitmapSource that represents the global preview of this bitmap, if one is defined.

Thumbnail Thumbnail Thumbnail Thumbnail

Возвращает объект BitmapSource, представляющий эскиз растрового изображения, если он определен.Gets a BitmapSource that represents the thumbnail of the bitmap, if one is defined.

Методы

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
Create(Stream, BitmapCreateOptions, BitmapCacheOption) Create(Stream, BitmapCreateOptions, BitmapCacheOption) Create(Stream, BitmapCreateOptions, BitmapCacheOption) Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Создает BitmapDecoder из Stream с использованием заданных BitmapCreateOptions и BitmapCacheOption.Creates a BitmapDecoder from a Stream by using the specified BitmapCreateOptions and BitmapCacheOption.

Create(Uri, BitmapCreateOptions, BitmapCacheOption) Create(Uri, BitmapCreateOptions, BitmapCacheOption) Create(Uri, BitmapCreateOptions, BitmapCacheOption) Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Создает BitmapDecoder из Uri с использованием заданных BitmapCreateOptions и BitmapCacheOption.Creates a BitmapDecoder from a Uri by using the specified BitmapCreateOptions and BitmapCacheOption.

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Создает BitmapDecoder из Uri с использованием заданных BitmapCreateOptions, BitmapCacheOption и RequestCachePolicy.Creates a BitmapDecoder from a Uri by using the specified BitmapCreateOptions, BitmapCacheOption and RequestCachePolicy.

CreateInPlaceBitmapMetadataWriter() CreateInPlaceBitmapMetadataWriter() CreateInPlaceBitmapMetadataWriter() CreateInPlaceBitmapMetadataWriter()

Создает экземпляр InPlaceBitmapMetadataWriter, который можно использовать для обновления метаданных растрового изображения.Creates an instance of InPlaceBitmapMetadataWriter, which can be used to update the metadata of a bitmap.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Освобождает ресурсы и выполняет другие операции очистки, перед тем как объект BitmapDecoder будет удален при сборке мусора.Frees resources and performs other cleanup operations before the BitmapDecoder is reclaimed by garbage collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Преобразует текущее значение объекта BitmapDecoder в String.Converts the current value of a BitmapDecoder to a String.

VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

События

DownloadCompleted DownloadCompleted DownloadCompleted DownloadCompleted

Происходит, если BitmapDecoder завершает загрузку содержимого растрового изображения.Occurs when a BitmapDecoder has finished downloading bitmap content.

DownloadFailed DownloadFailed DownloadFailed DownloadFailed

Происходит при невозможности скачивания содержимого растрового изображения.Occurs when bitmap content failed to download.

DownloadProgress DownloadProgress DownloadProgress DownloadProgress

Происходит, когда BitmapDecoder завершает очередной этап загрузки содержимого растрового изображения.Occurs when a BitmapDecoder has made progress downloading bitmap content.

Применяется к

Дополнительно