D2D1_BITMAP_OPTIONS enumeration (d2d1_1.h)
Specifies how a bitmap can be used.
Syntax
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
} ;
Constants
D2D1_BITMAP_OPTIONS_NONE Value: 0x00000000 The bitmap is created with default properties. |
D2D1_BITMAP_OPTIONS_TARGET Value: 0x00000001 The bitmap can be used as a device context target. |
D2D1_BITMAP_OPTIONS_CANNOT_DRAW Value: 0x00000002 The bitmap cannot be used as an input. |
D2D1_BITMAP_OPTIONS_CPU_READ Value: 0x00000004 The bitmap can be read from the CPU. |
D2D1_BITMAP_OPTIONS_GDI_COMPATIBLE Value: 0x00000008 The bitmap works with ID2D1GdiInteropRenderTarget::GetDC. Note This flag is not available in Windows Store apps. |
D2D1_BITMAP_OPTIONS_FORCE_DWORD Value: 0xffffffff |
Remarks
D2D1_BITMAP_OPTIONS_NONE implies that none of the flags are set. This means that the bitmap can be used for drawing from, cannot be set as a target and cannot be read from by the CPU.
D2D1_BITMAP_OPTIONS_TARGET means that the bitmap can be specified as a target in ID2D1DeviceContext::SetTarget. If you also specify the D2D1_BITMAP_OPTIONS_CANNOT_DRAW flag the bitmap can be used a target but, it cannot be drawn from. Attempting to draw with a bitmap that has both flags set will result in the device context being put into an error state with D2DERR_BITMAP_CANNOT_DRAW.
D2D1_BITMAP_OPTIONS_CPU_READ means that the bitmap can be mapped by using ID2D1Bitmap1::Map. This flag requires D2D1_BITMAP_OPTIONS_CANNOT_DRAW and cannot be combined with any other flags. The bitmap must be updated with the CopyFromBitmap or CopyFromRenderTarget methods.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps] |
Minimum supported server | Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps] |
Header | d2d1_1.h |