Click here to Skip to main content
Click here to Skip to main content

ImageStone - A Powerful C++ Class Library for Image Manipulation

, 6 Dec 2011
Rate this:
Please Sign up or sign in to vote.
An article on a library for image manipulation

Introduction

ImageStone is a powerful C++ class library for image manipulation. Its features include load, save, display, transformation, and nearly 100 special image effects. It can be used cross platform (includes Windows, Linux, Mac), and especially under Windows, it can be used as a DIB wrapper class.

How to Use

Similar to STL and Boost library, ImageStone is a header-only C++ library, it consists entirely of header files, so you can begin to use it just add #include "ImageStone.h" at the beginning of your source code, But in order to take full advantage of operating system features, there are some differences between various platforms.

On Windows

Only need to add #include "ImageStone.h" in your project, normally to be added at the end of StdAfx.h file.

ImageStone uses raw Win32 GDI+ API to implement image load/save function, so it has high efficiency and small final file size.

On Non-Windows (Unix, Linux, Mac...)

ImageStone uses FreeImage lib to implement image load/save function.

  1. Get FreeImage from http://sourceforge.net/projects/freeimage/, then compile it.
  2. Include FreeImage header before include ImageStone.
    #include "FreeImage.h"
    #include "ImageStone.h"
  3. Now you can use ImageStone.

Advanced Image Effect

In order to reduce compile time, a lot of rarely-used image effects (emboss, twist, ripple...) are not to be included by default, you can use them by the following way:

#define IMAGESTONE_USE_EXT_EFFECT
#include "ImageStone.h"

... Load Image from File, Memory or Resource, Save Image to File

FCObjImage   img ;

// from file
img.Load (L"test.jpg") ;

// from memory
img.Load (pMemory, nSize, IMG_JPG) ;

// from resource under windows
img.LoadBitmap (ID_BITMAP) ;
img.LoadResource (ID_JPG_FILE, _T("JPG"), IMG_JPG) ;

// save as jpg with quality 90 ( max is 100 )
img.Save (L"test.jpg", 90) ;

In order to better support for multiple languages, ImageStone only supports wide char filename, so you need to call a conversion function for ANSI filename.

std::wstring A_to_W (const char* p)
{
    std::wstring   ws ;
    if (p)
    {
        setlocale (LC_CTYPE, "") ;

        std::vector<wchar_t>  buf (strlen(p)+1, 0) ;
        mbstowcs (&buf[0], p, buf.size()-1) ;
        ws = &buf[0] ;
    }
    return ws ;
}

FCObjImage   img ;
img.Load (A_to_W("test.jpg").c_str()) ;

// under windows, you can use _bstr_t to implement conversion
img.Load (_bstr_t("test.jpg")) ;

... Load multi-page GIF

std::vector<FCObjImage*>   frame_list ;
FCImageProperty   prop ;
FCObjImage::Load (L"test.gif", frame_list, &prop) ;

// now frame_list store all frames of Gif image
// member m_frame_delay of prop store delay time between two frame
prop.m_frame_delay ;

// caller must delete all frames when them no longer be used
for (size_t i=0 ; i < frame_list.size() ; i++)
{
    delete frame_list[i] ;
}

... Apply Image Effect

FCObjImage   img ;
img.Load (L"test.jpg") ;

img.Stretch (200, 200) ;
img.Stretch_Smooth (500, 500) ;

FCEffectBlur_Gauss   c1 (16, true) ;
img.ApplyEffect (c1) ;

FCEffectSplash   c2 (20) ;
img.ApplyEffect (c2) ;

FCEffectMosaic   c3 (20) ;
img.ApplyEffect (c3) ;

FCEffectBrightnessContrast   c4 (30, 0) ;
img.ApplyEffect (c4) ;

You can monitor the progress of image processing by setting an observer:

// this monitor will stop image processing when user press ESC key
class CMyProgressMonitor : public FCProgressObserver
{
public:
    virtual bool OnProgressUpdate (int nFinishPercentage)
    {
        MSG   msg ;
        if (PeekMessage (&msg, NULL, WM_KEYDOWN, WM_KEYDOWN, PM_REMOVE) &&
			(msg.wParam == VK_ESCAPE))
        {
            return false ;
        }
        return true ;
    }
};

// apply effect with progress monitor
FCObjImage   img ;
img.Load (L"test.jpg") ;

CMyProgressMonitor   aProgress ;

FCEffectMosaic   c1 (20) ;
img.ApplyEffect (c1, &aProgress) ;

... Custom Image Effect

// create our effect : split RGB channel of image
class CEffectSplitChannel : public FCImageEffect
{
public:
    FCObjImage   m_red, m_green, m_blue ;

private:
    virtual bool IsSupport (const FCObjImage& img)
    {
        return img.IsValidImage() && (img.ColorBits() >= 24) ;
    }

    virtual void OnBeforeProcess (FCObjImage& img)
    {
        int   w = img.Width() ;
        int   h = img.Height() ;
        m_red.Create (w, h, 24) ;
        m_green.Create (w, h, 24) ;
        m_blue.Create (w, h, 24) ;
    }

    virtual void ProcessPixel (FCObjImage& img, int x, int y, BYTE* pPixel)
    {
        PCL_R(m_red.GetBits(x,y)) = PCL_R(pPixel) ;
        PCL_G(m_green.GetBits(x,y)) = PCL_G(pPixel) ;
        PCL_B(m_blue.GetBits(x,y)) = PCL_B(pPixel) ;
    }
};

// test, save RGB channel to image
void Test()
{
    FCObjImage   img ;
    img.Load (L"test.jpg") ;

    CEffectSplitChannel   cmd ;
    img.ApplyEffect (cmd) ;

    cmd.m_red.Save (L"red.jpg") ;
    cmd.m_green.Save (L"green.jpg") ;
    cmd.m_blue.Save (L"blue.jpg") ;
}

... Read and Modify EXIF (Win Only)

FCObjImage   img ;
FCImageProperty   prop ;

img.Load (L"d:\\test.jpg", &prop) ;

// modify manufacturer of the equipment
prop.m_EquipMake = "PhoXo" ;

// modify the date of photograph
prop.m_ExifDTOrig = "2011:11:26 09:26:00" ;

std::vector<std::string>   & ls = prop.m_other_gdiplus_prop ;
for (size_t i=0 ; i < ls.size() ; i++)
{
    Gdiplus::PropertyItem   it = FCImageCodec_Gdiplus::ReferencePropertyBuffer (ls[i]) ;

    // modify ISO speed to 400
    if (it.id == PropertyTagExifISOSpeed)
    {
        short   nISO = 400 ;
        ls[i] = FCImageCodec_Gdiplus::CreatePropertyBuffer(it.id, it.type, 2, &nISO) ;
    }
}

// save image file with modified EXIF
img.Save (L"d:\\test.jpg", prop) ;

... Draw Image (Win Only)

FCObjImage   img ;
img.Load (L"c:\\test.png") ;

// for 32bpp image, method Draw use Win32 API AlphaBlend to draw,
// so we need pre-multiply alpha before draw
// for <= 24bpp image, method Draw use Win32 API BitBlt to draw
if (img.ColorBits() == 32)
{
    img.ApplyEffect (FCEffectPremultipleAlpha()) ;
}

// Draw whole image (no stretch) on point(0,0) of hdc
img.Draw (hdc, 0, 0) ;

// Draw whole image on specified region of hdc.
RECT   rcOnDC = {100, 100, 200, 200} ;
img.Draw (hdc, rcOnDC) ;

// Draw region of image on specified region of hdc.
RECT   rcOnImage = {20, 20, 50, 50} ;
img.Draw (hdc, rcOnDC, &rcOnImage) ;

// Draw whole image in window.
SIZE   img_size = {img.Width(), img.Height()} ;
RECT   rcWindow = {0, 0, 500, 500} ;
RECT   rc = FCObjImage::CalcFitWindowSize(img_size, rcWindow) ;
img.Draw (hdc, rc) ;

Although BitBlt is faster than AlphaBlend, it will destroy the alpha channel of destination. Some features such as: layered window, DWM need alpha channel, so these cases we have to convert image to 32bpp, using AlphaBlend to draw.

... Convert between HBITMAP and Gdiplus::Bitmap (Win Only)

FCObjImage   img ;

// FCObjImage can be converted to HBITMAP automatically, and can be selected into HDC
SelectObject (hdc, img) ;

// create image based on HBITMAP
img.FromHBITMAP (hBitmap) ;

// create Gdiplus::Bitmap, caller must delete returned bitmap
Gdiplus::Bitmap   * pBmp = img.CreateBitmap() ;
if (pBmp)
    delete pBmp ;

// create image based on Gdiplus::Bitmap
Gdiplus::Bitmap   gpBmp (L"c:\\test.jpg") ;
img.FromBitmap (gpBmp) ;

... Add Text on Image (Win Only)

void DrawText (HDC dc)
{
    // GDI draw text
    SetTextColor (dc, RGB(0,0,255)) ;
    TextOut (dc, 0, 0, _T("PhoXo"), 5) ;

    // GDI+ draw text
    Gdiplus::Graphics   g(dc) ;
    g.SetSmoothingMode (Gdiplus::SmoothingModeAntiAlias) ;
    g.SetInterpolationMode (Gdiplus::InterpolationModeHighQualityBicubic) ;

    Gdiplus::FontFamily   ffami (L"Arial") ;
    Gdiplus::StringFormat fmt ;

    Gdiplus::GraphicsPath   str_path ;
    str_path.AddString (L"PhoXo", -1, &ffami,
	Gdiplus::FontStyleBold, 48, Gdiplus::Point(20,20), &fmt) ;

    Gdiplus::Pen   gp (Gdiplus::Color(0,0,160), 8) ;
    gp.SetLineJoin (Gdiplus::LineJoinRound) ;

    Gdiplus::Rect    rc (20, 20, 30, 60) ;
    Gdiplus::Color   cStart (255,255,255) ;
    Gdiplus::Color   cEnd (0,128,255) ;
    Gdiplus::LinearGradientBrush  gb (rc, cStart, cEnd,
	Gdiplus::LinearGradientModeVertical) ;

    g.DrawPath (&gp, &str_path) ;
    g.FillPath (&gb, &str_path) ;
}

void Test()
{
    FCObjImage   img ;
    img.Create (300, 200, 24) ;

    // fill back grid
    img.ApplyEffect (FCEffectFillGrid(FCColor(192,192,192), FCColor(255,255,255), 16)) ;

    DrawText (FCImageDrawDC(img)) ;

    img.Save (L"d:\\test.png") ;
}

... Using in DLL (Win Only)

In most cases, there is no difference on using between in DLL and in client:

extern "C" __declspec(dllexport) HBITMAP LoadFileToDDB (LPCWSTR sFilename)
{
    FCObjImage   img ;
    img.Load (sFilename) ;

    HDC      screen_dc = GetDC(NULL) ;
    HBITMAP  hBmp = CreateCompatibleBitmap(screen_dc, img.Width(), img.Height()) ;
    ReleaseDC (NULL, screen_dc) ;

    img.Draw (FCImageDrawDC(hBmp), 0, 0) ;
    return hBmp ;
}

But, if you want to call Load or Save method of FCObjImage in DllMain or constructor of global object in DLL, you need use FCAutoInitGDIPlus to init GDI+ module in your clients before load DLL, and disable auto GDI+ init of ImageStone in DLL.

// call Load in global object.
class CGlobalObj
{
public:
    CGlobalObj()
    {
        FCImageCodec_Gdiplus::AUTO_INIT_GDIPLUS() = FALSE ;

        FCObjImage   img ;
        img.Load (L"c:\\test.jpg") ;
    }
};

CGlobalObj   g_obj ;

// call Load in DllMain.
BOOL APIENTRY DllMain (HMODULE hModule, DWORD, LPVOID)
{
    FCImageCodec_Gdiplus::AUTO_INIT_GDIPLUS() = FALSE ;

    FCObjImage   img ;
    img.Load (L"c:\\test.jpg") ;

    return TRUE ;
}

... Miscellaneous Function (Win Only)

FCObjImage   img ;

// capture current screen
HDC   screen_dc = GetDC(NULL) ;
RECT  rc = {0, 0, GetSystemMetrics(SM_CXSCREEN), GetSystemMetrics(SM_CYSCREEN)} ;
img.CaptureDC (screen_dc, rc) ;
ReleaseDC (NULL, screen_dc) ;

// copy this image to clipboard
img.CopyToClipboard() ;

// get image in clipboard
img.GetClipboard() ;

// convert image to HRGN
img.ApplyEffect (FCEffectThreshold(128)) ;
::SetWindowRgn (hWnd, img.CreateHRGN(), TRUE) ;

History

  • 2011 - 11 - 27, V7.0
    + Code Refactoring, more features, more efficient, more easier to use
  • 2007 - 03 - 11, V4.0
    + Add FCPixelFillGradientFrame
    + Add FCPixelLensFlare / FCPixelTileReflection / FCPixelSoftGlow effect
    * Modify example
    * Improve FCObjImage::AlphaBlend
    * Modify FCPixelBlinds
    * Modify brightness/contrast/hue/saturation/emboss
    * Rewrite gauss blur processor
    - Remove FCPixelDeinterlace
    - Remove FCPixelAddRandomNoise
    - Remove FCPixelFill3DSolidFrame
    - Remove FCImageHandleFactory_IJL15 and FCImageHandle_IPicture
  • 2006 - 10 - 25, V3.0
    * Improve FCImageHandle_Gdiplus class to load multi-frame gif/tiff image and load jpeg's EXIF information
    * Improve FCImageHandle_FreeImage class to save gif with transparency color
    * Change FCPixelHueSaturation's hue arithmetic
    * Change FCPixelColorTone's arithmetic, more look like old photo
    * Change inner FCImageHandleBase interface, it's never mind for user
    * Substitute std::fstream by ANSI C file function, because of a bug in VC2005
    + Add FCImageProperty to store image's property, function FCObjImage::Load and FCObjImage::Save support it
    + Add example 010: Load jpeg's EXIF information via GDI+
    - Remove FCObjImage::GetNextFrameDelay and FCObjImage::SetNextFrameDelay, you can get them from FCImageProperty
  • 2006 - 09 - 07, V2.0
    + More mature
  • 2006 - 03 - 11, V1.0
    + Initial version

License

This article, along with any associated source code and files, is licensed under The zlib/libpng License

Share

About the Author

crazybit
Team Leader PhoXo
China China
graduate from University of Science and Technology of China at 2002.
 
Now I work at www.phoxo.com.

Comments and Discussions

 
GeneralNice one PinmemberMoeen Naqvi25-May-14 23:50 
GeneralSimply great Pinmemberv_krishan30-Jul-13 8:01 
GeneralMy vote of 4 PinmemberMable John18-Mar-13 23:30 
QuestionHow can I increase speed of redraw image, when I using scrolling? Pinmemberhdnn6-Dec-12 2:27 
How can I increase speed of redraw image, when I using scrolling on big images?
In demo project for drawing you using next code:
 for (int y=rc.top ; y < rc.bottom ; y++)
    {
        int   sy = yt[y] ;
        for (int x=rc.left ; x < rc.right ; x++)
        {
            int   sx = xt[x] ;
 
            if (imgLayer.IsInside (sx,sy))
            {
                RGBQUAD   cr = *(RGBQUAD*)imgLayer.GetBits (sx,sy) ;
                FCColor::AlphaBlendPixel (view_img.GetBits(x,y), cr) ;
            }
        }
    }
How to replace this to use BitBlt?
If I use BitBlt in OnDraw, then I can't draw with zoom scale(scale always be "1").
QuestionCan't draw text! PinmemberStefanoA1-Aug-12 3:05 
AnswerRe: Can't draw text! Pinmembercrazybit1-Aug-12 23:37 
AnswerRe: Can't draw text! PinmemberStefanoA1-Aug-12 23:54 
GeneralRe: Can't draw text! Pinmembercrazybit2-Aug-12 0:13 
GeneralRe: Can't draw text! PinmemberStefanoA2-Aug-12 1:27 
GeneralRe: Can't draw text! Pinmembercrazybit2-Aug-12 21:46 
QuestionProblem Pinmemberadri910222-Jun-12 3:14 
QuestionNeed help to understand the logic. Pinmembermbatra3123-May-12 3:51 
AnswerRe: Need help to understand the logic. Pinmembercrazybit23-May-12 15:17 
QuestionGood job! PinmemberAamer Alduais11-May-12 20:30 
GeneralMy vote of 5 PinmemberAamer Alduais11-May-12 20:29 
QuestionHow can i add imagestone effects to my application with out using the load funtion of FCObjImage class. Pinmembersunny chouhan9-May-12 4:29 
AnswerRe: How can i add imagestone effects to my application with out using the load funtion of FCObjImage class. Pinmembercrazybit13-May-12 21:38 
QuestionPrint functionality Pinmemberjasondemont19-Mar-12 11:14 
QuestionRegion or ROI (region of interest) Pinmemberboisselazon19-Mar-12 3:15 
QuestionRelation between GDI+ Image Class and FCObjImage Pinmemberboisselazon15-Mar-12 4:08 
AnswerRe: Relation between GDI+ Image Class and FCObjImage Pinmembercrazybit18-Mar-12 20:05 
GeneralRe: Relation between GDI+ Image Class and FCObjImage Pinmemberboisselazon19-Mar-12 3:02 
GeneralRe: Relation between GDI+ Image Class and FCObjImage Pinmembercrazybit20-Mar-12 20:52 
GeneralMy vote of 5 PingrouplyricC28-Dec-11 22:06 
GeneralMy vote of 5 PinmemberMukit, Ataul13-Dec-11 0:11 
QuestionNice attempt PinmemberShakti Misra6-Dec-11 17:13 
GeneralMy vote of 4 PinmemberShakti Misra6-Dec-11 17:12 
GeneralMy vote of 5 PinmemberSergio Andrés Gutiérrez Rojas5-Dec-11 12:05 
GeneralMy vote of 5 Pinmemberddwang1025-Aug-11 0:36 
GeneralUNICODE support Pinmembertimepalette14-Nov-10 15:11 
GeneralRe: UNICODE support Pinmembercrazybit5-Dec-11 21:42 
QuestionText question PinmemberRWB19-Mar-10 12:47 
Questionhelp Pinmember92MUGHAL19-Feb-10 6:53 
GeneralIt's a good Pinmemberfuturejo14-Feb-10 18:50 
QuestionWhere's the source to FreeImage library? PinmentorHans Dietrich19-Jan-10 9:31 
GeneralIt`s powerful! Pinmemberyxleon17-Jan-10 16:24 
Generalvs2005 link error Pinmemberdxlee10-Dec-09 6:09 
GeneralImage &gt;= 32MB PinmemberSala8115-Oct-09 1:06 
GeneralRe: Image &gt;= 32MB PinmemberKarstenK9-Dec-09 22:06 
Generalerror C2146 in compiling example 08 in VS2005 Pinmemberdrhani33312-Aug-09 23:45 
GeneralRe: error C2146 in compiling example 08 in VS2005 Pinmemberdrhani33313-Aug-09 21:48 
QuestionDoes include/add such feature? Pinmemberwise.bear2-Aug-09 21:36 
QuestionFeatures? Pinmemberandwan07-Jun-09 7:16 
AnswerRe: Features? Pinmembercrazybit21-Jun-09 17:57 
GeneralRe: Features? Pinmemberandwan01-Jul-09 4:11 
GeneralconvertToTrueColor [modified] Pinmemberomega024-Jan-09 5:54 
QuestionCopy image byte during process Pinmemberelroulianito23-Nov-08 23:49 
QuestionMingw-GCC not compatible PinmemberAli Imran Khan Shirani20-Nov-08 20:56 
GeneralLossless rotation PinmemberMember 304416416-Oct-08 13:13 
QuestionHow to specify text layer position? PinmemberMember 402220914-Mar-08 4:58 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web01 | 2.8.140827.1 | Last Updated 6 Dec 2011
Article Copyright 2006 by crazybit
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid