#include <atlimage.h>

Collaboration diagram for ATL::CImage:

[legend]

Classes
struct	COMMON

struct	EXTENSION_ENTRY

struct	FILTER_DATA

struct	FORMAT_ENTRY

struct	MYBITMAPINFOEX

Public Types
enum	{ createAlphaChannel = 1 }

enum	DIBOrientation { DIBOR_DEFAULT, DIBOR_BOTTOMUP, DIBOR_TOPDOWN }

enum	ExcludeFlags { excludeGIF = 0x01, excludeBMP = 0x02, excludeEMF = 0x04, excludeWMF = 0x08, excludeJPEG = 0x10, excludePNG = 0x20, excludeTIFF = 0x40, excludeIcon = 0x80, excludeOther = 0x80000000, excludeDefaultLoad = 0, excludeDefaultSave = excludeIcon \| excludeEMF \| excludeWMF }

Public Member Functions
	CImage () throw ()

	~CImage ()

	operator HBITMAP ()

void	Attach (HBITMAP hBitmap, DIBOrientation eOrientation=DIBOR_DEFAULT)

HBITMAP	Detach () throw ()

HDC	GetDC () const throw ()

void	ReleaseDC () const throw ()

BOOL	AlphaBlend (HDC hDestDC, int xDest, int yDest, int nDestWidth, int nDestHeight, int xSrc, int ySrc, int nSrcWidth, int nSrcHeight, BYTE bSrcAlpha=0xFF, BYTE bBlendOp=AC_SRC_OVER) const

BOOL	AlphaBlend (HDC hDestDC, int xDest, int yDest, BYTE bSrcAlpha=0xFF, BYTE bBlendOp=AC_SRC_OVER) const

BOOL	AlphaBlend (HDC hDestDC, const POINT &pointDest, BYTE bSrcAlpha=0xFF, BYTE bBlendOp=AC_SRC_OVER) const

BOOL	AlphaBlend (HDC hDestDC, const RECT &rectDest, const RECT &rectSrc, BYTE bSrcAlpha=0xFF, BYTE bBlendOp=AC_SRC_OVER) const

BOOL	BitBlt (HDC hDestDC, int xDest, int yDest, int nDestWidth, int nDestHeight, int xSrc, int ySrc, DWORD dwROP=SRCCOPY) const throw ()

BOOL	BitBlt (HDC hDestDC, int xDest, int yDest, DWORD dwROP=SRCCOPY) const throw ()

BOOL	BitBlt (HDC hDestDC, const POINT &pointDest, DWORD dwROP=SRCCOPY) const throw ()

BOOL	BitBlt (HDC hDestDC, const RECT &rectDest, const POINT &pointSrc, DWORD dwROP=SRCCOPY) const throw ()

BOOL	Create (int nWidth, int nHeight, int nBPP, DWORD dwFlags=0) throw ()

BOOL	CreateEx (int nWidth, int nHeight, int nBPP, DWORD eCompression, const DWORD *pdwBitmasks=NULL, DWORD dwFlags=0) throw ()

void	Destroy () throw ()

BOOL	Draw (HDC hDestDC, int xDest, int yDest, int nDestWidth, int nDestHeight, int xSrc, int ySrc, int nSrcWidth, int nSrcHeight) const throw ()

BOOL	Draw (HDC hDestDC, const RECT &rectDest, const RECT &rectSrc) const throw ()

BOOL	Draw (HDC hDestDC, int xDest, int yDest) const throw ()

BOOL	Draw (HDC hDestDC, const POINT &pointDest) const throw ()

BOOL	Draw (HDC hDestDC, int xDest, int yDest, int nDestWidth, int nDestHeight) const throw ()

BOOL	Draw (HDC hDestDC, const RECT &rectDest) const throw ()

void *	GetBits () throw ()

int	GetBPP () const throw ()

void	GetColorTable (UINT iFirstColor, UINT nColors, RGBQUAD *prgbColors) const throw ()

int	GetHeight () const throw ()

int	GetMaxColorTableEntries () const throw ()

int	GetPitch () const throw ()

COLORREF	GetPixel (int x, int y) const throw ()

void *	GetPixelAddress (int x, int y) throw ()

COLORREF	GetTransparentColor () const throw ()

int	GetWidth () const throw ()

bool	IsDIBSection () const throw ()

bool	IsIndexed () const throw ()

bool	IsNull () const throw ()

HRESULT	Load (LPCTSTR pszFileName) throw ()

HRESULT	Load (IStream *pStream) throw ()

void	LoadFromResource (HINSTANCE hInstance, LPCTSTR pszResourceName) throw ()

void	LoadFromResource (HINSTANCE hInstance, UINT nIDResource) throw ()

BOOL	MaskBlt (HDC hDestDC, int xDest, int yDest, int nDestWidth, int nDestHeight, int xSrc, int ySrc, HBITMAP hbmMask, int xMask, int yMask, DWORD dwROP=SRCCOPY) const throw ()

BOOL	MaskBlt (HDC hDestDC, const RECT &rectDest, const POINT &pointSrc, HBITMAP hbmMask, const POINT &pointMask, DWORD dwROP=SRCCOPY) const throw ()

BOOL	MaskBlt (HDC hDestDC, int xDest, int yDest, HBITMAP hbmMask, DWORD dwROP=SRCCOPY) const throw ()

BOOL	MaskBlt (HDC hDestDC, const POINT &pointDest, HBITMAP hbmMask, DWORD dwROP=SRCCOPY) const throw ()

BOOL	PlgBlt (HDC hDestDC, const POINT *pPoints, int xSrc, int ySrc, int nSrcWidth, int nSrcHeight, HBITMAP hbmMask=NULL, int xMask=0, int yMask=0) const throw ()

BOOL	PlgBlt (HDC hDestDC, const POINT *pPoints, HBITMAP hbmMask=NULL) const throw ()

BOOL	PlgBlt (HDC hDestDC, const POINT *pPoints, const RECT &rectSrc, HBITMAP hbmMask, const POINT &pointMask) const throw ()

BOOL	PlgBlt (HDC hDestDC, const POINT *pPoints, const RECT &rectSrc, HBITMAP hbmMask=NULL) const throw ()

void	ReleaseGDIPlus () throw ()

HRESULT	Save (IStream pStream, GUID guidFileType) const throw ()

HRESULT	Save (LPCTSTR pszFileName, REFGUID guidFileType=GUID_NULL) const throw ()

void	SetColorTable (UINT iFirstColor, UINT nColors, const RGBQUAD *prgbColors) throw ()

void	SetPixel (int x, int y, COLORREF color) throw ()

void	SetPixelIndexed (int x, int y, int iIndex) throw ()

void	SetPixelRGB (int x, int y, BYTE r, BYTE g, BYTE b) throw ()

COLORREF	SetTransparentColor (COLORREF rgbTransparent) throw ()

BOOL	StretchBlt (HDC hDestDC, int xDest, int yDest, int nDestWidth, int nDestHeight, int xSrc, int ySrc, int nSrcWidth, int nSrcHeight, DWORD dwROP=SRCCOPY) const throw ()

BOOL	StretchBlt (HDC hDestDC, int xDest, int yDest, int nDestWidth, int nDestHeight, DWORD dwROP=SRCCOPY) const throw ()

BOOL	StretchBlt (HDC hDestDC, const RECT &rectDest, DWORD dwROP=SRCCOPY) const throw ()

BOOL	StretchBlt (HDC hDestDC, const RECT &rectDest, const RECT &rectSrc, DWORD dwROP=SRCCOPY) const throw ()

BOOL	TransparentBlt (HDC hDestDC, int xDest, int yDest, int nDestWidth, int nDestHeight, int xSrc, int ySrc, int nSrcWidth, int nSrcHeight, UINT crTransparent=CLR_INVALID) const throw ()

BOOL	TransparentBlt (HDC hDestDC, int xDest, int yDest, int nDestWidth, int nDestHeight, UINT crTransparent=CLR_INVALID) const throw ()

BOOL	TransparentBlt (HDC hDestDC, const RECT &rectDest, UINT crTransparent=CLR_INVALID) const throw ()

BOOL	TransparentBlt (HDC hDestDC, const RECT &rectDest, const RECT &rectSrc, UINT crTransparent=CLR_INVALID) const throw ()

Static Public Member Functions
static BOOL	IsTransparencySupported () throw ()

static HRESULT	GetImporterFilterString (CSimpleString &strImporters, CSimpleArray< GUID > &aguidFileTypes, LPCTSTR pszAllFilesDescription=NULL, DWORD dwExclude=excludeDefaultLoad, TCHAR chSeparator=TEXT('\|'))

static HRESULT	GetExporterFilterString (CSimpleString &strExporters, CSimpleArray< GUID > &aguidFileTypes, LPCTSTR pszAllFilesDescription=NULL, DWORD dwExclude=excludeDefaultSave, TCHAR chSeparator=TEXT('\|'))

Protected Member Functions
LPCWSTR	GetFileExtension (LPCWSTR pszFileName) const

COLORREF	RGBFromPaletteIndex (int iIndex) const

const GUID *	FileTypeFromExtension (LPCWSTR pszExt) const

bool	GetClsidFromFileType (CLSID clsid, const GUID guid) const

int	GetEncoderClsid (LPCWSTR mime, CLSID *clsid) const

bool	IsGuidEqual (const GUID &guid1, const GUID &guid2) const

void	AttachInternal (HBITMAP hBitmap, DIBOrientation eOrientation, LONG iTransColor)

BOOL	CreateInternal (int nWidth, int nHeight, int nBPP, DWORD eCompression, const DWORD *pdwBitmasks=NULL, DWORD dwFlags=0) throw ()

Static Protected Member Functions
static HRESULT	GetCommonFilterString (CSimpleString &strFilter, CSimpleArray< GUID > &aguidFileTypes, LPCTSTR pszAllFilesDescription, DWORD dwExclude, TCHAR chSeparator)

static COMMON *&	GetCommonPtr ()

static COMMON &	GetCommon ()

Protected Attributes
HBITMAP	m_hbm

HGDIOBJ	m_hbmOld

HDC	m_hDC

DIBOrientation	m_eOrientation

bool	m_bHasAlphaCh

bool	m_bIsDIBSec

COLORREF	m_rgbTransColor

union {
BITMAP m_bm

DIBSECTION m_ds

};

Private Member Functions
	CImage (const CImage &)

CImage &	operator= (const CImage &)

Detailed Description

Definition at line 32 of file atlimage.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Enumerator
createAlphaChannel

Definition at line 36 of file atlimage.h.

     {
         createAlphaChannel = 1      // enable alpha
     };

◆ DIBOrientation

enum ATL::CImage::DIBOrientation

Enumerator
DIBOR_DEFAULT
DIBOR_BOTTOMUP
DIBOR_TOPDOWN

Definition at line 42 of file atlimage.h.

     {
         DIBOR_DEFAULT,              // default
         DIBOR_BOTTOMUP,             // bottom-up DIB
         DIBOR_TOPDOWN               // top-down DIB
     };

◆ ExcludeFlags

enum ATL::CImage::ExcludeFlags

Enumerator
excludeGIF
excludeBMP
excludeEMF
excludeWMF
excludeJPEG
excludePNG
excludeTIFF
excludeIcon
excludeOther
excludeDefaultLoad
excludeDefaultSave

Definition at line 711 of file atlimage.h.

     {
         excludeGIF          = 0x01,
         excludeBMP          = 0x02,
         excludeEMF          = 0x04,
         excludeWMF          = 0x08,
         excludeJPEG         = 0x10,
         excludePNG          = 0x20,
         excludeTIFF         = 0x40,
         excludeIcon         = 0x80,
         excludeOther        = 0x80000000,
         excludeDefaultLoad  = 0,
         excludeDefaultSave  = excludeIcon | excludeEMF | excludeWMF
     };

Constructor & Destructor Documentation

◆ CImage() [1/2]

ATL::CImage::CImage	(	)
throw	(
	)

inline

Definition at line 49 of file atlimage.h.

Referenced by CreateInternal().

     {
         m_hbm = NULL;
         m_hbmOld = NULL;
         m_hDC = NULL;
 
         m_eOrientation = DIBOR_DEFAULT;
         m_bHasAlphaCh = false;
         m_bIsDIBSec = false;
         m_rgbTransColor = CLR_INVALID;
         ZeroMemory(&m_ds, sizeof(m_ds));
 
         if (GetCommon().AddRef() == 1)
         {
             GetCommon().LoadLib();
         }
     }

◆ ~CImage()

ATL::CImage::~CImage ( )

inline

Definition at line 67 of file atlimage.h.

     {
         Destroy();
         ReleaseGDIPlus();
     }

◆ CImage() [2/2]

ATL::CImage::CImage ( const CImage & )

private

Member Function Documentation

◆ AlphaBlend() [1/4]

BOOL ATL::CImage::AlphaBlend	(	HDC	hDestDC,
		int	xDest,
		int	yDest,
		int	nDestWidth,
		int	nDestHeight,
		int	xSrc,
		int	ySrc,
		int	nSrcWidth,
		int	nSrcHeight,
		BYTE	bSrcAlpha = `0xFF`,
		BYTE	bBlendOp = `AC_SRC_OVER`
	)		const

inline

Definition at line 123 of file atlimage.h.

Referenced by AlphaBlend(), and Draw().

     {
         ATLASSERT(IsTransparencySupported());
 
         BLENDFUNCTION bf;
         bf.BlendOp = bBlendOp;
         bf.BlendFlags = 0;
         bf.SourceConstantAlpha = bSrcAlpha;
         bf.AlphaFormat = AC_SRC_ALPHA;
 
         GetDC();
         BOOL ret = ::AlphaBlend(hDestDC, xDest, yDest, nDestWidth, nDestHeight,
                                 m_hDC, xSrc, ySrc, nSrcWidth, nSrcHeight, bf);
         ReleaseDC();
         return ret;
     }

◆ AlphaBlend() [2/4]

BOOL ATL::CImage::AlphaBlend	(	HDC	hDestDC,
		int	xDest,
		int	yDest,
		BYTE	bSrcAlpha = `0xFF`,
		BYTE	bBlendOp = `AC_SRC_OVER`
	)		const

inline

Definition at line 142 of file atlimage.h.

     {
         int width = GetWidth();
         int height = GetHeight();
         return AlphaBlend(hDestDC, xDest, yDest, width, height, 0, 0,
                           width, height, bSrcAlpha, bBlendOp);
     }

◆ AlphaBlend() [3/4]

BOOL ATL::CImage::AlphaBlend	(	HDC	hDestDC,
		const POINT &	pointDest,
		BYTE	bSrcAlpha = `0xFF`,
		BYTE	bBlendOp = `AC_SRC_OVER`
	)		const

inline

Definition at line 150 of file atlimage.h.

     {
         return AlphaBlend(hDestDC, pointDest.x, pointDest.y, bSrcAlpha, bBlendOp);
     }

◆ AlphaBlend() [4/4]

BOOL ATL::CImage::AlphaBlend	(	HDC	hDestDC,
		const RECT &	rectDest,
		const RECT &	rectSrc,
		BYTE	bSrcAlpha = `0xFF`,
		BYTE	bBlendOp = `AC_SRC_OVER`
	)		const

inline

Definition at line 155 of file atlimage.h.

     {
         return AlphaBlend(hDestDC, rectDest.left, rectDest.top,
                           rectDest.right - rectDest.left,
                           rectDest.bottom - rectDest.top,
                           rectSrc.left, rectSrc.top,
                           rectSrc.right - rectSrc.left,
                           rectSrc.bottom - rectSrc.top,
                           bSrcAlpha, bBlendOp);
     }

◆ Attach()

void ATL::CImage::Attach	(	HBITMAP	hBitmap,
		DIBOrientation	eOrientation = `DIBOR_DEFAULT`
	)

inline

Definition at line 79 of file atlimage.h.

Referenced by Load(), LoadFromResource(), and SaveDIBToFile().

     {
         AttachInternal(hBitmap, eOrientation, -1);
     }

◆ AttachInternal()

void ATL::CImage::AttachInternal	(	HBITMAP	hBitmap,
		DIBOrientation	eOrientation,
		LONG	iTransColor
	)

inlineprotected

Definition at line 1138 of file atlimage.h.

Referenced by Attach(), and CreateInternal().

     {
         Destroy();
 
         const int size = sizeof(DIBSECTION);
         m_bIsDIBSec = (::GetObject(hBitmap, size, &m_ds) == size);
 
         bool bOK = (::GetObject(hBitmap, sizeof(BITMAP), &m_bm) != 0);
 
         if (bOK)
         {
             m_hbm = hBitmap;
             m_eOrientation = eOrientation;
             m_bHasAlphaCh = (m_bm.bmBitsPixel == 32);
             m_rgbTransColor = CLR_INVALID;
         }
     }

◆ BitBlt() [1/4]

BOOL ATL::CImage::BitBlt	(	HDC	hDestDC,
		int	xDest,
		int	yDest,
		int	nDestWidth,
		int	nDestHeight,
		int	xSrc,
		int	ySrc,
		DWORD	dwROP = `SRCCOPY`
	)		const
throw	(
	)

inline

Definition at line 167 of file atlimage.h.

Referenced by BitBlt().

     {
         GetDC();
         BOOL ret = ::BitBlt(hDestDC, xDest, yDest, nDestWidth, nDestHeight,
                             m_hDC, xSrc, ySrc, dwROP);
         ReleaseDC();
         return ret;
     }

◆ BitBlt() [2/4]

BOOL ATL::CImage::BitBlt	(	HDC	hDestDC,
		int	xDest,
		int	yDest,
		DWORD	dwROP = `SRCCOPY`
	)		const
throw	(
	)

inline

Definition at line 177 of file atlimage.h.

     {
         return BitBlt(hDestDC, xDest, yDest,
                       GetWidth(), GetHeight(), 0, 0, dwROP);
     }

◆ BitBlt() [3/4]

BOOL ATL::CImage::BitBlt	(	HDC	hDestDC,
		const POINT &	pointDest,
		DWORD	dwROP = `SRCCOPY`
	)		const
throw	(
	)

inline

Definition at line 183 of file atlimage.h.

     {
         return BitBlt(hDestDC, pointDest.x, pointDest.y, dwROP);
     }

◆ BitBlt() [4/4]

BOOL ATL::CImage::BitBlt	(	HDC	hDestDC,
		const RECT &	rectDest,
		const POINT &	pointSrc,
		DWORD	dwROP = `SRCCOPY`
	)		const
throw	(
	)

inline

Definition at line 188 of file atlimage.h.

     {
         return BitBlt(hDestDC, rectDest.left, rectDest.top,
                       rectDest.right - rectDest.left,
                       rectDest.bottom - rectDest.top,
                       pointSrc.x, pointSrc.y, dwROP);
     }

◆ Create()

BOOL ATL::CImage::Create	(	int	nWidth,
		int	nHeight,
		int	nBPP,
		DWORD	dwFlags = `0`
	)
throw	(
	)

inline

Definition at line 197 of file atlimage.h.

     {
         return CreateEx(nWidth, nHeight, nBPP, BI_RGB, NULL, dwFlags);
     }

◆ CreateEx()

BOOL ATL::CImage::CreateEx	(	int	nWidth,
		int	nHeight,
		int	nBPP,
		DWORD	eCompression,
		const DWORD *	pdwBitmasks = `NULL`,
		DWORD	dwFlags = `0`
	)
throw	(
	)

inline

Definition at line 202 of file atlimage.h.

Referenced by Create().

     {
         return CreateInternal(nWidth, nHeight, nBPP, eCompression, pdwBitmasks, dwFlags);
     }

◆ CreateInternal()

BOOL ATL::CImage::CreateInternal	(	int	nWidth,
		int	nHeight,
		int	nBPP,
		DWORD	eCompression,
		const DWORD *	pdwBitmasks = `NULL`,
		DWORD	dwFlags = `0`
	)
throw	(
	)

inlineprotected

Definition at line 1157 of file atlimage.h.

Referenced by CreateEx().

     {
         ATLASSERT(nWidth != 0);
         ATLASSERT(nHeight != 0);
 
         // initialize BITMAPINFO extension
         MYBITMAPINFOEX bi;
         ZeroMemory(&bi, sizeof(bi));
         bi.bmiHeader.biSize = sizeof(BITMAPINFOHEADER);
         bi.bmiHeader.biWidth = nWidth;
         bi.bmiHeader.biHeight = nHeight;
         bi.bmiHeader.biPlanes = 1;
         bi.bmiHeader.biBitCount = nBPP;
         bi.bmiHeader.biCompression = eCompression;
 
         // is there alpha channel?
         bool bHasAlphaCh;
         bHasAlphaCh = (nBPP == 32 && (dwFlags & createAlphaChannel));
 
         // get orientation
         DIBOrientation eOrientation;
         eOrientation = ((nHeight > 0) ? DIBOR_BOTTOMUP : DIBOR_TOPDOWN);
 
         // does it have bit fields?
         if (eCompression == BI_BITFIELDS)
         {
             if (nBPP == 16 || nBPP == 32)
             {
                 // store the mask data
                 LPDWORD pdwMask = reinterpret_cast<LPDWORD>(bi.bmiColors);
                 pdwMask[0] = pdwBitmasks[0];
                 pdwMask[1] = pdwBitmasks[1];
                 pdwMask[2] = pdwBitmasks[2];
             }
             else
             {
                 return FALSE;
             }
         }
         else
         {
             ATLASSERT(pdwBitmasks == NULL);
             if (pdwBitmasks)
                 return FALSE;
         }
 
         // create a DIB section
         HDC hDC = ::CreateCompatibleDC(NULL);
         ATLASSERT(hDC);
         LPVOID pvBits;
         HBITMAP hbm = ::CreateDIBSection(hDC, bi.get(), DIB_RGB_COLORS,
                                          &pvBits, NULL, 0);
         ATLASSERT(hbm);
         ::DeleteDC(hDC);
 
         // attach it
         AttachInternal(hbm, eOrientation, -1);
         m_bHasAlphaCh = bHasAlphaCh;
 
         return hbm != NULL;
     }

◆ Destroy()

void ATL::CImage::Destroy	(	)
throw	(
	)

inline

Definition at line 208 of file atlimage.h.

Referenced by AttachInternal(), START_TEST(), and ~CImage().

     {
         if (m_hbm)
         {
             ::DeleteObject(Detach());
         }
     }

◆ Detach()

HBITMAP ATL::CImage::Detach	(	)
throw	(
	)

inline

Definition at line 84 of file atlimage.h.

Referenced by Destroy(), and SaveDIBToFile().

     {
         m_eOrientation = DIBOR_DEFAULT;
         m_bHasAlphaCh = false;
         m_rgbTransColor = CLR_INVALID;
         ZeroMemory(&m_ds, sizeof(m_ds));
 
         HBITMAP hBitmap = m_hbm;
         m_hbm = NULL;
         return hBitmap;
     }

◆ Draw() [1/6]

BOOL ATL::CImage::Draw	(	HDC	hDestDC,
		int	xDest,
		int	yDest,
		int	nDestWidth,
		int	nDestHeight,
		int	xSrc,
		int	ySrc,
		int	nSrcWidth,
		int	nSrcHeight
	)		const
throw	(
	)

inline

Definition at line 216 of file atlimage.h.

Referenced by Draw(), and START_TEST().

     {
         ATLASSERT(IsTransparencySupported());
         if (m_bHasAlphaCh)
         {
             return AlphaBlend(hDestDC, xDest, yDest, nDestWidth, nDestHeight,
                               xSrc, ySrc, nSrcWidth, nSrcHeight);
         }
         else if (m_rgbTransColor != CLR_INVALID)
         {
             COLORREF rgb;
             if ((m_rgbTransColor & 0xFF000000) == 0x01000000)
                 rgb = RGBFromPaletteIndex(m_rgbTransColor & 0xFF);
             else
                 rgb = m_rgbTransColor;
             return TransparentBlt(hDestDC, xDest, yDest, nDestWidth, nDestHeight,
                                   xSrc, ySrc, nSrcWidth, nSrcHeight, rgb);
         }
         else
         {
             return StretchBlt(hDestDC, xDest, yDest, nDestWidth, nDestHeight,
                               xSrc, ySrc, nSrcWidth, nSrcHeight);
         }
     }

◆ Draw() [2/6]

BOOL ATL::CImage::Draw	(	HDC	hDestDC,
		const RECT &	rectDest,
		const RECT &	rectSrc
	)		const
throw	(
	)

inline

Definition at line 241 of file atlimage.h.

     {
         return Draw(hDestDC, rectDest.left, rectDest.top,
                     rectDest.right - rectDest.left,
                     rectDest.bottom - rectDest.top,
                     rectSrc.left, rectSrc.top,
                     rectSrc.right - rectSrc.left,
                     rectSrc.bottom - rectSrc.top);
     }

◆ Draw() [3/6]

BOOL ATL::CImage::Draw	(	HDC	hDestDC,
		int	xDest,
		int	yDest
	)		const
throw	(
	)

inline

Definition at line 250 of file atlimage.h.

     {
         return Draw(hDestDC, xDest, yDest, GetWidth(), GetHeight());
     }

◆ Draw() [4/6]

BOOL ATL::CImage::Draw	(	HDC	hDestDC,
		const POINT &	pointDest
	)		const
throw	(
	)

inline

Definition at line 254 of file atlimage.h.

     {
         return Draw(hDestDC, pointDest.x, pointDest.y);
     }

◆ Draw() [5/6]

BOOL ATL::CImage::Draw	(	HDC	hDestDC,
		int	xDest,
		int	yDest,
		int	nDestWidth,
		int	nDestHeight
	)		const
throw	(
	)

inline

Definition at line 258 of file atlimage.h.

     {
         return Draw(hDestDC, xDest, yDest, nDestWidth, nDestHeight,
                     0, 0, GetWidth(), GetHeight());
     }

◆ Draw() [6/6]

BOOL ATL::CImage::Draw	(	HDC	hDestDC,
		const RECT &	rectDest
	)		const
throw	(
	)

inline

Definition at line 264 of file atlimage.h.

     {
         return Draw(hDestDC, rectDest.left, rectDest.top,
                     rectDest.right - rectDest.left,
                     rectDest.bottom - rectDest.top);
     }

◆ FileTypeFromExtension()

const GUID* ATL::CImage::FileTypeFromExtension ( LPCWSTR pszExt ) const

inlineprotected

Definition at line 1040 of file atlimage.h.

Referenced by Save().

     {
         static const EXTENSION_ENTRY table[] =
         {
             {L".jpg", Gdiplus::ImageFormatJPEG},
             {L".png", Gdiplus::ImageFormatPNG},
             {L".bmp", Gdiplus::ImageFormatBMP},
             {L".gif", Gdiplus::ImageFormatGIF},
             {L".tif", Gdiplus::ImageFormatTIFF},
             {L".jpeg", Gdiplus::ImageFormatJPEG},
             {L".jpe", Gdiplus::ImageFormatJPEG},
             {L".jfif", Gdiplus::ImageFormatJPEG},
             {L".dib", Gdiplus::ImageFormatBMP},
             {L".rle", Gdiplus::ImageFormatBMP},
             {L".tiff", Gdiplus::ImageFormatTIFF}
         };
         const size_t count = _countof(table);
         for (size_t i = 0; i < count; ++i)
         {
             if (::lstrcmpiW(table[i].pszExt, pszExt) == 0)
                 return &table[i].guid;
         }
         return NULL;
     }

◆ GetBits()

void* ATL::CImage::GetBits	(	)
throw	(
	)

inline

Definition at line 271 of file atlimage.h.

Referenced by GetPixelAddress().

     {
         ATLASSERT(IsDIBSection());
         BYTE *pb = (BYTE *)m_bm.bmBits;
         if (m_eOrientation == DIBOR_BOTTOMUP)
         {
             pb += m_bm.bmWidthBytes * (m_bm.bmHeight - 1);
         }
         return pb;
     }

◆ GetBPP()

int ATL::CImage::GetBPP	(	)	const
throw	(
	)

inline

Definition at line 282 of file atlimage.h.

Referenced by GetPixelAddress(), IsIndexed(), and START_TEST().

     {
         ATLASSERT(m_hbm);
         return m_bm.bmBitsPixel;
     }

◆ GetClsidFromFileType()

bool ATL::CImage::GetClsidFromFileType	(	CLSID *	clsid,
		const GUID *	guid
	)		const

inlineprotected

Definition at line 1071 of file atlimage.h.

Referenced by Save().

     {
         static const FORMAT_ENTRY table[] =
         {
             {Gdiplus::ImageFormatJPEG, L"image/jpeg"},
             {Gdiplus::ImageFormatPNG, L"image/png"},
             {Gdiplus::ImageFormatBMP, L"image/bmp"},
             {Gdiplus::ImageFormatGIF, L"image/gif"},
             {Gdiplus::ImageFormatTIFF, L"image/tiff"}
         };
         const size_t count = _countof(table);
         for (size_t i = 0; i < count; ++i)
         {
             if (IsGuidEqual(table[i].guid, *guid))
             {
                 int num = GetEncoderClsid(table[i].mime, clsid);
                 if (num >= 0)
                 {
                     return true;
                 }
             }
         }
         return false;
     }

◆ GetColorTable()

void ATL::CImage::GetColorTable	(	UINT	iFirstColor,
		UINT	nColors,
		RGBQUAD *	prgbColors
	)		const
throw	(
	)

inline

Definition at line 288 of file atlimage.h.

Referenced by RGBFromPaletteIndex().

     {
         ATLASSERT(IsDIBSection());
         GetDC();
         ::GetDIBColorTable(m_hDC, iFirstColor, nColors, prgbColors);
         ReleaseDC();
     }

◆ GetCommon()

static COMMON& ATL::CImage::GetCommon ( )

inlinestaticprotected

Definition at line 995 of file atlimage.h.

Referenced by CImage(), GetEncoderClsid(), Load(), and Save().

     {
         COMMON*& pCommon = GetCommonPtr();
         if (pCommon == NULL)
             pCommon = new COMMON;
         return *pCommon;
     }

◆ GetCommonFilterString()

static HRESULT ATL::CImage::GetCommonFilterString	(	CSimpleString &	strFilter,
		CSimpleArray< GUID > &	aguidFileTypes,
		LPCTSTR	pszAllFilesDescription,
		DWORD	dwExclude,
		TCHAR	chSeparator
	)

inlinestaticprotected

Definition at line 734 of file atlimage.h.

Referenced by GetExporterFilterString(), and GetImporterFilterString().

     {
         static const FILTER_DATA table[] =
         {
             {excludeBMP, TEXT("BMP"), TEXT("*.BMP;*.DIB;*.RLE"), &Gdiplus::ImageFormatBMP},
             {excludeJPEG, TEXT("JPEG"), TEXT("*.JPG;*.JPEG;*.JPE;*.JFIF"), &Gdiplus::ImageFormatJPEG},
             {excludeGIF, TEXT("GIF"), TEXT("*.GIF"), &Gdiplus::ImageFormatGIF},
             {excludeEMF, TEXT("EMF"), TEXT("*.EMF"), &Gdiplus::ImageFormatEMF},
             {excludeWMF, TEXT("WMF"), TEXT("*.WMF"), &Gdiplus::ImageFormatWMF},
             {excludeTIFF, TEXT("TIFF"), TEXT("*.TIF;*.TIFF"), &Gdiplus::ImageFormatTIFF},
             {excludePNG, TEXT("PNG"), TEXT("*.PNG"), &Gdiplus::ImageFormatPNG},
             {excludeIcon, TEXT("ICO"), TEXT("*.ICO"), &Gdiplus::ImageFormatIcon}
         };
 
         if (pszAllFilesDescription)
         {
             strFilter += pszAllFilesDescription;
             strFilter += chSeparator;
 
             BOOL bFirst = TRUE;
             for (size_t i = 0; i < _countof(table); ++i)
             {
                 if ((dwExclude & table[i].dwExclude) != 0)
                     continue;
 
                 if (bFirst)
                     bFirst = FALSE;
                 else
                     strFilter += TEXT(';');
 
                 strFilter += table[i].extensions;
             }
             strFilter += chSeparator;
 
             aguidFileTypes.Add(GUID_NULL);
         }
 
         for (size_t i = 0; i < _countof(table); ++i)
         {
             if ((dwExclude & table[i].dwExclude) != 0)
                 continue;
             strFilter += table[i].title;
             strFilter += TEXT(" (");
             strFilter += table[i].extensions;
             strFilter += TEXT(")");
             strFilter += chSeparator;
             strFilter += table[i].extensions;
             strFilter += chSeparator;
 
             aguidFileTypes.Add(*table[i].guid);
         }
 
         strFilter += chSeparator;
 
         return S_OK;
     }

◆ GetCommonPtr()

static COMMON*& ATL::CImage::GetCommonPtr ( )

inlinestaticprotected

Definition at line 989 of file atlimage.h.

Referenced by GetCommon(), and ReleaseGDIPlus().

     {
         static COMMON *s_pCommon = NULL;
         return s_pCommon;
     }

◆ GetDC()

HDC ATL::CImage::GetDC	(	)	const
throw	(
	)

inline

Definition at line 96 of file atlimage.h.

Referenced by AlphaBlend(), BitBlt(), GetColorTable(), GetPixel(), MaskBlt(), PlgBlt(), SetColorTable(), SetPixel(), SetPixelIndexed(), START_TEST(), StretchBlt(), and TransparentBlt().

     {
         if (m_hDC)
             return m_hDC;
 
         m_hDC = ::CreateCompatibleDC(NULL);
         m_hbmOld = ::SelectObject(m_hDC, m_hbm);
         return m_hDC;
     }

◆ GetEncoderClsid()

int ATL::CImage::GetEncoderClsid	(	LPCWSTR	mime,
		CLSID *	clsid
	)		const

inlineprotected

Definition at line 1096 of file atlimage.h.

Referenced by GetClsidFromFileType().

     {
         UINT count = 0, total_size = 0;
         GetCommon().GetImageEncodersSize(&count, &total_size);
         if (total_size == 0)
             return -1;  // failure
 
         Gdiplus::ImageCodecInfo *pInfo;
         BYTE *pb = new BYTE[total_size];
         ATLASSERT(pb);
         pInfo = reinterpret_cast<Gdiplus::ImageCodecInfo *>(pb);
         if (pInfo == NULL)
             return -1;  // failure
 
         GetCommon().GetImageEncoders(count, total_size, pInfo);
 
         for (UINT iInfo = 0; iInfo < count; ++iInfo)
         {
             if (::lstrcmpiW(pInfo[iInfo].MimeType, mime) == 0)
             {
                 *clsid = pInfo[iInfo].Clsid;
                 delete[] pb;
                 return iInfo;  // success
             }
         }
 
         delete[] pb;
         return -1;  // failure
     }

◆ GetExporterFilterString()

static HRESULT ATL::CImage::GetExporterFilterString	(	CSimpleString &	strExporters,
		CSimpleArray< GUID > &	aguidFileTypes,
		LPCTSTR	pszAllFilesDescription = `NULL`,
		DWORD	dwExclude = `excludeDefaultSave`,
		TCHAR	chSeparator = `TEXT('\|')`
	)

inlinestatic

Definition at line 811 of file atlimage.h.

     {
         return GetCommonFilterString(strExporters,
                                      aguidFileTypes,
                                      pszAllFilesDescription,
                                      dwExclude,
                                      chSeparator);
     }

◆ GetFileExtension()

LPCWSTR ATL::CImage::GetFileExtension ( LPCWSTR pszFileName ) const

inlineprotected

Definition at line 1017 of file atlimage.h.

Referenced by Save().

     {
         LPCWSTR pch = wcsrchr(pszFileName, L'\\');
         if (pch == NULL)
             pch = wcsrchr(pszFileName, L'/');
         pch = (pch ? wcsrchr(pch, L'.') : wcsrchr(pszFileName, L'.'));
         return (pch ? pch : (pszFileName + ::lstrlenW(pszFileName)));
     }

◆ GetHeight()

int ATL::CImage::GetHeight	(	)	const
throw	(
	)

inline

Definition at line 297 of file atlimage.h.

Referenced by AlphaBlend(), BitBlt(), Draw(), MaskBlt(), PlgBlt(), START_TEST(), StretchBlt(), and TransparentBlt().

     {
         ATLASSERT(m_hbm);
         return m_bm.bmHeight;
     }

◆ GetImporterFilterString()

static HRESULT ATL::CImage::GetImporterFilterString	(	CSimpleString &	strImporters,
		CSimpleArray< GUID > &	aguidFileTypes,
		LPCTSTR	pszAllFilesDescription = `NULL`,
		DWORD	dwExclude = `excludeDefaultLoad`,
		TCHAR	chSeparator = `TEXT('\|')`
	)

inlinestatic

Definition at line 797 of file atlimage.h.

     {
         return GetCommonFilterString(strImporters,
                                      aguidFileTypes,
                                      pszAllFilesDescription,
                                      dwExclude,
                                      chSeparator);
     }

◆ GetMaxColorTableEntries()

int ATL::CImage::GetMaxColorTableEntries	(	)	const
throw	(
	)

inline

Definition at line 303 of file atlimage.h.

     {
         ATLASSERT(IsDIBSection());
         if (m_ds.dsBmih.biClrUsed && m_ds.dsBmih.biBitCount < 16)
             return m_ds.dsBmih.biClrUsed;
         switch (m_bm.bmBitsPixel)
         {
             case 1:     return 2;
             case 4:     return 16;
             case 8:     return 256;
             case 16: case 32:
                 if (m_ds.dsBmih.biCompression == BI_BITFIELDS)
                     return 3;
                 return 0;
             case 24:
             default:
                 return 0;
         }
     }

◆ GetPitch()

int ATL::CImage::GetPitch	(	)	const
throw	(
	)

inline

Definition at line 323 of file atlimage.h.

Referenced by GetPixelAddress().

     {
         ATLASSERT(IsDIBSection());
         if (m_eOrientation == DIBOR_BOTTOMUP)
             return -m_bm.bmWidthBytes;
         else
             return m_bm.bmWidthBytes;
     }

◆ GetPixel()

COLORREF ATL::CImage::GetPixel	(	int	x,
		int	y
	)		const
throw	(
	)

inline

Definition at line 332 of file atlimage.h.

Referenced by START_TEST().

     {
         GetDC();
         COLORREF ret = ::GetPixel(m_hDC, x, y);
         ReleaseDC();
         return ret;
     }

◆ GetPixelAddress()

void* ATL::CImage::GetPixelAddress	(	int	x,
		int	y
	)
throw	(
	)

inline

Definition at line 340 of file atlimage.h.

     {
         ATLASSERT(IsDIBSection());
         BYTE *pb = (BYTE *)GetBits();
         pb += GetPitch() * y;
         pb += (GetBPP() * x) / 8;
         return pb;
     }

◆ GetTransparentColor()

COLORREF ATL::CImage::GetTransparentColor	(	)	const
throw	(
	)

inline

Definition at line 349 of file atlimage.h.

     {
         return m_rgbTransColor;
     }

◆ GetWidth()

int ATL::CImage::GetWidth	(	)	const
throw	(
	)

inline

Definition at line 354 of file atlimage.h.

Referenced by AlphaBlend(), BitBlt(), Draw(), MaskBlt(), PlgBlt(), START_TEST(), StretchBlt(), and TransparentBlt().

     {
         ATLASSERT(m_hbm);
         return m_bm.bmWidth;
     }

◆ IsDIBSection()

bool ATL::CImage::IsDIBSection	(	)	const
throw	(
	)

inline

Definition at line 360 of file atlimage.h.

Referenced by GetBits(), GetColorTable(), GetMaxColorTableEntries(), GetPitch(), GetPixelAddress(), IsIndexed(), and SetColorTable().

     {
         ATLASSERT(m_hbm);
         return m_bIsDIBSec;
     }

◆ IsGuidEqual()

bool ATL::CImage::IsGuidEqual	(	const GUID &	guid1,
		const GUID &	guid2
	)		const

inlineprotected

Definition at line 1126 of file atlimage.h.

Referenced by GetClsidFromFileType(), and Save().

     {
         RPC_STATUS status;
         if (::UuidEqual(const_cast<GUID *>(&guid1),
                         const_cast<GUID *>(&guid2), &status))
         {
             if (status == RPC_S_OK)
                 return true;
         }
         return false;
     }

◆ IsIndexed()

bool ATL::CImage::IsIndexed	(	)	const
throw	(
	)

inline

Definition at line 366 of file atlimage.h.

Referenced by SetPixelIndexed().

     {
         ATLASSERT(IsDIBSection());
         return GetBPP() <= 8;
     }

◆ IsNull()

bool ATL::CImage::IsNull	(	)	const
throw	(
	)

inline

Definition at line 372 of file atlimage.h.

Referenced by START_TEST().

     {
         return m_hbm == NULL;
     }

◆ IsTransparencySupported()

static BOOL ATL::CImage::IsTransparencySupported	(	)
throw	(
	)

inlinestatic

Definition at line 706 of file atlimage.h.

Referenced by AlphaBlend(), Draw(), MaskBlt(), PlgBlt(), and TransparentBlt().

     {
         return TRUE;
     }

◆ Load() [1/2]

HRESULT ATL::CImage::Load	(	LPCTSTR	pszFileName	)
throw	(
	)

inline

Definition at line 377 of file atlimage.h.

Referenced by START_TEST().

     {
         // convert the file name string into Unicode
         // TODO: use a string class
 #ifdef UNICODE
         LPCWSTR pszNameW = pszFileName;
 #else
         WCHAR szPath[MAX_PATH];
         ::MultiByteToWideChar(CP_ACP, 0, pszFileName, -1, szPath, MAX_PATH);
         LPCWSTR pszNameW = szPath;
 #endif
 
         // create a GpBitmap object from file
         using namespace Gdiplus;
         GpBitmap *pBitmap = NULL;
         GetCommon().CreateBitmapFromFile(pszNameW, &pBitmap);
         ATLASSERT(pBitmap);
 
         // TODO & FIXME: get parameters (m_rgbTransColor etc.)
 
         // get bitmap handle
         HBITMAP hbm = NULL;
         Color color(0xFF, 0xFF, 0xFF);
         Gdiplus::Status status;
         status = GetCommon().CreateHBITMAPFromBitmap(
             pBitmap, &hbm, color.GetValue());
 
         // delete GpBitmap
         GetCommon().DisposeImage(pBitmap);
 
         // attach it
         if (status == Ok)
             Attach(hbm);
         return (status == Ok ? S_OK : E_FAIL);
     }

◆ Load() [2/2]

HRESULT ATL::CImage::Load	(	IStream *	pStream	)
throw	(
	)

inline

Definition at line 412 of file atlimage.h.

     {
         // create GpBitmap from stream
         using namespace Gdiplus;
         GpBitmap *pBitmap = NULL;
         GetCommon().CreateBitmapFromStream(pStream, &pBitmap);
         ATLASSERT(pBitmap);
 
         // TODO & FIXME: get parameters (m_rgbTransColor etc.)
 
         // get bitmap handle
         HBITMAP hbm = NULL;
         Color color(0xFF, 0xFF, 0xFF);
         Gdiplus::Status status;
         status = GetCommon().CreateHBITMAPFromBitmap(
             pBitmap, &hbm, color.GetValue());
 
         // delete Bitmap
         GetCommon().DisposeImage(pBitmap);
 
         // attach it
         if (status == Ok)
             Attach(hbm);
         return (status == Ok ? S_OK : E_FAIL);
     }

◆ LoadFromResource() [1/2]

void ATL::CImage::LoadFromResource	(	HINSTANCE	hInstance,
		LPCTSTR	pszResourceName
	)
throw	(
	)

inline

Definition at line 439 of file atlimage.h.

Referenced by LoadFromResource(), and START_TEST().

     {
         HANDLE hHandle = ::LoadImage(hInstance, pszResourceName,
                                      IMAGE_BITMAP, 0, 0, LR_CREATEDIBSECTION);
         Attach(reinterpret_cast<HBITMAP>(hHandle));
     }

◆ LoadFromResource() [2/2]

void ATL::CImage::LoadFromResource	(	HINSTANCE	hInstance,
		UINT	nIDResource
	)
throw	(
	)

inline

Definition at line 445 of file atlimage.h.

     {
         LoadFromResource(hInstance, MAKEINTRESOURCE(nIDResource));
     }

◆ MaskBlt() [1/4]

BOOL ATL::CImage::MaskBlt	(	HDC	hDestDC,
		int	xDest,
		int	yDest,
		int	nDestWidth,
		int	nDestHeight,
		int	xSrc,
		int	ySrc,
		HBITMAP	hbmMask,
		int	xMask,
		int	yMask,
		DWORD	dwROP = `SRCCOPY`
	)		const
throw	(
	)

inline

Definition at line 450 of file atlimage.h.

Referenced by MaskBlt().

     {
         ATLASSERT(IsTransparencySupported());
         GetDC();
         BOOL ret = ::MaskBlt(hDestDC, xDest, yDest, nDestWidth, nDestHeight,
                              m_hDC, xSrc, ySrc,
                              hbmMask, xMask, yMask, dwROP);
         ReleaseDC();
         return ret;
     }

◆ MaskBlt() [2/4]

BOOL ATL::CImage::MaskBlt	(	HDC	hDestDC,
		const RECT &	rectDest,
		const POINT &	pointSrc,
		HBITMAP	hbmMask,
		const POINT &	pointMask,
		DWORD	dwROP = `SRCCOPY`
	)		const
throw	(
	)

inline

Definition at line 463 of file atlimage.h.

     {
         return MaskBlt(hDestDC, rectDest.left, rectDest.top,
             rectDest.right - rectDest.left, rectDest.bottom - rectDest.top,
             pointSrc.x, pointSrc.y, hbmMask, pointMask.x, pointMask.y, dwROP);
     }

◆ MaskBlt() [3/4]

BOOL ATL::CImage::MaskBlt	(	HDC	hDestDC,
		int	xDest,
		int	yDest,
		HBITMAP	hbmMask,
		DWORD	dwROP = `SRCCOPY`
	)		const
throw	(
	)

inline

Definition at line 471 of file atlimage.h.

     {
         return MaskBlt(hDestDC, xDest, yDest, GetWidth(), GetHeight(),
                        0, 0, hbmMask, 0, 0, dwROP);
     }

◆ MaskBlt() [4/4]

BOOL ATL::CImage::MaskBlt	(	HDC	hDestDC,
		const POINT &	pointDest,
		HBITMAP	hbmMask,
		DWORD	dwROP = `SRCCOPY`
	)		const
throw	(
	)

inline

Definition at line 477 of file atlimage.h.

     {
         return MaskBlt(hDestDC, pointDest.x, pointDest.y, hbmMask, dwROP);
     }

◆ operator HBITMAP()

ATL::CImage::operator HBITMAP ( )

inline

Definition at line 73 of file atlimage.h.

     {
         return m_hbm;
     }

◆ operator=()

CImage& ATL::CImage::operator= ( const CImage & )

private

Referenced by CreateInternal().

◆ PlgBlt() [1/4]

BOOL ATL::CImage::PlgBlt	(	HDC	hDestDC,
		const POINT *	pPoints,
		int	xSrc,
		int	ySrc,
		int	nSrcWidth,
		int	nSrcHeight,
		HBITMAP	hbmMask = `NULL`,
		int	xMask = `0`,
		int	yMask = `0`
	)		const
throw	(
	)

inline

Definition at line 483 of file atlimage.h.

Referenced by PlgBlt().

     {
         ATLASSERT(IsTransparencySupported());
         GetDC();
         BOOL ret = ::PlgBlt(hDestDC, pPoints, m_hDC,
                             xSrc, ySrc, nSrcWidth, nSrcHeight,
                             hbmMask, xMask, yMask);
         ReleaseDC();
         return ret;
     }

◆ PlgBlt() [2/4]

BOOL ATL::CImage::PlgBlt	(	HDC	hDestDC,
		const POINT *	pPoints,
		HBITMAP	hbmMask = `NULL`
	)		const
throw	(
	)

inline

Definition at line 496 of file atlimage.h.

     {
         return PlgBlt(hDestDC, pPoints, 0, 0, GetWidth(), GetHeight(),
                       hbmMask);
     }

◆ PlgBlt() [3/4]

BOOL ATL::CImage::PlgBlt	(	HDC	hDestDC,
		const POINT *	pPoints,
		const RECT &	rectSrc,
		HBITMAP	hbmMask,
		const POINT &	pointMask
	)		const
throw	(
	)

inline

Definition at line 502 of file atlimage.h.

     {
         return PlgBlt(hDestDC, pPoints, rectSrc.left, rectSrc.top,
             rectSrc.right - rectSrc.left, rectSrc.bottom - rectSrc.top,
             hbmMask, pointMask.x, pointMask.y);
     }

◆ PlgBlt() [4/4]

BOOL ATL::CImage::PlgBlt	(	HDC	hDestDC,
		const POINT *	pPoints,
		const RECT &	rectSrc,
		HBITMAP	hbmMask = `NULL`
	)		const
throw	(
	)

inline

Definition at line 509 of file atlimage.h.

     {
         POINT pointMask = {0, 0};
         return PlgBlt(hDestDC, pPoints, rectSrc, hbmMask, pointMask);
     }

◆ ReleaseDC()

void ATL::CImage::ReleaseDC	(	)	const
throw	(
	)

inline

Definition at line 106 of file atlimage.h.

Referenced by AlphaBlend(), BitBlt(), GetColorTable(), GetPixel(), MaskBlt(), PlgBlt(), SetColorTable(), SetPixel(), SetPixelIndexed(), START_TEST(), StretchBlt(), and TransparentBlt().

     {
         ATLASSERT(m_hDC);
 
         if (m_hDC == NULL)
             return;
 
         if (m_hbmOld)
         {
             ::SelectObject(m_hDC, m_hbmOld);
             m_hbmOld = NULL;
         }
         ::DeleteDC(m_hDC);
         m_hDC = NULL;
     }

◆ ReleaseGDIPlus()

void ATL::CImage::ReleaseGDIPlus	(	)
throw	(
	)

inline

Definition at line 516 of file atlimage.h.

Referenced by ~CImage().

     {
         COMMON*& pCommon = GetCommonPtr();
         if (pCommon && pCommon->Release() == 0)
         {
             delete pCommon;
             pCommon = NULL;
         }
     }

◆ RGBFromPaletteIndex()

COLORREF ATL::CImage::RGBFromPaletteIndex ( int iIndex ) const

inlineprotected

Definition at line 1026 of file atlimage.h.

Referenced by Draw().

     {
         RGBQUAD table[256];
         GetColorTable(0, 256, table);
         RGBQUAD& quad =  table[iIndex];
         return RGB(quad.rgbRed, quad.rgbGreen, quad.rgbBlue);
     }

◆ Save() [1/2]

HRESULT ATL::CImage::Save	(	IStream *	pStream,
		GUID *	guidFileType
	)		const
throw	(
	)

inline

Definition at line 526 of file atlimage.h.

Referenced by SaveDIBToFile(), and START_TEST().

     {
         using namespace Gdiplus;
         ATLASSERT(m_hbm);
 
         // TODO & FIXME: set parameters (m_rgbTransColor etc.)
         CLSID clsid;
         if (!GetClsidFromFileType(&clsid, guidFileType))
             return E_FAIL;
 
         // create a GpBitmap from HBITMAP
         GpBitmap *pBitmap = NULL;
         GetCommon().CreateBitmapFromHBITMAP(m_hbm, NULL, &pBitmap);
 
         // save to stream
         Status status;
         status = GetCommon().SaveImageToStream(pBitmap, pStream, &clsid, NULL);
 
         // destroy GpBitmap
         GetCommon().DisposeImage(pBitmap);
 
         return (status == Ok ? S_OK : E_FAIL);
     }

◆ Save() [2/2]

HRESULT ATL::CImage::Save	(	LPCTSTR	pszFileName,
		REFGUID	guidFileType = `GUID_NULL`
	)		const
throw	(
	)

inline

Definition at line 549 of file atlimage.h.

     {
         using namespace Gdiplus;
         ATLASSERT(m_hbm);
 
         // TODO & FIXME: set parameters (m_rgbTransColor etc.)
 
         // convert the file name string into Unicode
         // TODO: use a string class
 #ifdef UNICODE
         LPCWSTR pszNameW = pszFileName;
 #else
         WCHAR szPath[MAX_PATH];
         ::MultiByteToWideChar(CP_ACP, 0, pszFileName, -1, szPath, MAX_PATH);
         LPCWSTR pszNameW = szPath;
 #endif
 
         // if the file type is null, get the file type from extension
         const GUID *FileType = &guidFileType;
         if (IsGuidEqual(guidFileType, GUID_NULL))
         {
             LPCWSTR pszExt = GetFileExtension(pszNameW);
             FileType = FileTypeFromExtension(pszExt);
         }
 
         // get CLSID from file type
         CLSID clsid;
         if (!GetClsidFromFileType(&clsid, FileType))
             return E_FAIL;
 
         // create a GpBitmap from HBITMAP
         GpBitmap *pBitmap = NULL;
         GetCommon().CreateBitmapFromHBITMAP(m_hbm, NULL, &pBitmap);
 
         // save to file
         Status status;
         status = GetCommon().SaveImageToFile(pBitmap, pszNameW, &clsid, NULL);
 
         // destroy GpBitmap
         GetCommon().DisposeImage(pBitmap);
 
         return (status == Ok ? S_OK : E_FAIL);
     }

◆ SetColorTable()

void ATL::CImage::SetColorTable	(	UINT	iFirstColor,
		UINT	nColors,
		const RGBQUAD *	prgbColors
	)
throw	(
	)

inline

Definition at line 594 of file atlimage.h.

     {
         ATLASSERT(IsDIBSection());
         GetDC();
         ::SetDIBColorTable(m_hDC, iFirstColor, nColors, prgbColors);
         ReleaseDC();
     }

◆ SetPixel()

void ATL::CImage::SetPixel	(	int	x,
		int	y,
		COLORREF	color
	)
throw	(
	)

inline

Definition at line 603 of file atlimage.h.

Referenced by SetPixelRGB().

     {
         GetDC();
         ::SetPixelV(m_hDC, x, y, color);
         ReleaseDC();
     }

◆ SetPixelIndexed()

void ATL::CImage::SetPixelIndexed	(	int	x,
		int	y,
		int	iIndex
	)
throw	(
	)

inline

Definition at line 610 of file atlimage.h.

     {
         ATLASSERT(IsIndexed());
         GetDC();
         ::SetPixelV(m_hDC, x, y, PALETTEINDEX(iIndex));
         ReleaseDC();
     }

◆ SetPixelRGB()

void ATL::CImage::SetPixelRGB	(	int	x,
		int	y,
		BYTE	r,
		BYTE	g,
		BYTE	b
	)
throw	(
	)

inline

Definition at line 618 of file atlimage.h.

     {
         SetPixel(x, y, RGB(r, g, b));
     }

◆ SetTransparentColor()

COLORREF ATL::CImage::SetTransparentColor	(	COLORREF	rgbTransparent	)
throw	(
	)

inline

Definition at line 623 of file atlimage.h.

Referenced by START_TEST().

     {
         ATLASSERT(m_hbm);
         COLORREF rgbOldColor = m_rgbTransColor;
         m_rgbTransColor = rgbTransparent;
         return rgbOldColor;
     }

◆ StretchBlt() [1/4]

BOOL ATL::CImage::StretchBlt	(	HDC	hDestDC,
		int	xDest,
		int	yDest,
		int	nDestWidth,
		int	nDestHeight,
		int	xSrc,
		int	ySrc,
		int	nSrcWidth,
		int	nSrcHeight,
		DWORD	dwROP = `SRCCOPY`
	)		const
throw	(
	)

inline

Definition at line 631 of file atlimage.h.

Referenced by Draw(), and StretchBlt().

     {
         GetDC();
         BOOL ret = ::StretchBlt(hDestDC, xDest, yDest, nDestWidth, nDestHeight,
                                 m_hDC, xSrc, ySrc, nSrcWidth, nSrcHeight, dwROP);
         ReleaseDC();
         return ret;
     }

◆ StretchBlt() [2/4]

BOOL ATL::CImage::StretchBlt	(	HDC	hDestDC,
		int	xDest,
		int	yDest,
		int	nDestWidth,
		int	nDestHeight,
		DWORD	dwROP = `SRCCOPY`
	)		const
throw	(
	)

inline

Definition at line 642 of file atlimage.h.

     {
         return StretchBlt(hDestDC, xDest, yDest, nDestWidth, nDestHeight,
                           0, 0, GetWidth(), GetHeight(), dwROP);
     }

◆ StretchBlt() [3/4]

BOOL ATL::CImage::StretchBlt	(	HDC	hDestDC,
		const RECT &	rectDest,
		DWORD	dwROP = `SRCCOPY`
	)		const
throw	(
	)

inline

Definition at line 649 of file atlimage.h.

     {
         return StretchBlt(hDestDC, rectDest.left, rectDest.top,
                           rectDest.right - rectDest.left,
                           rectDest.bottom - rectDest.top, dwROP);
     }

◆ StretchBlt() [4/4]

BOOL ATL::CImage::StretchBlt	(	HDC	hDestDC,
		const RECT &	rectDest,
		const RECT &	rectSrc,
		DWORD	dwROP = `SRCCOPY`
	)		const
throw	(
	)

inline

Definition at line 656 of file atlimage.h.

     {
         return StretchBlt(hDestDC, rectDest.left, rectDest.top,
                           rectDest.right - rectDest.left,
                           rectDest.bottom - rectDest.top,
                           rectSrc.left, rectSrc.top,
                           rectSrc.right - rectSrc.left,
                           rectSrc.bottom - rectSrc.top, dwROP);
     }

◆ TransparentBlt() [1/4]

BOOL ATL::CImage::TransparentBlt	(	HDC	hDestDC,
		int	xDest,
		int	yDest,
		int	nDestWidth,
		int	nDestHeight,
		int	xSrc,
		int	ySrc,
		int	nSrcWidth,
		int	nSrcHeight,
		UINT	crTransparent = `CLR_INVALID`
	)		const
throw	(
	)

inline

Definition at line 667 of file atlimage.h.

Referenced by Draw(), and TransparentBlt().

     {
         ATLASSERT(IsTransparencySupported());
         GetDC();
         BOOL ret = ::TransparentBlt(hDestDC, xDest, yDest,
                                     nDestWidth, nDestHeight,
                                     m_hDC, xSrc, ySrc,
                                     nSrcWidth, nSrcHeight, crTransparent);
         ReleaseDC();
         return ret;
     }

◆ TransparentBlt() [2/4]

BOOL ATL::CImage::TransparentBlt	(	HDC	hDestDC,
		int	xDest,
		int	yDest,
		int	nDestWidth,
		int	nDestHeight,
		UINT	crTransparent = `CLR_INVALID`
	)		const
throw	(
	)

inline

Definition at line 681 of file atlimage.h.

     {
         return TransparentBlt(hDestDC, xDest, yDest, nDestWidth, nDestHeight,
                               0, 0, GetWidth(), GetHeight(), crTransparent);
     }

◆ TransparentBlt() [3/4]

BOOL ATL::CImage::TransparentBlt	(	HDC	hDestDC,
		const RECT &	rectDest,
		UINT	crTransparent = `CLR_INVALID`
	)		const
throw	(
	)

inline

Definition at line 688 of file atlimage.h.

     {
         return TransparentBlt(hDestDC, rectDest.left, rectDest.top,
                               rectDest.right - rectDest.left,
                               rectDest.bottom - rectDest.top, crTransparent);
     }

◆ TransparentBlt() [4/4]

BOOL ATL::CImage::TransparentBlt	(	HDC	hDestDC,
		const RECT &	rectDest,
		const RECT &	rectSrc,
		UINT	crTransparent = `CLR_INVALID`
	)		const
throw	(
	)

inline

Definition at line 695 of file atlimage.h.

     {
         return TransparentBlt(hDestDC, rectDest.left, rectDest.top,
             rectDest.right - rectDest.left, rectDest.bottom - rectDest.left,
             rectSrc.left, rectSrc.top, rectSrc.right - rectSrc.left,
             rectSrc.bottom - rectSrc.top, crTransparent);
     }

Member Data Documentation

◆ @3885

union { ... }

◆ m_bHasAlphaCh

bool ATL::CImage::m_bHasAlphaCh

protected

Definition at line 1008 of file atlimage.h.

Referenced by CImage(), Detach(), and Draw().

◆ m_bIsDIBSec

bool ATL::CImage::m_bIsDIBSec

protected

Definition at line 1009 of file atlimage.h.

Referenced by CImage(), and IsDIBSection().

◆ m_bm

BITMAP ATL::CImage::m_bm

Definition at line 1013 of file atlimage.h.

Referenced by AttachInternal(), GetBits(), GetBPP(), GetHeight(), GetMaxColorTableEntries(), GetPitch(), and GetWidth().

◆ m_ds

DIBSECTION ATL::CImage::m_ds

Definition at line 1014 of file atlimage.h.

Referenced by AttachInternal(), CImage(), Detach(), and GetMaxColorTableEntries().

◆ m_eOrientation

DIBOrientation ATL::CImage::m_eOrientation

protected

Definition at line 1007 of file atlimage.h.

Referenced by CImage(), Detach(), GetBits(), and GetPitch().

◆ m_hbm

HBITMAP ATL::CImage::m_hbm

protected

Definition at line 1004 of file atlimage.h.

Referenced by CImage(), Destroy(), Detach(), GetBPP(), GetDC(), GetHeight(), GetWidth(), IsDIBSection(), IsNull(), operator HBITMAP(), Save(), and SetTransparentColor().

◆ m_hbmOld

HGDIOBJ ATL::CImage::m_hbmOld

mutableprotected

Definition at line 1005 of file atlimage.h.

Referenced by CImage(), GetDC(), and ReleaseDC().

◆ m_hDC

HDC ATL::CImage::m_hDC

mutableprotected

Definition at line 1006 of file atlimage.h.

Referenced by AlphaBlend(), BitBlt(), CImage(), GetColorTable(), GetDC(), GetPixel(), MaskBlt(), PlgBlt(), ReleaseDC(), SetColorTable(), SetPixel(), SetPixelIndexed(), StretchBlt(), and TransparentBlt().

◆ m_rgbTransColor

COLORREF ATL::CImage::m_rgbTransColor

protected

Definition at line 1010 of file atlimage.h.

Referenced by CImage(), Detach(), Draw(), GetTransparentColor(), and SetTransparentColor().

The documentation for this class was generated from the following file:

sdk/lib/atl/atlimage.h

Classes

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Private Member Functions

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

◆ DIBOrientation

◆ ExcludeFlags

Constructor & Destructor Documentation

◆ CImage() [1/2]

◆ ~CImage()

◆ CImage() [2/2]

Member Function Documentation

◆ AlphaBlend() [1/4]

◆ AlphaBlend() [2/4]

◆ AlphaBlend() [3/4]

◆ AlphaBlend() [4/4]

◆ Attach()

◆ AttachInternal()

◆ BitBlt() [1/4]

◆ BitBlt() [2/4]

◆ BitBlt() [3/4]

◆ BitBlt() [4/4]

◆ Create()

◆ CreateEx()

◆ CreateInternal()

◆ Destroy()

◆ Detach()

◆ Draw() [1/6]

◆ Draw() [2/6]

◆ Draw() [3/6]

◆ Draw() [4/6]

◆ Draw() [5/6]

◆ Draw() [6/6]

◆ FileTypeFromExtension()

◆ GetBits()

◆ GetBPP()

◆ GetClsidFromFileType()

◆ GetColorTable()

◆ GetCommon()

◆ GetCommonFilterString()

◆ GetCommonPtr()

◆ GetDC()

◆ GetEncoderClsid()

◆ GetExporterFilterString()

◆ GetFileExtension()

◆ GetHeight()

◆ GetImporterFilterString()

◆ GetMaxColorTableEntries()

◆ GetPitch()

◆ GetPixel()

◆ GetPixelAddress()

◆ GetTransparentColor()

◆ GetWidth()

◆ IsDIBSection()

◆ IsGuidEqual()

◆ IsIndexed()

◆ IsNull()

◆ IsTransparencySupported()

◆ Load() [1/2]

◆ Load() [2/2]

◆ LoadFromResource() [1/2]

◆ LoadFromResource() [2/2]

◆ MaskBlt() [1/4]

◆ MaskBlt() [2/4]

◆ MaskBlt() [3/4]

◆ MaskBlt() [4/4]

◆ operator HBITMAP()

◆ operator=()

◆ PlgBlt() [1/4]

◆ PlgBlt() [2/4]

◆ PlgBlt() [3/4]

◆ PlgBlt() [4/4]

◆ ReleaseDC()

◆ ReleaseGDIPlus()