BitmapDecoder クラス

定義

ビットマップ フレームのコンテナーを表します。 各ビットマップ フレームは BitmapSourceです。 この抽象クラスは、すべての派生デコーダー オブジェクトの基本機能セットを提供します。

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
継承
BitmapDecoder
派生

次の例では、 Create(Uri, BitmapCreateOptions, BitmapCacheOption) メソッドを使用して、特定のイメージのデコーダーを作成する方法を示します。 イメージの最初の BitmapFrame は、 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)

次のコード例では、組み込みの TiffBitmapDecoder を使用して、タグ付きイメージ ファイル形式 (TIFF) ビットマップを開いてデコードする方法を示します。 結果のBitmapSourceは、Image要素のSourceとして使用されます。


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

注釈

BitmapDecoderBitmapFrame 自体ではなく、 BitmapFrame オブジェクトのコンテナーです。 コンテナー内の各 BitmapFrame には、異なるサイズ、解像度、パレットなど、異なる属性が含まれる可能性があります。

特定のコーデックが選択されていない限り、Windows Presentation Foundation (WPF) は自動ランタイム検出を使用してイメージの形式を識別し、適切なコーデックと照合します。 この検出プロセスにより、独立系ソフトウェア ベンダー (ISV) によって開発されたコーデックをシステムで自動的に検出できます。 特定のコーデックを選択するには、TiffBitmapDecoder クラスなどの派生BitmapDecoderまたはBitmapEncoderを使用する必要があります。

タグ付きイメージ ファイル形式 (TIFF) とグラフィックス交換形式 (GIF) は、複数のフレームをサポートする唯一の実装イメージ形式です。

コンストラクター

名前 説明
BitmapDecoder()

BitmapDecoderの新しいインスタンスを初期化します。

プロパティ

名前 説明
CodecInfo

このコーデックを記述する情報を取得します。

ColorContexts

ビットマップに関連付けられているカラー プロファイルが定義されている場合は、その色プロファイルを表す値を取得します。

Dispatcher

このDispatcherが関連付けられているDispatcherObjectを取得します。

(継承元 DispatcherObject)
Frames

ビットマップ内の個々のフレームの内容を取得します。

IsDownloading

デコーダーが現在コンテンツをダウンロードしているかどうかを示す値を取得します。

Metadata

メタデータが定義されている場合、このビットマップに関連付けられているグローバル メタデータを表す BitmapMetadata のインスタンスを取得します。

Palette

このデコーダーに関連付けられている BitmapPalette を取得します。

Preview

定義されている場合、このビットマップのグローバル プレビューを表す BitmapSource を取得します。

Thumbnail

ビットマップのサムネイルが定義されている場合は、そのサムネイルを表す BitmapSource を取得します。

メソッド

名前 説明
CheckAccess()

呼び出し元のスレッドがこの DispatcherObjectにアクセスできるかどうかを判断します。

(継承元 DispatcherObject)
Create(Stream, BitmapCreateOptions, BitmapCacheOption)

指定したBitmapCreateOptionsBitmapCacheOptionを使用して、StreamからBitmapDecoderを作成します。

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

指定したBitmapCreateOptionsBitmapCacheOption、およびRequestCachePolicyを使用して、UriからBitmapDecoderを作成します。

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

指定したBitmapCreateOptionsBitmapCacheOptionを使用して、UriからBitmapDecoderを作成します。

CreateInPlaceBitmapMetadataWriter()

ビットマップのメタデータを更新するために使用できる InPlaceBitmapMetadataWriterのインスタンスを作成します。

Equals(Object)

指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
Finalize()

ガベージ コレクションによって BitmapDecoder が回収される前に、リソースを解放し、その他のクリーンアップ操作を実行します。

GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Objectの簡易コピーを作成します。

(継承元 Object)
ToString()

BitmapDecoderの現在の値をStringに変換します。

VerifyAccess()

呼び出し元のスレッドがこの DispatcherObjectにアクセスできるように強制します。

(継承元 DispatcherObject)

イベント

名前 説明
DownloadCompleted

BitmapDecoderがビットマップ コンテンツのダウンロードを完了したときに発生します。

DownloadFailed

ビットマップ コンテンツのダウンロードに失敗したときに発生します。

DownloadProgress

BitmapDecoderがビットマップ コンテンツのダウンロードを進行させたときに発生します。

適用対象

こちらもご覧ください