Click here to Skip to main content
13,830,334 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

Generalintegration question Pin
cricri197615-Dec-03 3:18
membercricri197615-Dec-03 3:18 
GeneralAbout DirectShow Pin
lygyang200312-Nov-03 16:41
memberlygyang200312-Nov-03 16:41 
QuestionHow can force full screen from the view without menu Pin
bm_masri2-Nov-03 6:38
memberbm_masri2-Nov-03 6:38 
AnswerRe: How can force full screen from the view without menu Pin
bm_masri2-Nov-03 6:42
memberbm_masri2-Nov-03 6:42 
AnswerRe: How can force full screen from the view without menu Pin
João Paulo Figueira2-Nov-03 12:05
professionalJoão Paulo Figueira2-Nov-03 12:05 
GeneralRe: How can force full screen from the view without menu Pin
bm_masri2-Nov-03 12:08
memberbm_masri2-Nov-03 12:08 
GeneralRe: How can force full screen from the view without menu Pin
João Paulo Figueira2-Nov-03 23:25
professionalJoão Paulo Figueira2-Nov-03 23:25 
GeneralMap Viewer Pin
Member 56793515-Oct-03 6:58
memberMember 56793515-Oct-03 6:58 
GeneralRe: Map Viewer Pin
Member 56793516-Oct-03 7:23
memberMember 56793516-Oct-03 7:23 
GeneralRe: Map Viewer Pin
João Paulo Figueira16-Oct-03 7:33
professionalJoão Paulo Figueira16-Oct-03 7:33 
GeneralRe: Map Viewer Pin
Member 56793518-Oct-03 0:02
memberMember 56793518-Oct-03 0:02 
Generalwhy do I get errors in the emulator Pin
slomoman12-Oct-03 1:04
memberslomoman12-Oct-03 1:04 
GeneralRe: why do I get errors in the emulator Pin
João Paulo Figueira12-Oct-03 6:28
professionalJoão Paulo Figueira12-Oct-03 6:28 
GeneralRe: why do I get errors in the emulator Pin
slomoman12-Oct-03 6:38
memberslomoman12-Oct-03 6:38 
GeneralWhere to find imgdecmp.h Pin
João Paulo Figueira17-Sep-03 23:25
professionalJoão Paulo Figueira17-Sep-03 23:25 
GeneralBeginner's question Pin
malozza12-Sep-03 0:38
membermalozza12-Sep-03 0:38 
GeneralRe: Beginner's question Pin
João Paulo Figueira17-Sep-03 23:23
professionalJoão Paulo Figueira17-Sep-03 23:23 
GeneralLink error Pin
wehaha6-Sep-03 1:24
memberwehaha6-Sep-03 1:24 
GeneralRe: Link error Pin
João Paulo Figueira6-Sep-03 10:24
professionalJoão Paulo Figueira6-Sep-03 10:24 
GeneralRe: Link error Pin
wehaha6-Sep-03 21:54
memberwehaha6-Sep-03 21:54 
GeneralRe: Link error Pin
João Paulo Figueira7-Sep-03 9:37
professionalJoão Paulo Figueira7-Sep-03 9:37 
GeneralRe: Link error Pin
wehaha9-Sep-03 1:18
memberwehaha9-Sep-03 1:18 
GeneralRe: Link error Pin
hendry_johan26-Sep-03 17:56
memberhendry_johan26-Sep-03 17:56 
GeneralRe: Link error Pin
João Paulo Figueira27-Sep-03 5:35
professionalJoão Paulo Figueira27-Sep-03 5:35 
GeneralRe: Link error Pin
hendry_johan1-Oct-03 19:36
memberhendry_johan1-Oct-03 19:36 

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