View source

__NOTOC__
__NOEDITSECTION__
{{KBCS}}
{{CodeSnippet
|id= CS000808
|platform=S60 3rd Edition<br/>S60 3rd Edition, FP1<br/>S60 3rd Edition, FP2
|devices=Nokia E90 Communicator
|category=Symbian C++
|subcategory=Graphics, SVG
|creationdate=February 6, 2008
|keywords=
}}

==Overview==

This code example describes how to create and add an icon to an S60 3rd Edition application.

In order to create SVG icons, you must have a suitable graphics editor, for example, [http://www.inkscape.org/ Inkscape].

This snippet can be self-signed.

==Steps==

1. Create an SVG icon on a 48-x-48-pixel canvas. You can test the icon by building the HelloWorldBasic application (in <tt>S60Ex</tt> directory under the SDK) with your own icon.

2. Save the icon in the <tt>gfx</tt> folder of your application according to the standard Symbian directory structure guidelines.

3. Create <tt>group\icons_scalable_dc.mk</tt> to automatically convert the icon to a Symbian .mif file whenever the application is compiled:

<code>
ifeq (WINS,$(findstring WINS, $(PLATFORM)))
ZDIR=$(EPOCROOT)epoc32\release\$(PLATFORM)\$(CFG)\Z
else
ZDIR=$(EPOCROOT)epoc32\data\z
endif

TARGETDIR=$(ZDIR)\resource\apps
ICONTARGETFILENAME=$(TARGETDIR)\Application_aif.mif

ICONDIR=..\gfx

do_nothing :
    @rem do_nothing

MAKMAKE : do_nothing

BLD : do_nothing

CLEAN : do_nothing

LIB : do_nothing

CLEANLIB : do_nothing

RESOURCE :
    mifconv $(ICONTARGETFILENAME) \
        /c32 $(ICONDIR)\icon.svg

FREEZE : do_nothing

SAVESPACE : do_nothing

RELEASABLES :
    @echo $(ICONTARGETFILENAME)

FINAL : do_nothing
</code>

'''Note:''' When editing the makefile, make sure that you use tabulators instead of spaces. (Otherwise you get the error: "ICONS_SCALABLE_DC.MK:25: *** missing separator.  Stop.")

4. Edit <tt>group\bld.inf</tt> to contain the makefile created above:

<code>
#ifdef EKA2 //3rd Edition
gnumakefile icons_scalable_dc.mk
Application_S60_3rd_ed.mmp
#else       //1st and 2nd Edition
Application_S60_2nd_ed.mmp
#endif
</code>

'''Note:''' Remember to run "bldmake bldfiles" after editing the bld.inf file.

5. Edit the resource file of your application (<tt>data\[app].rss</tt>) to contain the icon:

<code>
#include <appinfo.rh>
#include "Application.rls"

// ----------------------------------------------------------------------------
//
// r_application_localisable_app_info
//
// ----------------------------------------------------------------------------

RESOURCE LOCALISABLE_APP_INFO r_application_localisable_app_info
    {
    short_caption = STRING_r_app_caption_string;
    caption_and_icon = 
    CAPTION_AND_ICON_INFO
        {
        caption = STRING_r_app_caption_string;

        number_of_icons = 1;
        icon_file = "\\resource\\apps\\Application_aif.mif";
        };
    }
</code>

'''Note:''' The localizable application information presented above is often located in <tt>data\[app]_loc.rss</tt> file. Experience has shown that an icon may not always show on the device if it is declared in the loc.rss file. If you decide to use .rss instead of loc.rss, make sure that you remove all references to loc.rss (especially the <tt>localisable_resource_file</tt> declaration in <tt>APP_REGISTRATION_INFO</tt> resource in <tt>data\[app]_reg.rss</tt> and <tt>RESOURCE</tt> section in <tt>group\[app].mmp</tt>).

'''Note:''' Ensure that <tt>App_reg.rss</tt> file contains a reference to the localizable application information:
<code>
localisable_resource_id = R_APPLICATION_LOCALISABLE_APP_INFO;
</code>

6. Edit the pkg file (<tt>sis\[app].pkg</tt>):

<code>
;Language - standard language definitions
&EN,FI

{
"\Symbian\9.2\S60_3rd_FP1\Epoc32\Data\z\resource\apps\Application.rsc"
"\Symbian\9.2\S60_3rd_FP1\Epoc32\Data\z\resource\apps\Application.R09"
} -"!:\resource\apps\Application.rsc"

;Icon resources
"\Symbian\9.2\S60_3rd_FP1\Epoc32\Data\z\resource\apps\Application_aif.mif"
  -"!:\resource\apps\Application_aif.mif"
</code>

==See also ==

* [http://wiki.forum.nokia.com/index.php/How_to_create_application_icon%28SVG%29_in_S60_3rd_edition How to create application icon (SVG) in S60 3rd Edition]

[[Category:Symbian C++]][[Category:Graphics]][[Category:SVG]][[Category:Code Examples]]