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を開き、デコード、Tagged Image File Format (TIFF)Tagged Image File Format (TIFF)ビットマップ。The following code example demonstrates how to use the built in TiffBitmapDecoder to open and decode a Tagged Image File Format (TIFF)Tagged Image File Format (TIFF) bitmap. その結果、BitmapSourceとして提供される、SourceImage要素。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.

Tagged Image File Format (TIFF)Tagged Image File Format (TIFF) グラフィックス インターチェンジ形式 (GIF)Graphics Interchange Format (GIF)は、複数のフレームをサポートするイメージ形式を実装します。and グラフィックス インターチェンジ形式 (GIF)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指定を使用してBitmapCreateOptionsBitmapCacheOptionします。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指定を使用してBitmapCreateOptionsBitmapCacheOptionします。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指定を使用してBitmapCreateOptionsBitmapCacheOptionRequestCachePolicyします。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()

現在の値に変換するBitmapDecoderStringConverts 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.

適用対象

こちらもご覧ください