BitmapDecoder クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ビットマップ フレームのコンテナーを表します。 各ビットマップ フレームは 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
- 継承
- 派生
例
次の例では、 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)
注釈
BitmapDecoder は BitmapFrame 自体ではなく、 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 を取得します。 |
メソッド
イベント
| 名前 | 説明 |
|---|---|
| DownloadCompleted |
BitmapDecoderがビットマップ コンテンツのダウンロードを完了したときに発生します。 |
| DownloadFailed |
ビットマップ コンテンツのダウンロードに失敗したときに発生します。 |
| DownloadProgress |
BitmapDecoderがビットマップ コンテンツのダウンロードを進行させたときに発生します。 |