release_notes.txt

基于SYMBIAN OS,series 60平台的经典游戏,超级马力

--------------------------------------------------------------------------------

Symbian OS: 2D Game Engine Example

--------------------------------------------------------------------------------

ABOUT THE EXAMPLE

The purpose of this example is to show how to make a portable and scalable 2D game
on top of Symbian OS, especially for the S60 and Series 80 platform, and for the Nokia 7710
multimedia smartphone.

There are only a few differences, and as such the sources are directly compilable
with any Series SDK.

The key features of this application are:
  A. How to make portable games.
	All texts and graphics are relative to the screen size.
	Series 80 and the Nokia 7710 use CEikAppUi, whereas CAknAppUi is used in S60 applications.
	Selection between CEikAppUi and CAknAppUi is handled with compile-time flags.
  
  B. How to structure a game so that it's easy and simple to create.
	The game is divided into separate "Models": TitleScreen, InGame, and HelpScreen.
	New models can be easily added by inheriting them from MModel and registering
	them in the application's container.
  
  C. Efficient screen access without CDirectScreenAccess.
	The application uses the RBackedupWindow method for drawing. This method does not override
	the window server, which means it does not draw over system messages. This method always uses
	the native bit depth, and no color conversion is needed.
  
  D. How to handle different display modes and screen resolutions. (Scalable UI)
	This application correctly supports the EColor4K, EColor64K, and EColor16M display modes.
	The game also supports different screen resolutions and portrait/landscape orientations. 
	System detects the screen resolution and then adapts the drawings accordingly.

The example currently supports the following screen resolutions.

S60 Platform:
- Low Resolution Portrait (176x208)
- QVGA Portrait (240x320) and Landscape (320x240)
- Double Resolution Portrait (352x416) and Landscape (416x352)

Series 80 Platform:
- 640 x 200

Nokia 7710:
- 640 x 320

Adding new resolutions is easy and straightforward.

--------------------------------------------------------------------------------

INSTALLATION INSTRUCTIONS

First, select the right group folder according to your current available SDK.

Make sure that the target paths for exported files in bld.inf are correct. 
Refer to your SDK documentation if you are unsure which path you should use.

Also make sure that the source paths in the sis\Example2D**.pkg file are correct.

    [** = your Nokia Series version number (S60,S80,7710)]

-- MOBILE DEVICE (All except S60 3rd Edition devices)
  
  Go to /Example2D/group**
  bldmake bldfiles
  abld build armi urel 
  Go to /Example2D/sis/
  makesis Example2D**.pkg
  
  Transfer the .sis file to your device
  and install it.

-- S60 3RD EDITION DEVICE

  The project can be compiled either for GCCE or ARMV5 target. The following instructions
  are for GCCE:
  
  Go to /Example2D/groupS60
  bldmake bldfiles
  abld build gcce urel 
  Go to /Example2D/sis/
  makesis example2ds60_3rd_gcce.pkg
  Sign the SIS package 
        - See the SDK Help for information about self-signed .sis packages, or
          www.symbiansigned.com for information about Developer Certificates
  
  Install the signed .sis file to a 3rd Edition device


-- EMULATOR

  First, make sure that the export paths in the .bld file are correct.
  
  Go to /Example2D/group**
  bldmake bldfiles
  ***Visual Studio users:***
  abld build wins udeb
  ***Codewarrior users***
  abld build winscw udeb
  Start the emulator
  Select the Example2D application and start it

--------------------------------------------------------------------------------

KNOWN ISSUES

Note that this example does not implement resource allocation and memory usage
patterns in a way that might be needed when developing a complex commercial Symbian
C++ game. In a large size game with multiple levels, for example, all the game data
should not be loaded at once and data sizes should not be hardcoded. Also, this example
does not illustrate how to avoid memory fragmentation. These issues are likely to be
considered in the next update of this example.

--------------------------------------------------------------------------------

This application has been tested with:

- S60: Nokia 3230, Nokia 3650, Nokia 7650, Nokia N-Gage(TM), Nokia N-Gage(TM) QD, 
       Nokia 6600, Nokia 6670, Nokia 7610, Nokia 6630, Nokia 6680, Nokia N71, 
       Nokia N90, Nokia E61, Nokia E70, Panasonic X700, Sendo X.
  
- Series 80: Nokia 9300 and Nokia 9500

- Nokia 7710

--------------------------------------------------------------------------------


EVALUATE THIS RESOURCE

Please spare a moment to help us improve documentation quality and recognize the 
examples you find most valuable, by rating this resource at
http://www.forum.nokia.com/main/1%2C%2C90%2C00.html?surveyId=de9c5cc7-fdf0-4c9f-ab00-f348a878c9b1/Symbian_OS_2D_Game_Engine_Example_v1_0.zip