SoftwareBitmap クラス

定義

名前空間:

Windows.Graphics.Imaging

非圧縮ビットマップを表します。

public ref class SoftwareBitmap sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.GCPressure]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Graphics.Imaging.ISoftwareBitmapFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class SoftwareBitmap final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.GCPressure]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Graphics.Imaging.ISoftwareBitmapFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SoftwareBitmap : System.IDisposable

function SoftwareBitmap(format, width, height, alpha)

Public NotInheritable Class SoftwareBitmap
Implements IDisposable

継承

Object Platform::Object IInspectable SoftwareBitmap

属性

ActivatableAttribute ContractVersionAttribute GCPressureAttribute MarshalingBehaviorAttribute ThreadingAttribute

実装

IClosable IDisposable

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

このクラスを使用するサンプル アプリケーションには、 カメラ フレームのサンプルが含まれます。

ピクセル データにアクセスする方法を示すコード例については、 WriteableBitmap.PixelBuffer プロパティを参照してください ( 「CopyToBuffer」および「 CopyFromBuffer」も参照してください)。

注釈

このクラスは、さまざまなイメージング API で簡単に使用できるビットマップの表現を提供します。 GetSoftwareBitmapAsync を使用して、イメージ ファイルなどのストリーム リソースから SoftwareBitmap を作成します。

CopyToBuffer と CopyFromBuffer を使用して、SoftwareBitmap と WriteableBitmap の PixelBuffer の間でピクセル データを前後にコピーします。 CreateCopyFromSurfaceAsync を使用して、IDirect3DSurface から SoftwareBitmap を作成します。 ISoftwareBitmapNativeFactory::CreateFromMF2DBuffer2 を使用して、IMF2DBuffer2 から SoftwareBitmap を作成します。 ISoftwareBitmapNativeFactory::CreateFromIWICBitmap を使用して、IWICBitmap から SoftwareBitmap を作成します。

コンストラクター

SoftwareBitmap(BitmapPixelFormat, Int32, Int32)	SoftwareBitmap クラスの新しいインスタンスを初期化します。
SoftwareBitmap(BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	SoftwareBitmap クラスの新しいインスタンスを初期化します。

プロパティ

BitmapAlphaMode	ソフトウェア ビットマップのアルファ モードを取得します。
BitmapPixelFormat	ソフトウェア ビットマップのピクセル形式を取得します。
DpiX	X 方向のソフトウェア ビットマップの 1 インチあたりのドット数を取得または設定します。
DpiY	Y 方向のソフトウェア ビットマップの 1 インチあたりのドット数を取得または設定します。
IsReadOnly	ソフトウェア ビットマップを変更できるかどうかを示す値を取得します。
PixelHeight	ソフトウェア ビットマップの高さをピクセル単位で取得します。
PixelWidth	ソフトウェア ビットマップの幅をピクセル単位で取得します。

メソッド

Close()	オブジェクトと関連付けられているリソースを破棄します。
Convert(SoftwareBitmap, BitmapPixelFormat)	既存の SoftwareBitmap を別のピクセル形式の SoftwareBitmap に変換します。
Convert(SoftwareBitmap, BitmapPixelFormat, BitmapAlphaMode)	既存の SoftwareBitmap を別のピクセル形式またはアルファ モードの SoftwareBitmap に変換します。
Copy(SoftwareBitmap)	指定された SoftwareBitmap オブジェクトのコピーを作成します。
CopyFromBuffer(IBuffer)	IBuffer から SoftwareBitmap にピクセル データをコピーします。
CopyTo(SoftwareBitmap)	現在の SoftwareBitmap を指定された SoftwareBitmap オブジェクトにコピーします。
CopyToBuffer(IBuffer)	指定した IBuffer にソフトウェア ビットマップ ピクセル データをコピーします。
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32)	指定されたバッファーのディープ コピーを実行して、新しい SoftwareBitmap を作成します。 新しい SoftwareBitmap のデータを変更しても、作成元のバッファーには影響しません。
CreateCopyFromBuffer(IBuffer, BitmapPixelFormat, Int32, Int32, BitmapAlphaMode)	指定されたバッファーのディープ コピーを実行して、新しい SoftwareBitmap を作成します。 新しい SoftwareBitmap のデータを変更しても、作成元のバッファーには影響しません。
CreateCopyFromSurfaceAsync(IDirect3DSurface)	提供された IDirect3DSurface のディープ コピーを実行して、新しい SoftwareBitmap を非同期的に作成します。 新しい SoftwareBitmap のデータを変更しても、作成元のサーフェスには影響しません。
CreateCopyFromSurfaceAsync(IDirect3DSurface, BitmapAlphaMode)	提供された IDirect3DSurface のディープ コピーを実行して、新しい SoftwareBitmap を非同期的に作成します。 新しい SoftwareBitmap のデータを変更しても、作成元のサーフェスには影響しません。
Dispose()	アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。
GetReadOnlyView()	SoftwareBitmap オブジェクトの読み取り専用表現を取得します。
LockBuffer(BitmapBufferAccessMode)	ソフトウェア ビットマップのピクセル データを直接操作できる BitmapBuffer オブジェクトを取得します。

こちらもご覧ください

• IClosable
• カメラ フレームのサンプル