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 ; вместо этого он представляет собой контейнер для BitmapFrame объектов.BitmapDecoder 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.

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

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