Defines

Bitmap Flags

These flag bits describe properites of the bitmap. More...

Defines

#define  MAP_NOFLAGS   ((DWORD)0)
  The bitmap has none of the characteristics below.
#define  MAP_READY   ((DWORD)(1<<0))
  This bitmap has had memory allocated to it, or is accessible directly.
#define  MAP_HAS_ALPHA   ((DWORD)(1<<1))
  This flag can be checked from a BitmapInfo instance (bi.Flags()&MAP_HAS_ALPHA)), but not from a Bitmap instance (bmap->Flags() & MAP_HAS_ALPHA).
#define  MAP_ALPHA_PREMULTIPLIED   ((DWORD)(1<<2))
  The bitmap has pre-multiplied alpha.
#define  MAP_PALETTED   ((DWORD)(1<<3))
  The bitmap uses a palette (not true color).
#define  MAP_FRAME_SYSTEM_LOCKED   ((DWORD)(1<<4))
  This flag is no longer used.
#define  MAP_DITHERED   ((DWORD)(1<<5))
  The bitmap is dithered.
#define  MAP_FLIPPED   ((DWORD)(1<<6))
  The bitmap is flipped horizontally.
#define  MAP_INVERTED   ((DWORD)(1<<7))
  The bitmap is flipped vertically.
#define  MAP_USE_SCALE_COLORS   ((DWORD)(1<<10))
  Scale colors when high dynamic range values are out of gamut.
#define  MAP_PROXY   ((DWORD)(1<<11))
  When the proxy flag is set, the BitmapInfo is called a proxy info.
#define  MAP_PROXYREQUEST   ((DWORD)(1<<12))
  When the proxy request flag is set, the BitmapInfo is called a request info.
#define  MAP_LEGAL_DELETE   ((DWORD)(1<<30))
  internal use only
#define  MAP_VIEW_FILTERED   ((DWORD)(1<<31))
  Test stuff.
#define  MAP_ALL_FLAGS   0xFFFFFFFF

Detailed Description

These flag bits describe properites of the bitmap.


Define Documentation

#define MAP_NOFLAGS   ((DWORD)0)

The bitmap has none of the characteristics below.

#define MAP_READY   ((DWORD)(1<<0))

This bitmap has had memory allocated to it, or is accessible directly.

#define MAP_HAS_ALPHA   ((DWORD)(1<<1))

This flag can be checked from a BitmapInfo instance (bi.Flags()&MAP_HAS_ALPHA)), but not from a Bitmap instance (bmap->Flags() & MAP_HAS_ALPHA).

Therefore if you have a Bitmap, use the Bitmap's HasAlpha() method to see if the map has an alpha channel. The bitmap has an alpha channel.

#define MAP_ALPHA_PREMULTIPLIED   ((DWORD)(1<<2))

The bitmap has pre-multiplied alpha.

#define MAP_PALETTED   ((DWORD)(1<<3))

The bitmap uses a palette (not true color).

#define MAP_FRAME_SYSTEM_LOCKED   ((DWORD)(1<<4))

This flag is no longer used.

#define MAP_DITHERED   ((DWORD)(1<<5))

The bitmap is dithered.

#define MAP_FLIPPED   ((DWORD)(1<<6))

The bitmap is flipped horizontally.

#define MAP_INVERTED   ((DWORD)(1<<7))

The bitmap is flipped vertically.

#define MAP_USE_SCALE_COLORS   ((DWORD)(1<<10))

Scale colors when high dynamic range values are out of gamut.

#define MAP_PROXY   ((DWORD)(1<<11))

When the proxy flag is set, the BitmapInfo is called a proxy info.

The info for the proxy's original subject bitmap is called the subject info. The subject info is available from the proxy info via BitmapInfo::GetProxySubject().

See also:
BitmapInfo::GetProxySubject() Indicates a proxy bitmap, reduced from original size / bit depth
#define MAP_PROXYREQUEST   ((DWORD)(1<<12))

When the proxy request flag is set, the BitmapInfo is called a request info.

A request info should contain settings for the original bitmap, without any subject info allocated. A request info passed to BitmapManager::Load() serves as a request to load proxy version of the original bitmap. The bitmap manager converts the request info to a proxy info with the complete proxy and subject settings. Indicates a request to load proxy bitmap, reduced from original size / bit depth

#define MAP_LEGAL_DELETE   ((DWORD)(1<<30))

internal use only

#define MAP_VIEW_FILTERED   ((DWORD)(1<<31))
#define MAP_ALL_FLAGS   0xFFFFFFFF