SoftwareBitmap クラス

定義

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

public ref class SoftwareBitmap sealed : IClosable
/// [Windows.Foundation.Metadata.Activatable(Windows.Graphics.Imaging.ISoftwareBitmapFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class SoftwareBitmap final : 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.Activatable(typeof(Windows.Graphics.Imaging.ISoftwareBitmapFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class SoftwareBitmap : System.IDisposable
[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
属性
実装

Windows の要件

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

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

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

注釈

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

CopyToBufferCopyFromBuffer を使用して、SoftwareBitmapWriteableBitmapPixelBuffer の間でピクセル データを前後にコピーします。 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 オブジェクトを取得します。

適用対象

こちらもご覧ください