diff -r 89d6a7a84779 -r 25a17d01db0c Symbian3/PDK/Source/GUID-ED20B02A-C146-5E28-A102-D3AE11D9015F.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/PDK/Source/GUID-ED20B02A-C146-5E28-A102-D3AE11D9015F.dita Fri Jan 22 18:26:19 2010 +0000 @@ -0,0 +1,57 @@ + + + + + +Building +and Running the MiniGUI TutorialThis topic describes how to build a MiniGUI ROM image and how to +run the MiniGUI in the emulator. +

Variant: ScreenPlay. Target audience: Device creators.

+

This topic builds on the introduction in the MiniGUI +Environment Overview and the ROM Tools Guide.

+
Building a MiniGUI ROM image
    +

  1. Use a text editor to +edit the Window Server configuration file, \epoc32\data\z\wsini_minigui.ini.

    Note: +This file must be created or saved in Unicode instead of ASCII.

    2. +

  2. Add the following lines +to the wsini_minigui.ini file to start ESHELL as the +system shell in the specified screen mode.

    STARTUP ESHELL +SCREENMODE COLOR16MAP

    Refer to The +wsini.ini File Reference for more information about the parameters.

    3. +

  3. Make sure that the ROM +image description file, minigui.oby, exists under \epoc32\rom\include\. +This OBY file is the input file to the BUILDROM tool.

    This +file contains a statement that refers to the wsini_minigui.ini file.

    data=DATAZ_\wsini_minigui.ini system\data\wsini.ini
    4. +

  4. Build a MiniGUI ROM +image from a command prompt.

    The following commands build a ROM image +for H4:

    > cd d:\Symbian\epoc32\rom

    > buildrom -nosymbols h4hrp +minigui

    The following commands build a ROM image for H6:

    > +cd d:\Symbian\epoc32\rom

    > buildrom -nosymbols 34xx_sdp minigui

    Where minigui stands +for the minigui.oby file. The -nosymbols directive +means do not generate the symbol file which contains the ROM building information +for debugging purpose.

    5. +

Result: The MiniGUI ROM image is generated in the current +directory: d:\Symbian\epoc32\rom.

+
Running the MiniGUI in the emulator
    +

  1. Make sure that ScreenPlay +is enabled and add the following line to the \epoc32\data\epoc.ini file:

    minigui

    For +more information about enabling ScreenPlay, refer to Enabling +the Graphics Architecture Variants.

    2. +

  2. Add the following lines +to the \epoc32\release\winscw\udeb\z\system\data\wsini.ini to +start ESHELL as the system shell in the specified screen mode:

    startup eshell +screenmode color16map
    3. +

Launch the emulator to verify that MiniGUI configuration works. It +boots into the black and white ESHELL.

+ +Enabling +the Graphics Architecture Variants +The wsini.ini +File + \ No newline at end of file