BitmapDecoder Classe

Definição

Espaço de Nomes:
System.Windows.Media.Imaging
Assemblagem:
PresentationCore.dll

Representa um contentor para frames bitmap. Cada frame bitmap é um BitmapSource. Esta classe abstrata fornece um conjunto base de funcionalidades para todos os objetos decodificadores derivados.

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
Herança
Object
DispatcherObject
BitmapDecoder
Derivado

Exemplos

O exemplo seguinte demonstra como usar o Create(Uri, BitmapCreateOptions, BitmapCacheOption) método para criar um descodificador para uma dada imagem. A primeira BitmapFrame parte da imagem é usada como fonte de controlo Image .

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)

O exemplo de código seguinte demonstra como usar o sistema incorporado TiffBitmapDecoder para abrir e decodificar um bitmap de Formato de Ficheiro de Imagem Marcado (TIFF). O resultado BitmapSource é usado como o Source de um Image elemento.


// 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)

Observações

BitmapDecoder não é um BitmapFrame próprio; antes, é um recipiente para BitmapFrame objetos. Cada um BitmapFrame no recipiente pode ter atributos diferentes, incluindo tamanhos, resoluções ou paletas diferentes.

A menos que seja selecionado um codec específico, o Windows Presentation Foundation (WPF) utiliza a descoberta automática em tempo de execução para identificar o formato de uma imagem e associá-la ao codec apropriado. Este processo de descoberta permite que um codec desenvolvido por um fornecedor de software independente (ISV) seja automaticamente descoberto pelo sistema. Para selecionar um codec específico, deve ser usado o derivado BitmapDecoder ou BitmapEncoder, como a TiffBitmapDecoder classe.

O Tagged Image File Format (TIFF) e o Graphics Interchange Format (GIF) são os únicos formatos de imagem implementados que suportam múltiplos frames.

Construtores

Name Description
BitmapDecoder()

Inicializa uma nova instância de BitmapDecoder.

Propriedades

Name Description
CodecInfo

Recebe informação que descreve este codec.
ColorContexts

Obtém um valor que representa o perfil de cor associado a um bitmap, se for definido.
Dispatcher

Percebe o Dispatcher que isto DispatcherObject está associado.

(Herdado de DispatcherObject)
Frames

Obtém o conteúdo de um frame individual dentro de um bitmap.
IsDownloading

Recebe um valor que indica se o descodificador está atualmente a descarregar conteúdo.
Metadata

Obtém uma instância de BitmapMetadata que representa os metadados globais associados a este bitmap, se os metadados estiverem definidos.
Palette

Fica associado BitmapPalette a este descodificador.
Preview

Obtém um BitmapSource que representa a pré-visualização global deste bitmap, se for definido.
Thumbnail

Obtém um BitmapSource que representa a miniatura do bitmap, se for definido.

Métodos

Name Description
CheckAccess()

Determina se o thread que chama tem acesso a este DispatcherObject.

(Herdado de DispatcherObject)
Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Cria um BitmapDecoder a partir de a Stream usando o especificado BitmapCreateOptions e BitmapCacheOption.
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Cria a BitmapDecoder a partir de a Uri usando o especificado BitmapCreateOptions, BitmapCacheOption e RequestCachePolicy.
Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Cria um BitmapDecoder a partir de a Uri usando o especificado BitmapCreateOptions e BitmapCacheOption.
CreateInPlaceBitmapMetadataWriter()

Cria uma instância de InPlaceBitmapMetadataWriter, que pode ser usada para atualizar os metadados de um bitmap.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Finalize()

Liberta recursos e realiza outras operações de limpeza antes de ser BitmapDecoder recuperado pela recolha de lixo.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Converte o valor atual de a BitmapDecoder para um String.
VerifyAccess()

Faz cumprir que o thread que chama tem acesso a este DispatcherObject.

(Herdado de DispatcherObject)

evento

Name Description
DownloadCompleted

Ocorre quando termina BitmapDecoder de descarregar conteúdo bitmap.
DownloadFailed

Ocorre quando o conteúdo bitmap não foi descarregado.
DownloadProgress

Ocorre quando um BitmapDecoder progrediu a descarregar conteúdo bitmap.

Aplica-se a

Ver também