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

CPJAImage - Yet another image drawing class

, 26 Aug 2003 CPOL
Rate this:
Please Sign up or sign in to vote.
A class that draws an image with various options - transparently, disabled or grayscale, centered on or stretched to fit a given rectangle.
<!-- Article image -->

Sample Image - PJAImage.jpg

<!-- Add the rest of your HTML here -->


Aug 23, 2003 - Fixed transparent drawing bug


After I wrote my CFileEditCtrl edit control, I got a request to place an image on the browse button, and then another request to make the control flat and hot to the mouse. That was becoming quite a task, searching on this site and for drawing code that would draw images, either bitmaps or icons, either normally or transparently, grey-scaled or disabled, possibly stretched or at least centered on the button. So after finding some code that solved one bit or another (but not quite the way I wanted), I put them together, filled in the pieces that were missing and came up with the CPJAImage class. While the reason I wrote the class was for the browse button, I thought it was a shame not to share it with you as yet another separate image rendering class.


Jean-Edouard Lachand-Robert for his DitherBlt() function.

Paul Reynolds for the "True Mask" transparency function.

Zafir Anjum and Guy Gascoigne for their greyscale algorithm.

Using the CPJAImage class

The first step is to include the PJAImage.h and PJAImage.cpp files in your project. Then after you have loaded or created your bitmap or icon object in the normal fashion, select it into the CPJAImage object using the SetImage() function.

CBitmap Bitmap;
CPJAImage PJAImage;
PJAImage.SetImage(Bitmap, PJAI_BITMAP);

Then when you are ready to draw the image, use the DrawImage() function to draw the image onto the given device context.

PJAImage.DrawImage(pDC, left, top, width, height, DrawFlags);

The drawing flags you specify in the DrawImage() function determine how the image is drawn.

User functions


The class constructor creates an empty CPJAImage object.


The class destructor destroys the image handle

void CPJAImage::DrawImage(CDC *pToDC, int x, int y, int w, int h, DWORD DrawFlags = 0)

The DrawImage() does the actual drawing.


pToDC A pointer to the device context the image is to be drawn on.
x The left side of the bounding rectangle where the image is to be drawn
y The top of the bounding rectangle
w The width of the bounding rectangle
h The height of the bounding rectangle
DrawFlags The flags used to control the drawing

Flags used in the DrawFlags parameter


Draws the image centered on the supplied rectangle. If the image is larger than the rectangle, it will be clipped. This flag can not be used with the PJAI_STRETCHED flag.
PJAI_STRETCHED Draws the image so that it fills the supplied rectangle. Bitmaps are stretched using the StretchBlt() API function. Icons are stretched using the DrawIconEx() API function. This flag can not be used with the PJAI_CENTERED flag.
PJAI_DISABLED Draws the image as disabled (3D Monochrome). This flag can not be used with the PJAI_GRAYSCALE flag.
PJAI_GRAYSCALE Draws the image in grayscale. This flag can not be used with the PJAI_DISABLED flag.
PJAI_TRANSPARENT Draws the image transparently. If the transparent color is not specified with the SetTransparentColor() function, the color at the top left corner (GetPixel(0, 0)) of the image is used as the transparent color. This flag has no effect if the image is an icon, as icons are transparent by default.

CSize CPJAImage::GetSize()

Returns a CSize object that contains the size of the image currently contained in the CPJAImage.

BOOL CPJAImage::SetImage(HANDLE hImage, DWORD Flags)

Selects the supplied image into the CPJAImage object. Returns TRUE if the supplied image was successfully selected, FALSE if not.


hImage The HANDLE of the image, can be a HBITMAP (DIB or DDB) or a HICON
Flags Specifies the image flags.

Flags used by the SetImage() function

PJAI_BITMAP The given handle is an HBITMAP
PJAI_ICON The given handle is a HICON
PJAI_AUTODELETE The given handle will be deleted and the memory freed when a new image is set or the CPJAImage object is deleted. If this flag is not set, the user of this class is responsible for freeing the image handle when it is no longer needed


Sets the color to be used as the transparent color for the bitmap image. Returns the previous transparent color. If CLR_DEFAULT (0xFF000000) is set as the transparent color, the color of the pixel at the top left corner ( GetPixel (0, 0) ) is used as the transparent color.


clr The transparent color

Demonstration Application

Be sure to check out the demo app to see the CPJAImage class in action. While the demo has a preloaded image in it, you can drag 'n drop your favorite picture files ( *.ico, *.bmp, *.jpg, or *.gif ) onto the demo app.

To change the transparent color, click the Set Color button, and then use the mouse to select the color from the picture displayed.



This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

PJ Arends
Canada Canada
No Biography provided

Comments and Discussions

BugBug? Pinmemberretinex19-Nov-11 6:17 
QuestionWhat a great class! Pinmembercoder_kevin11-Feb-09 11:38 
GeneralTwice PinmemberMike Gaskey15-Sep-06 13:37 
QuestionIs this a bug? PinmemberIvanBohannon27-Jan-06 18:49 
AnswerRe: Is this a bug? PinmemberPJ Arends28-Jan-06 7:45 
GeneralRe: Is this a bug? PinmemberIvanBohannon28-Jan-06 8:08 
Generalyou are really a superstar!!!! PinmemberAngus He28-Sep-05 18:37 
General5 - But a question on Picture/Static for Placeholder PinmemberGarth J Lancaster31-Jul-05 18:35 
GeneralRe: 5 - But a question on Picture/Static for Placeholder PinmemberPJ Arends1-Aug-05 12:03 
GeneralRe: 5 - But a question on Picture/Static for Placeholder PinmemberGarth J Lancaster1-Aug-05 20:51 

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 | Terms of Use | Mobile
Web01 | 2.8.150327.1 | Last Updated 27 Aug 2003
Article Copyright 2001 by PJ Arends
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid