<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"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: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-ED20B02A-C146-5E28-A102-D3AE11D9015F" xml:lang="en"><title>Building
and Running the MiniGUI Tutorial</title><shortdesc>This topic describes how to build a MiniGUI ROM image and how to
run the MiniGUI in the emulator. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<p> <b>Variant</b>: ScreenPlay. <b>Target audience</b>: Device creators. </p>
<p>This topic builds on the introduction in the <xref href="GUID-E09F74E2-B5A2-51F8-BD9E-882BE2661D5C.dita">MiniGUI
Environment Overview</xref> and the ROM Tools Guide. </p>
<section><title>Building a MiniGUI ROM image</title> <ol id="GUID-AAD227D8-8D67-5951-B359-715D4A0AD33B">
<li id="GUID-9921FB78-9201-5337-95D4-CB62BEFA4C32"><p>Use a text editor to
edit the Window Server configuration file, <filepath>\epoc32\data\z\wsini_minigui.ini</filepath>. </p> <p>Note:
This file must be created or saved in Unicode instead of ASCII. </p> </li>
<li id="GUID-43452758-28A2-5095-88FB-07C2964F49CB"><p>Add the following lines
to the <filepath>wsini_minigui.ini</filepath> file to start ESHELL as the
system shell in the specified screen mode. </p> <codeblock id="GUID-21B815C5-1BE1-5905-87C6-BA14DA659C8B" xml:space="preserve">STARTUP ESHELL
SCREENMODE COLOR16MAP</codeblock> <p>Refer to <xref href="GUID-1D529BDC-6665-58E2-AB3F-7023D8A84F69.dita">The
wsini.ini File Reference</xref> for more information about the parameters. </p> </li>
<li id="GUID-CC5687DF-9863-51C6-B348-D10C10868DAD"><p>Make sure that the ROM
image description file, <filepath>minigui.oby</filepath>, exists under <filepath>\epoc32\rom\include\</filepath>.
This OBY file is the input file to the <filepath>BUILDROM</filepath> tool. </p> <p>This
file contains a statement that refers to the <filepath>wsini_minigui.ini</filepath> file. </p> <codeblock id="GUID-82D32D6F-A2A2-56A0-8AF9-6C021CC3E321" xml:space="preserve">data=DATAZ_\wsini_minigui.ini    system\data\wsini.ini</codeblock> </li>
<li id="GUID-C3015F0E-CDE7-5940-9088-9DBE34468277"><p>Build a MiniGUI ROM
image from a command prompt. </p> <p>The following commands build a ROM image
for H4: </p> <p>&gt; cd d:\Symbian\epoc32\rom </p> <p>&gt; buildrom -nosymbols h4hrp
minigui </p> <p>The following commands build a ROM image for H6: </p> <p>&gt;
cd d:\Symbian\epoc32\rom </p> <p>&gt; buildrom -nosymbols 34xx_sdp minigui </p> <p>Where <filepath>minigui</filepath> stands
for the <filepath>minigui.oby</filepath> file. The <codeph>-nosymbols</codeph> directive
means do not generate the symbol file which contains the ROM building information
for debugging purpose. </p> </li>
</ol> <p> <b>Result</b>: The MiniGUI ROM image is generated in the current
directory: <filepath>d:\Symbian\epoc32\rom</filepath>. </p> </section>
<section><title>Running the MiniGUI in the emulator</title> <ol id="GUID-DC6EB5D4-FDE5-5464-B2CE-0D272F4AAD61">
<li id="GUID-B6913759-85BE-5480-B3A2-F0D52D7E40B7"><p>Make sure that ScreenPlay
is enabled and add the following line to the <filepath>\epoc32\data\epoc.ini</filepath> file: </p> <codeblock id="GUID-EE4BD889-EB25-5259-9183-7F96BF419794" xml:space="preserve">minigui</codeblock> <p>For
more information about enabling ScreenPlay, refer to <xref href="GUID-6D8A1FC7-095B-587E-8274-23C132978C53.dita">Enabling
the Graphics Architecture Variants</xref>. </p> </li>
<li id="GUID-B866EB6F-7817-55F1-9631-ED0B7122B048"><p>Add the following lines
to the <filepath>\epoc32\release\winscw\udeb\z\system\data\wsini.ini</filepath> to
start ESHELL as the system shell in the specified screen mode: </p> <codeblock id="GUID-7ECA751A-5C25-5774-ACBD-DA5D861C125D" xml:space="preserve">startup eshell
screenmode color16map</codeblock> </li>
</ol> <p>Launch the emulator to verify that MiniGUI configuration works. It
boots into the black and white ESHELL. </p> </section>
</conbody><related-links>
<link href="GUID-6D8A1FC7-095B-587E-8274-23C132978C53.dita"><linktext>Enabling
the Graphics Architecture  Variants</linktext></link>
<link href="GUID-85E1E45B-DD05-5B7D-84E7-9911E0A3E3CC.dita"><linktext>The wsini.ini
File</linktext></link>
</related-links></concept>