GDI+ 两个汇总 ： 为什么CImage类别是根据GDI+的？

在很多资料上都说CImage类是基于GDI+的，可是为什么是基于GDI+的呢？

由于使用这个类时，并没有增加#include <gdiplus.h> 。也没有在程序開始和结束时分别写GDI+启动代码GdiplusStartupInput和结束代码GdiplusShutdown

使用这个类时。只须要加入头文件# include<altimage.h>就能够了，比GDI+得使用要简单一些。

而CImage 对图片的处理非常类似GDI+ 。其内部是不是封装了GDI+呢？ 幸好，CImage类 是源代码公开的，我们能够研究其源代码。以便加深理解。

首先，看看altimage.h头文件

[cpp] view
plaincopy

1. #ifndef __ATLIMAGE_H__
2. #define __ATLIMAGE_H__
3. #pragma once
4. #include <atldef.h>
5. #include <atlbase.h>
6. #include <atlstr.h>
7. #include <atlsimpcoll.h>
8. #include <atltypes.h>
9. #ifndef _ATL_NO_PRAGMA_WARNINGS
10. #pragma warning (push)
11. #pragma warning(disable : 4820) // padding added after member
12. #endif //!_ATL_NO_PRAGMA_WARNINGS
13. #pragma warning( push, 3 )
14. #pragma push_macro("new")
15. #undef new
16. #include <gdiplus.h>   // 注意这里：加入了GDI+得头文件
17. #pragma pop_macro("new")
18. #pragma warning( pop )
19. #include <shlwapi.h>
20. #ifndef _ATL_NO_DEFAULT_LIBS
21. #pragma comment(lib, "gdi32.lib")
22. #pragma comment(lib, "shlwapi.lib")
23. #pragma comment(lib, "gdiplus.lib")
24. #if WINVER >= 0x0500
25. #pragma comment(lib, "msimg32.lib")
26. #endif  // WINVER >= 0x0500
27. #endif  // !_ATL_NO_DEFAULT_LIBS
28. #pragma pack(push, _ATL_PACKING)

上面包括了GDI+得头文件

再来看CImage的定义：

[cpp] view
plaincopy

1. class CImage
2. {
3. private:
4. class CDCCache
5. {
6. public:
7. CDCCache() throw();
8. ~CDCCache() throw();
9. HDC GetDC() throw();
10. void ReleaseDC( HDC ) throw();
11. private:
12. HDC m_ahDCs[CIMAGE_DC_CACHE_SIZE];
13. };
14. class CInitGDIPlus
15. {
16. public:
17. CInitGDIPlus() throw();
18. ~CInitGDIPlus() throw();
19. bool Init() throw();
20. void ReleaseGDIPlus() throw();
21. void IncreaseCImageCount() throw();
22. void DecreaseCImageCount() throw();
23. private:
24. ULONG_PTR m_dwToken;
25. CRITICAL_SECTION m_sect;
26. LONG m_nCImageObjects;
27. };

[cpp] view
plaincopy

1. static CInitGDIPlus s_initGDIPlus;

[cpp] view
plaincopy

1. static CDCCache s_cache;

它定义了两个类成员变量： 当中CInitGDIPlus 是负责GDI+的启动和释放

我们再看一下，这个成员类的Init()方法：

[cpp] view
plaincopy

1. inline bool CImage::CInitGDIPlus::Init() throw()
2. {
3. EnterCriticalSection(&m_sect);
4. bool fRet = true;
5. if( m_dwToken == 0 )
6. {
7. Gdiplus::GdiplusStartupInput input;
8. Gdiplus::GdiplusStartupOutput output;
9. Gdiplus::Status status = Gdiplus::GdiplusStartup( &m_dwToken, &input, &output );   //启动GDI+
10. if( status != Gdiplus::Ok )
11. fRet = false;
12. }
13. LeaveCriticalSection(&m_sect);
14. return fRet;
15. }

也就是说 使用这个函数 启动GDI+

再看下一个函数：

[cpp] view
plaincopy

1. inline void CImage::CInitGDIPlus::ReleaseGDIPlus() throw()
2. {
3. EnterCriticalSection(&m_sect);
4. if( m_dwToken != 0 )
5. {
6. Gdiplus::GdiplusShutdown( m_dwToken );
7. }
8. m_dwToken = 0;
9. LeaveCriticalSection(&m_sect);
10. }

也就是说， 使用这一个函数，用来关闭GDI+

到此，我们便可知道。CImage类是基于GDI+的，可是我们还不知道CImage 对象是不是在初始化时就启动了GDI+？假设不是。那什么时候才启动GDI+呢？

为解决这个疑惑，我们查看CImage 构造函数

[cpp] view
plaincopy

1. inline CImage::CImage() throw() :
2. m_hBitmap( NULL ),
3. m_pBits( NULL ),
4. m_hDC( NULL ),
5. m_nDCRefCount( 0 ),
6. m_hOldBitmap( NULL ),
7. m_nWidth( 0 ),
8. m_nHeight( 0 ),
9. m_nPitch( 0 ),
10. m_nBPP( 0 ),
11. m_iTransparentColor( -1 ),
12. m_bHasAlphaChannel( false ),
13. m_bIsDIBSection( false )
14. {
15. s_initGDIPlus.IncreaseCImageCount();
16. }

[cpp] view
plaincopy

1. inline void CImage::CInitGDIPlus::IncreaseCImageCount() throw()
2. {
3. EnterCriticalSection(&m_sect);
4. m_nCImageObjects++;
5. LeaveCriticalSection(&m_sect);
6. }

由此可见，构造函数并没有启动GDI+

也就是说定义  CImage image;  这个image变量时。并没有启动GDI+

我们继续查找：

[cpp] view
plaincopy

1. inline bool CImage::InitGDIPlus() throw()
2. {
3. bool bSuccess = s_initGDIPlus.Init();
4. return( bSuccess );
5. }

CImage使用InitGDIPlus（） 来初始化GDI+

因此我们查找InitGDIPlus() 的全部引用 。发现下面函数：

[cpp] view
plaincopy

1. inline HRESULT CImage::GetImporterFilterString( CSimpleString& strImporters,
2. CSimpleArray< GUID >& aguidFileTypes, LPCTSTR pszAllFilesDescription /* = NULL */,
3. DWORD dwExclude /* = excludeDefaultLoad */, TCHAR chSeparator /* = '|' */ )
4. {
5. if( !InitGDIPlus() )
6. {
7. return( E_FAIL );
8. }
9. UINT nCodecs;
10. UINT nSize;
11. Gdiplus::Status status;
12. Gdiplus::ImageCodecInfo* pCodecs;
13. status = Gdiplus::GetImageDecodersSize( &nCodecs, &nSize );
14. USES_ATL_SAFE_ALLOCA;
15. pCodecs = static_cast< Gdiplus::ImageCodecInfo* >( _ATL_SAFE_ALLOCA(nSize, _ATL_SAFE_ALLOCA_DEF_THRESHOLD) );
16. if( pCodecs == NULL )
17. return E_OUTOFMEMORY;
18. status = Gdiplus::GetImageDecoders( nCodecs, nSize, pCodecs );
19. BuildCodecFilterString( pCodecs, nCodecs, strImporters, aguidFileTypes, pszAllFilesDescription, dwExclude, chSeparator );
20. return( S_OK );
21. }
22. inline HRESULT CImage::GetExporterFilterString( CSimpleString& strExporters,
23. CSimpleArray< GUID >& aguidFileTypes, LPCTSTR pszAllFilesDescription /* = NULL */,
24. DWORD dwExclude /* = excludeDefaultSave */, TCHAR chSeparator /* = '|' */ )
25. {
26. if( !InitGDIPlus() )
27. {
28. return( E_FAIL );
29. }
30. UINT nCodecs;
31. UINT nSize;
32. Gdiplus::Status status;
33. Gdiplus::ImageCodecInfo* pCodecs;
34. status = Gdiplus::GetImageDecodersSize( &nCodecs, &nSize );
35. USES_ATL_SAFE_ALLOCA;
36. pCodecs = static_cast< Gdiplus::ImageCodecInfo* >( _ATL_SAFE_ALLOCA(nSize, _ATL_SAFE_ALLOCA_DEF_THRESHOLD) );
37. if( pCodecs == NULL )
38. return E_OUTOFMEMORY;
39. status = Gdiplus::GetImageDecoders( nCodecs, nSize, pCodecs );
40. BuildCodecFilterString( pCodecs, nCodecs, strExporters, aguidFileTypes, pszAllFilesDescription, dwExclude, chSeparator );
41. return( S_OK );
42. }

[cpp] view
plaincopy

1. inline HRESULT CImage::Load( IStream* pStream ) throw()
2. {
3. if( !InitGDIPlus() )
4. {
5. return( E_FAIL );
6. }
7. Gdiplus::Bitmap bmSrc( pStream );
8. if( bmSrc.GetLastStatus() != Gdiplus::Ok )
9. {
10. return( E_FAIL );
11. }
12. return( CreateFromGdiplusBitmap( bmSrc ) );
13. }
14. inline HRESULT CImage::Load( LPCTSTR pszFileName ) throw()
15. {
16. if( !InitGDIPlus() )
17. {
18. return( E_FAIL );
19. }
20. Gdiplus::Bitmap bmSrc( (CT2W)pszFileName );
21. if( bmSrc.GetLastStatus() != Gdiplus::Ok )
22. {
23. return( E_FAIL );
24. }
25. return( CreateFromGdiplusBitmap( bmSrc ) );
26. }

[cpp] view
plaincopy

1. inline HRESULT CImage::Save( IStream* pStream, REFGUID guidFileType ) const throw()
2. {
3. if( !InitGDIPlus() )
4. {
5. return( E_FAIL );
6. }
7. UINT nEncoders;
8. UINT nBytes;
9. Gdiplus::Status status;
10. status = Gdiplus::GetImageEncodersSize( &nEncoders, &nBytes );
11. if( status != Gdiplus::Ok )
12. {
13. return( E_FAIL );
14. }
15. USES_ATL_SAFE_ALLOCA;
16. Gdiplus::ImageCodecInfo* pEncoders = static_cast< Gdiplus::ImageCodecInfo* >( _ATL_SAFE_ALLOCA(nBytes, _ATL_SAFE_ALLOCA_DEF_THRESHOLD) );
17. if( pEncoders == NULL )
18. return E_OUTOFMEMORY;
19. status = Gdiplus::GetImageEncoders( nEncoders, nBytes, pEncoders );
20. if( status != Gdiplus::Ok )
21. {
22. return( E_FAIL );
23. }
24. CLSID clsidEncoder = FindCodecForFileType( guidFileType, pEncoders, nEncoders );
25. if( clsidEncoder == CLSID_NULL )
26. {
27. return( E_FAIL );
28. }
29. if( m_bHasAlphaChannel )
30. {
31. ATLASSUME( m_nBPP == 32 );
32. Gdiplus::Bitmap bm( m_nWidth, m_nHeight, m_nPitch, PixelFormat32bppARGB, static_cast< BYTE* >( m_pBits ) );
33. status = bm.Save( pStream, &clsidEncoder, NULL );
34. if( status != Gdiplus::Ok )
35. {
36. return( E_FAIL );
37. }
38. }
39. else
40. {
41. Gdiplus::Bitmap bm( m_hBitmap, NULL );
42. status = bm.Save( pStream, &clsidEncoder, NULL );
43. if( status != Gdiplus::Ok )
44. {
45. return( E_FAIL );
46. }
47. }
48. return( S_OK );
49. }
50. inline HRESULT CImage::Save( LPCTSTR pszFileName, REFGUID guidFileType ) const throw()
51. {
52. if( !InitGDIPlus() )
53. {
54. return( E_FAIL );
55. }
56. UINT nEncoders;
57. UINT nBytes;
58. Gdiplus::Status status;
59. status = Gdiplus::GetImageEncodersSize( &nEncoders, &nBytes );
60. if( status != Gdiplus::Ok )
61. {
62. return( E_FAIL );
63. }
64. USES_CONVERSION_EX;
65. Gdiplus::ImageCodecInfo* pEncoders = static_cast< Gdiplus::ImageCodecInfo* >( _ATL_SAFE_ALLOCA(nBytes, _ATL_SAFE_ALLOCA_DEF_THRESHOLD) );
66. if( pEncoders == NULL )
67. return E_OUTOFMEMORY;
68. status = Gdiplus::GetImageEncoders( nEncoders, nBytes, pEncoders );
69. if( status != Gdiplus::Ok )
70. {
71. return( E_FAIL );
72. }
73. CLSID clsidEncoder = CLSID_NULL;
74. if( guidFileType == GUID_NULL )
75. {
76. // Determine clsid from extension
77. clsidEncoder = FindCodecForExtension( ::PathFindExtension( pszFileName ), pEncoders, nEncoders );
78. }
79. else
80. {
81. // Determine clsid from file type
82. clsidEncoder = FindCodecForFileType( guidFileType, pEncoders, nEncoders );
83. }
84. if( clsidEncoder == CLSID_NULL )
85. {
86. return( E_FAIL );
87. }
88. LPCWSTR pwszFileName = T2CW_EX( pszFileName, _ATL_SAFE_ALLOCA_DEF_THRESHOLD );
89. #ifndef _UNICODE
90. if( pwszFileName == NULL )
91. return E_OUTOFMEMORY;
92. #endif // _UNICODE
93. if( m_bHasAlphaChannel )
94. {
95. ATLASSUME( m_nBPP == 32 );
96. Gdiplus::Bitmap bm( m_nWidth, m_nHeight, m_nPitch, PixelFormat32bppARGB, static_cast< BYTE* >( m_pBits ) );
97. status = bm.Save( pwszFileName, &clsidEncoder, NULL );
98. if( status != Gdiplus::Ok )
99. {
100. return( E_FAIL );
101. }
102. }
103. else
104. {
105. Gdiplus::Bitmap bm( m_hBitmap, NULL );
106. status = bm.Save( pwszFileName, &clsidEncoder, NULL );
107. if( status != Gdiplus::Ok )
108. {
109. return( E_FAIL );
110. }
111. }
112. return( S_OK );
113. }

有上面可知： CImage对象 在第一次Load() 或第一次Save() 时 启动GDI+

以下我们看看 CImage析构时，能否将GDI+关闭掉：

[cpp] view
plaincopy

1. inline CImage::~CImage() throw()
2. {
3. Destroy();
4. s_initGDIPlus.DecreaseCImageCount();
5. }

[cpp] view
plaincopy

1. inline void CImage::CInitGDIPlus::DecreaseCImageCount() throw()
2. {
3. EnterCriticalSection(&m_sect);
4. if( --m_nCImageObjects == 0 )
5. ReleaseGDIPlus();
6. LeaveCriticalSection(&m_sect);
7. }

[cpp] view
plaincopy

1. inline void CImage::CInitGDIPlus::ReleaseGDIPlus() throw()
2. {
3. EnterCriticalSection(&m_sect);
4. if( m_dwToken != 0 )
5. {
6. Gdiplus::GdiplusShutdown( m_dwToken );
7. }
8. m_dwToken = 0;
9. LeaveCriticalSection(&m_sect);
10. }

也就是说，一个CImage对象退出时。并不直接关闭GDI+ ，而是只将GDI+使用计数减一。 当其为0时。再关闭GDI+

而这是通过类静态变量来实现计数的：

[cpp] view
plaincopy

1. static CInitGDIPlus s_initGDIPlus;

由此，我们可作例如以下总结：

当定义多个CImge 变量时， 当某个变量载入图片或保存图片时，启动GDI+。之后。 当其它变量再载入图片或保存时，添加GDI+计数变量

当全部CImage变量都析构完成时，才关闭GDI+。否则，仅仅是降低GDI+计算变量值。

所以说，CImage类是基于GDI+的。

 转会：http://blog.csdn.net/shuilan0066/article/details/7086371