uigraphics/AknIcon/group/ReadmeTools.txt
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Mon, 21 Jun 2010 16:49:08 +0300
branchRCL_3
changeset 78 0b86c25b743a
parent 63 9ad3127c7f4d
child 106 e4e3998ddda2
permissions -rw-r--r--
Revision: 201023 Kit: 2010125

# 
# Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies).
# All rights reserved.
# This component and the accompanying materials are made available
# under the terms of "Eclipse Public License v1.0"
# which accompanies this distribution, and is available
# at the URL "http://www.eclipse.org/legal/epl-v10.html".
# 
# Initial Contributors:
# Nokia Corporation - initial contribution.
# 
# Contributors:
# 
# Description: 
# 

Precacher tool
-------------------------------------------------------------------
Step 1:
Ensure the skins folder has series60skin_MIFList.txt. Compile \s60\mw\uiresources\skins\AknSkinContent to generate if its not present

Step 2:
Run IconId.pl
usage: IconId.pl MIFList-file build-path out-file

Example
Y:\>IconId.pl Y:\s60\mw\uiresources\skins\AknSkinContent\generated\scalableseries60skin\data\series60skin_MIFList.txt y: iconlist.csv

This generates the icon enum, major, minor number, icon id in iconlist.csv

Step 3:
Define the MACRO's for precacher, 
Macro PRECACHE2 should be defined to enable the precacher.
Macro PRECACHELOG should be defined to get the traces generated
To define the macro put the below code in AknIcon.mmp(in folder \s60\mw\uiresources\uigraphics\AknIcon\group)

MACRO PRECACHE2
MACRO PRECACHELOG
#define PRECACHELOG

Generate the build, flash the phone
Now start the phone open all the applications whose icons you wish to precache
This creates the trace file logs\AknIconPreCacher\Traces.txt (create the folder AknIconPreCacher if not already present)


Step 4:
Run IconLoads.pl
usage: iconlist iconloads out-file

Example
Y:\>IconLoads.pl iconlist.csv Y:\epoc32\winscw\c\logs\AknIconPreCacher\Traces.txt resources.rss

This generates the resource file in the required format

Step 5:
Copy the contents of the resource file (resources.rss in this case) into AknIconSrv.rss.
it will be in the folder \s60\mw\uiresources\uigraphics\AknIcon\srvsrc.

RESOURCE ARRAY r_precache_list2
    {
    items =
        {
	// copy the icon list here
        };
    }

Step 6:
Compile the AknIcon code, the macro PRECACHE2 should be defined (if not already done)to enable precaching
uncomment (or remove ) the macro definition for PRECACHELOG.