uigraphics/AknIcon/group/ReadmeTools.txt
author Dario Sestito <darios@symbian.org>
Fri, 19 Nov 2010 15:21:06 +0000
branchRCL_3
changeset 129 67a72ace5294
parent 107 9f95a5546443
permissions -rw-r--r--
Fix for Bug 3172 - Recorder application demands Memory card

# 
# 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.