D2D1_BITMAP_OPTIONS列挙 (d2d1_1.h)

  • [アーティクル]

ビットマップを使用する方法を指定します。

構文

typedef enum D2D1_BITMAP_OPTIONS {
  D2D1_BITMAP_OPTIONS_NONE = 0x00000000,
  D2D1_BITMAP_OPTIONS_TARGET = 0x00000001,
  D2D1_BITMAP_OPTIONS_CANNOT_DRAW = 0x00000002,
  D2D1_BITMAP_OPTIONS_CPU_READ = 0x00000004,
  D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE = 0x00000008,
  D2D1_BITMAP_OPTIONS_FORCE_DWORD = 0xffffffff
} ;

定数

 
D2D1_BITMAP_OPTIONS_NONE
値: 0x00000000
ビットマップは既定のプロパティで作成されます。
D2D1_BITMAP_OPTIONS_TARGET
値: 0x00000001
ビットマップは、デバイス コンテキスト ターゲットとして使用できます。
D2D1_BITMAP_OPTIONS_CANNOT_DRAW
値: 0x00000002
ビットマップを入力として使用することはできません。
D2D1_BITMAP_OPTIONS_CPU_READ
値: 0x00000004
ビットマップは CPU から読み取ることができます。
D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE
値: 0x00000008
ビットマップは ID2D1GdiInteropRenderTarget::GetDC で動作します。

メモ このフラグは、Windows ストア アプリでは使用できません。

 
D2D1_BITMAP_OPTIONS_FORCE_DWORD
値: 0xffffffff

解説

D2D1_BITMAP_OPTIONS_NONE は、どのフラグも設定されていないことを意味します。 これは、ビットマップをから描画するために使用でき、ターゲットとして設定できず、CPU から読み取ることができないことを意味します。

D2D1_BITMAP_OPTIONS_TARGET は、ビットマップを ID2D1DeviceContext::SetTarget のターゲットとして指定できることを意味します。 D2D1_BITMAP_OPTIONS_CANNOT_DRAW フラグも指定した場合、ビットマップはターゲットを使用できますが、描画元にすることはできません。 両方のフラグが設定されたビットマップで描画しようとすると、デバイス コンテキストが D2DERR_BITMAP_CANNOT_DRAW でエラー状態になります。

D2D1_BITMAP_OPTIONS_CPU_READ は、 ID2D1Bitmap1::Map を使用してビットマップをマップできることを意味します。 このフラグには D2D1_BITMAP_OPTIONS_CANNOT_DRAW が必要であり、他のフラグと組み合わせることはできません。 ビットマップは 、CopyFromBitmap メソッドまたは CopyFromRenderTarget メソッドで更新する必要があります。

メモD2D1_BITMAP_OPTIONS_CANNOT_DRAWは、ビットマップの目的がターゲットのみの場合、またはビットマップが マップされる場合にのみ使用する必要があります。
 
D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE は、このビットマップに関連付けられた DC を取得できるということです。 これは 、D2D1_BITMAP_OPTIONS_TARGETと組み合わせて使用する必要があります。 DXGI_FORMATは、DXGI_FORMAT_B8G8R8A8_UNORMまたはDXGI_FORMAT_B8G8R8A8_UNORM_SRGBである必要があります。

要件

   
サポートされている最小のクライアント Windows 8 および Windows 7 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 および Windows Server 2008 R2 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
Header d2d1_1.h

関連項目

ID2D1DeviceContext::CreateBitmap