Customizing the Application Icons

Platforms:

An application designed for the S60 platform, when used with a 176x208 screen (this is the case for all S60 devices before S60 v2 FP3), uses two different icons to represent your application :
-  a 44x44 icon that is displayed in the context pane (the upper part of the screen) when your application is running
-  a 42x29 icon that is displayed in the application launcher

If you are designing for the UIQ 2.x platform, you should use a single 20x16 icon.

If you are using the Nokia Application Wizard, default icons are created for you in the project AIF folder. list_icon.bmp is the icon shown in the application launcher and context_pane_icon.bmp is the context pane icon). Both have an associated mask (list_icon_mask.bmp and context_pane_icon.bmp, located in the same directory).

The simplest way to create your own icons is to edit these bmp files, keeping the same file name and the same bit depth (8 bits per pixel / 256 colors for the icon files, 1 bit per pixel / 2 colors for the masks) [1].

If you don't use the AppWizard (or if you want to use your own files with different names or bit depth), you have to add or modify the following statement at the end of your application's .mmp (all the statement is on one line) [2]:

AIF myApp.aif ..\aif myApp.rss <bmp type> icon1.bmp icon1_mask.bmp icon2.bmp icon2_mask.bmp

where:
-  icon1.bmp is the context pane icon,
-  icon2.bmp is the application list icon,
-  <bmp type>  indicates the number of colors in icon1.bmp and icon2.bmp and has the form <color/mono indicator><bit-depth>, with <color/mono indicator> equals c for a color file and nothing for a grayscale file. Common values are c8 for a 256 colors bitmap and c16 for a 65K colors one),
-  the mask files are black and white bitmaps with one bit per pixel

The last important rules to see your new bitmaps is to compile from the DOS command line, not from Visual Studio.

[1] for icons generated by the AppWizard v1.9

[2] The statement shown here suppose that your file are organized in the same way the Application Wizard does, i.e. ..\aif is the path from the .mmp file to the .bmp files


> Customizing the Application Icons

Is there anyway to change the application's Icon (the one at the top of the screen when the application is running) dynamically within the code of the actual application, i.e. with out rebuiklding the application.

cheers

John

> Customizing the Application Icons

There is agood example in the sdk serie 60. The spane example (in my sdk : 8.1a\S60_2nd_FP3\Series60Ex\spane) You need to: Embedd the icons (icon and its mask) in the mbm Customize rss file: include the mbg file compiled from the mbm look in the spane rss and copy from their STATUS_PANE_APP_MODEL