【轉載】 CImage類使用

原文： https://www.cnblogs.com/15157737693zsp/p/6015402.html

 

前言

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