BitmapDecoder BitmapDecoder BitmapDecoder BitmapDecoder Class

Définition

Représente un conteneur pour des frames de bitmaps.Represents a container for bitmap frames. Chaque frame de bitmap est un BitmapSource.Each bitmap frame is a BitmapSource. Cette classe abstraite fournit un jeu de fonctionnalités de base pour tous les objets décodeurs dérivés.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
Héritage
Dérivé

Exemples

L’exemple suivant montre comment utiliser le Create(Uri, BitmapCreateOptions, BitmapCacheOption) méthode pour créer un décodeur pour une image donnée.The following example demonstrates how to use the Create(Uri, BitmapCreateOptions, BitmapCacheOption) method to create a decoder for a given image. La première BitmapFrame de l’image est utilisée comme source d’un Image contrôle.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)

L’exemple de code suivant illustre l’utilisation intégrée dans TiffBitmapDecoder pour ouvrir et décoder une TIFF (Tagged Image File Format)Tagged Image File Format (TIFF) bitmap.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. Résultant BitmapSource est utilisé comme le Source d’un Image élément.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)

Remarques

BitmapDecoder n’est pas un BitmapFrame lui-même ; au lieu de cela, c’est un conteneur pour BitmapFrame objets.BitmapDecoder is not a BitmapFrame itself; rather, it is a container for BitmapFrame objects. Chaque BitmapFrame dans le conteneur peut avoir des attributs différents, y compris des tailles, résolutions ou des palettes.Each BitmapFrame in the container can potentially have different attributes, including different sizes, resolutions, or palettes.

Sauf si un codec spécifique est sélectionné, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) utilise la détection d’exécution automatique pour identifier le format d’une image et la faire correspondre avec le codec approprié.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. Ce processus de découverte autorise un codec développé par un éditeur de logiciels indépendant (ISV)independent software vendor (ISV) automatiquement détectable par le système.This discovery process allows a codec developed by an éditeur de logiciels indépendant (ISV)independent software vendor (ISV) to be automatically discoverable by the system. Pour sélectionner un codec spécifique, dérivé BitmapDecoder ou BitmapEncoder, telles que la TiffBitmapDecoder classe, doit être utilisé.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) et GIF (Graphics Interchange Format)Graphics Interchange Format (GIF) sont les seules implémenté les formats d’image qui prennent en charge plusieurs frames.and GIF (Graphics Interchange Format)Graphics Interchange Format (GIF) are the only implemented image formats that support multiple frames.

Constructeurs

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

Initialise une nouvelle instance de BitmapDecoder.Initializes a new instance of BitmapDecoder.

Propriétés

CodecInfo CodecInfo CodecInfo CodecInfo

Obtient des informations qui décrivent ce codec.Gets information that describes this codec.

ColorContexts ColorContexts ColorContexts ColorContexts

Obtient une valeur qui représente le profil de couleurs associé à une image bitmap, le cas échéant.Gets a value that represents the color profile associated with a bitmap, if one is defined.

Dispatcher Dispatcher Dispatcher Dispatcher

Obtient le Dispatcher associé à DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
Frames Frames Frames Frames

Obtient le contenu d’une image individuelle dans une image bitmap.Gets the content of an individual frame within a bitmap.

IsDownloading IsDownloading IsDownloading IsDownloading

Obtient une valeur qui indique si le décodeur télécharge actuellement le contenu.Gets a value that indicates if the decoder is currently downloading content.

Metadata Metadata Metadata Metadata

Obtient une instance de BitmapMetadata qui représente les métadonnées globales associées à cette image bitmap, si des métadonnées sont définies.Gets an instance of BitmapMetadata that represents the global metadata associated with this bitmap, if metadata is defined.

Palette Palette Palette Palette

Obtient le BitmapPalette associé à ce décodeur.Gets the BitmapPalette associated with this decoder.

Preview Preview Preview Preview

Obtient un BitmapSource qui représente l’aperçu global de cette image bitmap, s’il est défini.Gets a BitmapSource that represents the global preview of this bitmap, if one is defined.

Thumbnail Thumbnail Thumbnail Thumbnail

Obtient un BitmapSource qui représente la miniature de l’image bitmap, si elle est définie.Gets a BitmapSource that represents the thumbnail of the bitmap, if one is defined.

Méthodes

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

Détermine si le thread appelant a accès à ce 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)

Crée un BitmapDecoder à partir d'un Stream en utilisant les BitmapCreateOptions et BitmapCacheOption spécifiés.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)

Crée un BitmapDecoder à partir d'un Uri en utilisant les BitmapCreateOptions et BitmapCacheOption spécifiés.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)

Crée un BitmapDecoder à partir d'un Uri en utilisant les BitmapCreateOptions, le BitmapCacheOption et le RequestCachePolicy spécifiés.Creates a BitmapDecoder from a Uri by using the specified BitmapCreateOptions, BitmapCacheOption and RequestCachePolicy.

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

Crée une instance de InPlaceBitmapMetadataWriter, qui peut être utilisée pour mettre à jour les métadonnées d’une bitmap.Creates an instance of InPlaceBitmapMetadataWriter, which can be used to update the metadata of a bitmap.

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

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

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

Libère les ressources et exécute d’autres opérations de nettoyage avant la récupération du BitmapDecoder par la garbage collection.Frees resources and performs other cleanup operations before the BitmapDecoder is reclaimed by garbage collection.

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

Fait office de fonction de hachage par défaut.Serves as the default hash function.

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

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

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

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

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

Convertit la valeur actuelle d'un BitmapDecoder en String.Converts the current value of a BitmapDecoder to a String.

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

Garantit que le thread appelant a accès à DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Événements

DownloadCompleted DownloadCompleted DownloadCompleted DownloadCompleted

Se produit quand un BitmapDecoder a fini de télécharger le contenu de la bitmap.Occurs when a BitmapDecoder has finished downloading bitmap content.

DownloadFailed DownloadFailed DownloadFailed DownloadFailed

Se produit quand le téléchargement du contenu de la bitmap a échoué.Occurs when bitmap content failed to download.

DownloadProgress DownloadProgress DownloadProgress DownloadProgress

Se produit quand un BitmapDecoder a progressé dans le téléchargement du contenu de la bitmap.Occurs when a BitmapDecoder has made progress downloading bitmap content.

S’applique à

Voir aussi