GDI 总结三： CImage类使用

前言

         CImage类是基于GDI+的。可是这里为什么要讲归于GDI？

         主要是基于这种考虑： 在GDI+环境中，我们能够直接使用GDI+ ，没多少必要再使用CImage类

                                                       可是，假设再GDI环境中，我们要想使用GDI+，有点麻烦。还得增加头文件。增加启动GDI+的代码和关闭GDI+的代码，显得太罗嗦了。GDI  的CBitmap 处理功能又有局限，仅仅能处理BMP格式的图片。 怎么办？这时。我们便可使用CImage类，由于这个类本身封装了GDI+得使用环境，所以无需我们手动设置，简化了我们的操作。  同一时候。又能够利用GDI+中强大的图片处理功能，及能够简便的与CBitmap对象进行转换 ，大慷慨便了在GDI环境下。进行各种图片处理工作 。

                                                        事实上，将其称作 GDI/ GDI+ 混合编程，这样才更确切些。

        

    

 

为什么引入CImage类？

 

    CBitmap 类仅仅能处理BMP格式的图片，很受限。

    而CImage能够处理JPGE GIF BMP PNG多种格式图片，扩展了图片处理功能 且能与CBitmap 进行转换( 由于所加载的位图句柄都是HBITMAP,所以可相互转换)，因此引入CImage类进行图像处理

     CImage provides enhanced bitmap support, including the ability to load and save images in JPEG, GIF, BMP, and Portable Network Graphics (PNG) formats

 

CImage类介绍

    

     CImage是MFC和ATL共享的新类，它能从外部磁盘中调入一个JPEG、GIF、BMP和PNG格式的图像文件加以显示，并且这些文件格式能够相互转换。

     CImage是VC.NET中定义的一种MFC/ATL共享类，也是ATL的一种工具类，它提供增强型的（DDB和DIB）位图支持。能够装入、显示、转换和保存多种格式的图像文件，包含BMP、GIF、JPG、PNG、TIF等。CImage是一个独立的类。没有基类。

（CImage类是基于GDI+的，从VC.NET起引进。VC 6.0中没有。）

    

      ATL（Active Template Library，活动模板库）是一套基于模板的 C++ 类，用以简化小而快的 COM 对象的编写。

为了在MFC程序中使用CImage类，必须包括ATL的图像头文件atlimage.h：（在VS08 SP1中不用包括）

     #include <atlimage.h>

 

 

1  载入位图文件

 

   // CImage可载入的图片文件有JPG,BMP,TIF.PNG等格式  而CBitmap仅仅能载入BMP图片文件
if(!PathFileExists(imgFilePath))
    return NULL;

CImage nImage;
nImage.Load(imgFilePath);
return nImage.Detach();  //返回HBITMAP    可用CBitmap 处理 也可用CImage处理

2 与CBitmap转换

 

CImage nImage;
nImage.Load(imgFilePath);

HBITMAP hBitmap=nImage.Detach(); // 获得位图句柄 用以转换


// 转换方式一：
CBitmap bmp;
bmp.DeleteObject();
bmp.Attach(hBitmap); //  转换为CBitmap对象


// 转换方式二：

CBitmap *pBitmap=CBitmap::FromHandle(nImage.m_hBitmap);

3 获得CImage对象的cdc

 

CDC *pDC=CDC::FromHandle(nImage.GetDC());

// Use pDC here

nImage.ReleaseDC();

 

4 显示位图

   思路： 将CImage对象 绘制在相应的DC中

   所使用的函数 BitBlt   StretchBlt  Draw等

   以Draw举例：

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( );

 

Draw performs the same operation as StretchBlt, unless the image contains a transparent color or alpha channel. In that case,Draw performs the same operation as eitherTransparentBlt orAlphaBlend as required.

For versions of Draw that do not specify a source rectangle, the entire source image is the default. For the version ofDraw that does not specify a size for the destination rectangle, the size of the source image is the default and no stretching or shrinking occurs.

 

 

EXAMPLE 1：

CImage img;
img.Load("1.jpg");

if (!img.IsNull())
{
    img.Draw(pDC->m_hDC,CRect(0,0,100,100));
}

 

EXAMPLE 2： 画在还有一个位图中

 

CImage img;
img.Load(filePath);

// 获得CImage对象的 CDC
HDC hDC=img.GetDC();
CDC *pDC=CDC::FromHandle(hDC);

CBitmap bmp;// 仅仅是创建了位图对象，但还没有将位图对象与位图资源联系起来
bmp.CreateCompatibleBitmap(pDC,nWidth,nHeight); // 创建新的位图资源


CDC memDC;
memDC.CreateCompatibleDC(pDC);
CBitmap *pOld=memDC.SelectObject(&bmp);

// 将img图像绘制到bmp中

::SetStretchBltMode(memDC.m_hDC,HALFTONE);
::SetBrushOrgEx(memDC.m_hDC,0,0,NULL);
img.StretchBlt(memDC.m_hDC,CRect(0,0,nWidth,nHeight)/*DestRect*/,CRect(0,0,nWidth,nHeight)/*SourceRect*/,SRCCOPY);

HBITMAP hBitmap=(HBITMAP)memDC.SelectObject(pOld->m_hObject); // 获得新创建的位图资源句柄

img.ReleaseDC();

 

5 将位图资源与对象进行分离

 

inline HBITMAP CImage::Detach() throw()
{
    HBITMAP hBitmap;

    ATLASSUME( m_hBitmap != NULL );
    ATLASSUME( m_hDC == NULL );

    hBitmap = m_hBitmap;
    m_hBitmap = NULL;
    m_pBits = NULL;
    m_nWidth = 0;
    m_nHeight = 0;
    m_nBPP = 0;
    m_nPitch = 0;
    m_iTransparentColor = -1;
    m_bHasAlphaChannel = false;
    m_bIsDIBSection = false;

    return( hBitmap );
}

 

6 释放资源

 

CBitmap 使用DeleteObject（）来主动释放掉位图资源

CImage   没有DeleteObject()函数 。而是用Destroy（）函数来主动释放位图资源

 

inline void CImage::Destroy() throw()
{
    HBITMAP hBitmap;

    if( m_hBitmap != NULL )
    {
        hBitmap = Detach();
        ::DeleteObject( hBitmap );  //释放位图资源
    }
}

 

CBitmap 析构时，会自己主动释放掉所占用的位图资源

CImage 析构时。也会自己主动释放掉所占用的位图资源

inline CImage::~CImage() throw()
{
    Destroy(); //释放掉所占用的位图资源
    s_initGDIPlus.DecreaseCImageCount();
}

 

7 读写图像数据

 

主要用到3个函数 ：

 

1 ）GetBits() 获得数据区的指针

Retrieves a pointer to the actual bit values of a given pixel in a bitmap.

void* GetBits( ) throw( );

 

inline void* CImage::GetBits() throw()
{
    ATLASSUME( m_hBitmap != NULL );
    ATLASSERT( IsDIBSection() );

    return( m_pBits );
}

A pointer to the bitmap buffer. If the bitmap is a bottom-up DIB, the pointer points near the end of the buffer. If the bitmap is a top-down DIB, the pointer points to the first byte of the buffer.

Using this pointer, along with the value returned by GetPitch, you can locate and change individual pixels in an image.

 

 注意： 由GetBits()取得的指针不一定是图片数据的起始行。必须结合GetPitch()的值来确定起始行位置

 

2）GetPitch()

inline int CImage::GetPitch() const throw()
{
    ATLASSUME( m_hBitmap != NULL );
    ATLASSERT( IsDIBSection() );

    return( m_nPitch );
}

获得图像数据每一行的字节数

The pitch of the image. If the return value is negative, the bitmap is a bottom-up DIB and its origin is the lower left corner. If the return value is positive, the bitmap is a top-down DIB and its origin is the upper left corner.

GetBits 与 GetPitch 关系：

当GetPitch()<0时，GetBits()获得的指针指向最后一行

当GetPitch()>0时。GetBits()获得的指针指向第一行

 

图像数据首行地址：

BYTE *pData=NULL;

if(img.GetPitch()<0)

    pData=(BYTE*)img.GetBits()+(img.GetPitch()*(img.GetHeight()-1));

else
    pData=(BYTE*)img.GetBits();

或

BYTE *pData=NULL;
if(img.GetPitch()<0)

    pData=(BYTE *)img.GetPixelAddress(img.GetHeight()-1,0);

else

    pData=(BYTE *)img.GetPixelAddress(0,0);

3）GetBPP() 返回每一个像素所占的bit数

inline int CImage::GetBPP() const throw()
{
    ATLASSUME( m_hBitmap != NULL );

    return( m_nBPP );
}

 

The number of bits per pixel.

This value determines the number of bits that define each pixel and the maximum number of colors in the bitmap

 

一个综合样例：

void CMyImage::Negatives(void)
{
    int i, j;

    //图像每一行的字节数
    int nRowBytes = GetPitch();
    int nWidth = GetWidth();
    int nHeight = GetHeight();


    //每一个像素所占的字节数
    int nClrCount = GetBPP() / 8;
    LPBYTE p;
    for(int index = 0; index < nClrCount; index++)
    {
        p = (LPBYTE)GetBits();
        for(i = 0; i < nHeight; i++)
        {
            for(j = 0; j < nWidth; j++)
            {
                p[j*nClrCount + index] = 255 - p[j*nClrCount + index];
            }

            //假设nRowBytes>0  则从開始到结尾
            //假设nRowBytes<0, 则从结尾到開始
            p += nRowBytes;
        }
    }
}

 

8 保存到图像文件里

Saves an image as the specified file name and type.

 

HRESULT Save(
   IStream* pStream,
   REFGUID guidFileType
) const throw();
HRESULT Save(
   LPCTSTR pszFileName,
   REFGUID guidFileType= GUID_NULL
)

 

inline HRESULT CImage::Save( LPCTSTR pszFileName, REFGUID guidFileType ) const throw()
{
    if( !InitGDIPlus() )
    {
        return( E_FAIL );
    }

    UINT nEncoders;
    UINT nBytes;
    Gdiplus::Status status;

    status = Gdiplus::GetImageEncodersSize( &nEncoders, &nBytes );
    if( status != Gdiplus::Ok )
    {
        return( E_FAIL );
    }

    USES_CONVERSION_EX;
    Gdiplus::ImageCodecInfo* pEncoders = static_cast< Gdiplus::ImageCodecInfo* >( _ATL_SAFE_ALLOCA(nBytes, _ATL_SAFE_ALLOCA_DEF_THRESHOLD) );

    if( pEncoders == NULL )
        return E_OUTOFMEMORY;

    status = Gdiplus::GetImageEncoders( nEncoders, nBytes, pEncoders );
    if( status != Gdiplus::Ok )
    {
        return( E_FAIL );
    }

    CLSID clsidEncoder = CLSID_NULL;
    if( guidFileType == GUID_NULL )
    {
        // Determine clsid from extension
        clsidEncoder = FindCodecForExtension( ::PathFindExtension( pszFileName ), pEncoders, nEncoders );
    }
    else
    {
        // Determine clsid from file type
        clsidEncoder = FindCodecForFileType( guidFileType, pEncoders, nEncoders );
    }
    if( clsidEncoder == CLSID_NULL )
    {
        return( E_FAIL );
    }

    LPCWSTR pwszFileName = T2CW_EX( pszFileName, _ATL_SAFE_ALLOCA_DEF_THRESHOLD );
#ifndef _UNICODE
    if( pwszFileName == NULL )
        return E_OUTOFMEMORY;
#endif // _UNICODE
    if( m_bHasAlphaChannel )
    {
        ATLASSUME( m_nBPP == 32 );
        Gdiplus::Bitmap bm( m_nWidth, m_nHeight, m_nPitch, PixelFormat32bppARGB, static_cast< BYTE* >( m_pBits ) );
        status = bm.Save( pwszFileName, &clsidEncoder, NULL );
        if( status != Gdiplus::Ok )
        {
            return( E_FAIL );
        }
    }
    else
    {
        Gdiplus::Bitmap bm( m_hBitmap, NULL );
        status = bm.Save( pwszFileName, &clsidEncoder, NULL );
        if( status != Gdiplus::Ok )
        {
            return( E_FAIL );
        }
    }

    return( S_OK );
}

 

pStream

A pointer to a stream containing the file name for the image.

pszFileName

A pointer to the file name for the image.

guidFileType

The file type to save the image as. Can be one of the following:

• ImageFormatBMP   An uncompressed bitmap image.

• ImageFormatPNG   A Portable Network Graphic (PNG) compressed image.

• ImageFormatJPEG   A JPEG compressed image.

• ImageFormatGIF   A GIF compressed image.

Call this function to save the image using a specified name and type. If the guidFileType parameter is not included, the file name's file extension will be used to determine the image format. If no extension is provided, the image will be saved in BMP format.

 

MSDN样例：

  Copy Code
// Demonstrating saving various file formats
int _tmain(int argc, _TCHAR* argv[])
{
   CImage myimage;
   // load existing image
   myimage.Load("image.bmp");
      // save an image in BMP format
   myimage.Save("c:\image1.bmp");
   // save an image in BMP format
   myimage.Save("c:\image2",ImageFormatBMP);
   // save an image in JPEG format
   myimage.Save("c:\image3.jpg");
   // save an image in BMP format, even though jpg file extension is used
   myimage.Save("c:\image4.jpg",ImageFormatBMP);
   return 0;
}

 

 

 9 应用实例： 将两个图像合并为一个新的图像

 

//图像路径
CString img1Path;
CString img2Path;
CString img3Path;

img1Path=_T("1.bmp");
img2Path=_T("2.bmp");
img3Path=_T("3.bmp");  // 将 图片1、2 合并成图片3


CImage img1,img2,img3;

img1.Load(img1Path);
img2.Load(img2Path);


CBitmap bmp;
CDC memDC;
HDC hDC=NULL;
CDC *pDC=NULL;
CBitmap *pOld=NULL;
HBITMAP hBitmap=NULL;


//创建位图
hDC=img1.GetDC();
pDC=CDC::FromHandle(hDC);
bmp.DeleteObject();
bmp.CreateCompatibleBitmap(pDC,img1.GetWidth()/2,img1.GetHeight());
memDC.DeleteDC();
memDC.CreateCompatibleDC(pDC);
pOld=memDC.SelectObject(&bmp);


::SetStretchBltMode(memDC.m_hDC,HALFTONE);
::SetBrushOrgEx(memDC.m_hDC,0,0,NULL);

// 背景置白色
CRgn rectRgn;
rectRgn.CreateRectRgn(0,0,img1.GetWidth()/2,img1.GetHeight());
CBrush brush;
brush.CreateSolidBrush(RGB(255,255,255));
memDC.FillRgn(&rectRgn,&brush);


//绘图
img1.StretchBlt(memDC.m_hDC,CRect(0,0,img1.GetWidth()/2,img1.GetHeight()/2),CRect(0,0,img1.GetWidth(),img1.GetHeight()),SRCCOPY);
img2.StretchBlt(memDC.m_hDC,CRect(0,img1.GetHeight()/2,img1.GetWidth()/2,img1.GetHeight()),CRect(0,0,img2.GetWidth(),img2.GetHeight()),SRCCOPY);

hBitmap=(HBITMAP)memDC.SelectObject(pOld->m_hObject);
img3.Attach(hBitmap);// 加载位图资源
img3.Save(img3Path); // 保存新的位图

img1.ReleaseDC();
img1.Destroy();
img2.Destroy();
img3.Destroy();

转自：http://blog.csdn.net/shuilan0066/article/details/7080244