Click here to Skip to main content
13,836,160 members
Click here to Skip to main content
Add your own
alternative version


43 bookmarked
Posted 9 Mar 2003
Licenced CPOL

A Picture Viewer for the Pocket PC 2002

, 2 Nov 2003
Rate this:
Please Sign up or sign in to vote.
Putting imgdecmp.lib to work with a few extras.

Sample Image - PicView1.jpg


This is a very simple picture viewer that illustrates some implementation details that you might want to use in your own Pocket PC 2002 projects. These are:

  • Using the imgdecmp.lib for loading BMP, JPEG and GIF image files.
  • Implementing a "tap-and-scroll" for scrolling convenience.
  • Implementing a full screen view.
  • Removing the "New" button from a Document / View toolbar.
  • Adding a title bar to the view (new)

Application architecture

This application uses the MFC's Document / View architecture in order to ease implementation. Bitmap pictures are drawn in a CScrollView-derived class, with a special support for the "tap-and-scroll" functionality. This allows the user to scroll the bitmap using the stylus, by tapping and dragging it. The document does not allow saving (after all, this is a viewer), but supports zooming. The zoom in and zoom out commands are supported at the document level although, arguably, they could be implemented at the view level.

Loading images

Images are loaded through a sparsely-documented API, implemented through the imgdecmp.lib. Both this library and its header are distributed with the PPC2002 SDK. Apparently, this is the same mechanism that is used by Pocket IE to load its images from the Internet, and that is why it supports a packet architecture. As for file formats, it is reported to support BMP, JPEG and GIF, but it may support more.

Images are loaded in CPicViewDoc::Serialize(). The process (see source) involves calling the DecompressImageIndirect() function, the DecompressImageInfo structure and two callback functions. The first callback function - GetImageData() - is used to read the image data in chunks, whereas the second - ImageProgress() - is used to report the image loading progress. In this sample, the callback does nothing (but yes, it must be there).

The fields of the DecompressImageInfo structure are quite self-explanatory, with one exception: lParam. This is the parameter that is passed to the callback functions, and I use it to carry a pointer to a structure containing a pair of values (ReadBmp): the CFile pointer retrieved from the open CArchive, and a counter of the image size. This is not strictly necessary for this application because one file has just one image, so passing the CFile* in lParam would be enough. This technique is used because it allows for extensibility, in the case where the file has multiple images, such as a skin file. Here you cannot rely in the end-of-file stop rendering the bitmap.


This technique allows scrolling the image with a tap and drag sequence. The image will follow the stylus, scrolling automatically. The scroll bars are also present and active.

In order to achieve this effect, the view handles both OnLButtonDown() and OnMouseMove() (see code). The first stores the tap point, and the second calculates the scroll vector. This vector is then used in the ScrollTo() method, where the new scroll position is calculated. Note that this code was directly adapted from MFC's sources in order to avoid the unpleasant "jagged" scrolling one gets by using CScrollView::ScrollToPosition(). This method does not allow scrolling in both x and y directions simultaneously.

Full screen view

In the Pocket PC 2002, the full screen functionality is achieved through the SHFullScreen API. This function allows the application to position its main window over areas that are usually controlled by the system, such as the SIP and the taskbar. The code that achieves this is in the CMainFrame::OnFullScreen() handler. In order to support full screen toggling, a context menu is available through the tap-and-hold command. This menu allows you to enter and leave the full screen mode, as well as to issue Zoom In and Zoom Out commands.

The New button

Because this is just a viewer, the New button was removed from the main menu using a technique designed by Vassili Philippov. The original article is here: How to remove New button from command bar?

Title bar

Updated on October 27, 2003. The sample application now supports a title bar for displaying the image's file name. This title bar can be hidden or shown via a menu option, under Tools.

This title bar is implemented through the CCeTitleBar class, a CControlBar-derived window. It merely displays the title text in a predefined font and color.

Using this class is very straightforward (see source code). The window is created on the view's OnCreate handler and destroyed in OnDestroy. The view's OnUpdate handler is used to set the title text (document file name). Showing and hiding the title bar is done in the view's OnShowTitle handler.


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


About the Author

João Paulo Figueira
Software Developer (Senior) Frotcom International
Portugal Portugal
I work on R&D for Frotcom International, a company that develops web-based fleet management solutions.

You may also be interested in...

Comments and Discussions

Questionwhat to do with hBmp after use? Pin
Kalian14-Jun-07 3:31
memberKalian14-Jun-07 3:31 
AnswerRe: what to do with hBmp after use? Pin
João Paulo Figueira14-Jun-07 8:43
professionalJoão Paulo Figueira14-Jun-07 8:43 
GeneralRe: what to do with hBmp after use? Pin
Kalian19-Jun-07 23:48
memberKalian19-Jun-07 23:48 
QuestionHow to make folders permanent in PPC2002/ppc2003?? Pin
amit4all8-Apr-07 6:51
memberamit4all8-Apr-07 6:51 
Generalevc++ linking problem... Pin
killerLee18-Jun-06 20:27
memberkillerLee18-Jun-06 20:27 
GeneralImage disappear Pin
houari_id24-Mar-06 7:48
memberhouari_id24-Mar-06 7:48 
GeneralRe: Image disappear Pin
João Paulo Figueira25-Mar-06 0:27
professionalJoão Paulo Figueira25-Mar-06 0:27 
GeneralRe: Image disappear Pin
houari_id25-Mar-06 3:45
memberhouari_id25-Mar-06 3:45 
QuestionHow to show image from winsock buffer? Pin
Member 225629616-Sep-05 2:02
memberMember 225629616-Sep-05 2:02 
Generalevc++ linking problem... Helpp!!! Pin
viveksundaram10-Apr-05 4:25
memberviveksundaram10-Apr-05 4:25 
Sorry... this msg has nothing to do with the picture viewer... I just need some help on a similar issue of linking... I use evc++ 4.0 sp4. I get the following error while linking... I use win32(WCE x86) Debug and StandardSDK Emulator...

corelibc.lib(pegwmain.obj) : error LNK2019: unresolved external symbol _WinMain referenced in function _WinMainCRTStartup
X86Dbg/l.exe : fatal error LNK1120: 1 unresolved externals
Error executing link.exe.

l.exe - 2 error(s), 0 warning(s)
I tried \force multiple and it didnt work....

plz helllppp!!!

GeneralRe: evc++ linking problem... Helpp!!! Pin
Daniel Jin24-Apr-05 5:15
memberDaniel Jin24-Apr-05 5:15 
GeneralRe: evc++ linking problem... Helpp!!! Pin
John Francis Shade1-Feb-06 1:32
memberJohn Francis Shade1-Feb-06 1:32 
GeneralRe: evc++ linking problem... Helpp!!! Pin
John Francis Shade1-Feb-06 22:34
memberJohn Francis Shade1-Feb-06 22:34 
GeneralRe: evc++ linking problem... Helpp!!! Pin
jitendra lokwani21-Jul-06 21:42
memberjitendra lokwani21-Jul-06 21:42 
GeneralRe: evc++ linking problem... Helpp!!! Pin
Androides11-Oct-06 0:41
memberAndroides11-Oct-06 0:41 
QuestionPicView for evc 4.0 ? Pin
riki_risnandar26-Dec-04 3:06
memberriki_risnandar26-Dec-04 3:06 
AnswerRe: PicView for evc 4.0 ? Pin
João Paulo Figueira26-Dec-04 23:45
professionalJoão Paulo Figueira26-Dec-04 23:45 
GeneralRe: PicView for evc 4.0 ? Pin
riki_risnandar27-Dec-04 6:31
memberriki_risnandar27-Dec-04 6:31 
GeneralRe: PicView for evc 4.0 ? Pin
Joseph Ellsworth24-May-05 21:56
memberJoseph Ellsworth24-May-05 21:56 
GeneralRe: PicView for evc 4.0 ? Pin
riki_risnandar27-May-05 8:44
memberriki_risnandar27-May-05 8:44 
GeneralRe: PicView for evc 4.0 ? Pin
avilap22-Jun-05 21:43
memberavilap22-Jun-05 21:43 
GeneralRe: PicView for evc 4.0 ? Pin
kk022316-Jan-08 20:06
memberkk022316-Jan-08 20:06 
GeneralRe: PicView for evc 4.0 ? Pin
wj840815@sohu.com27-Jan-08 22:42
memberwj840815@sohu.com27-Jan-08 22:42 
AnswerRe: PicView for evc 4.0 ? Pin
cyg8017-Jul-06 15:51
membercyg8017-Jul-06 15:51 
GeneralAccess the pixel Pin
Peter000125-Dec-04 1:03
memberPeter000125-Dec-04 1:03 

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

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

Permalink | Advertise | Privacy | Cookies | Terms of Use | Mobile
Web01 | 2.8.190114.1 | Last Updated 3 Nov 2003
Article Copyright 2003 by João Paulo Figueira
Everything else Copyright © CodeProject, 1999-2019
Layout: fixed | fluid