release_notes.txt

symbian中

S60 Platform: Scalable Screen-Drawing Example v1.1
--------------------------------------------------

This C++ application demonstrates scalable screen drawing with Direct Screen Access and custom drawing routines 
using SVG-T icons and bitmaps. The application scales to multiple display resolutions in portrait and landscape 
orientations supported by the S60 platform (from S60 2nd Edition, Feature Pack 3 onwards). This example is targeted 
especially at games and multimedia developers who prefer developing a custom UI instead of using an automatically 
scaling UI, such as S60 Avkon components. The document S60 Platform: Scalable Screen-Drawing How-To 
(http://www.forum.nokia.com/info/sw.nokia.com/id/8bb62d7d-fc95-4ceb-8796-
a1fb0452d8dd/S60_Platform_Scalable_Screen-Drawing_How-To_v1_0_en.pdf.html) available at 
www.forum.nokia.com is closely related to this example. 
    
--------------------------------------------------------------------------------

PREREQUISITES

Symbian C++ basics
Multimedia

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

IMPORTANT FILES/CLASSES

inc\ScalableScreenDrawingEngine.h
src\ScalableScreenDrawingEngine.cpp 

classes CScalableScreenDrawingEngine
        CIconFileProvider 
        MDirectScreenAccess
	MAknIconFileProvider
	CCoeControl (HandleResourceChange() method and KEikDynamicLayoutVariantSwitch)
	CEikAppUi (ApplicationRect(), Orientation(), and SetOrientationL() methods)

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

KNOWN ISSUES

On the emulator: Closing the application causes a panic.

The Toggle Orientation command works properly only when running the application on the 
mobile device that supports both portrait and landscape orientations.

On the S60 2nd Edition, FP3, WINSCW emulator: The Toggle Orientation command causes
a panic. 

On the S60 3rd Edition, WINSCW emulator: The Toggle Orientation command disrupts the 
layout; use the Switch Configuration key instead.

On some S60 3rd Edition devices, disabling double buffering may cause flickering.


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

RUNNING THE EXAMPLE

There is only one view in the application:
    
Menu view            
            
Use navigation keys (up/down) to change between menu items. Select menu items to
toggle functionalities of the application. 
- Toggle Dbl Buffer
- Toggle Icons		Enable selection icon (stars/arrow)
- Toggle Anchor		Anchor CBA buttons 
- Toggle Background	Switch between bitmap and SVG background
- Scroll		Enable/disable background scrolling
- Toggle Orientation	Switch application orientation landscape/portrait	
- Toggle Snow		Enable/disable "snowing"



To hide the menu, press the # key. This will increase the frame rate, since 
drawing fonts with basic routines is slow.             
     
--------------------------------------------------------------------------------

BUILD & INSTALLATION INSTRUCTIONS

The source code can be compiled on all S60 2nd Edition, FP3 or 
newer SDKs. Steps for building and installing the application to a device depend on 
the S60 platform version:

--Mobile device (S60 3rd Edition)
    cd to /ScalableScreenDrawing/group
    bldmake bldfiles
    abld build gcce urel
    cd to /ScalableScreenDrawing/sis
    Edit the ScalableScreenDrawing_S60_3rd_gcce.pkg's paths to match those on
    your system.

    makesis ScalableScreenDrawing_S60_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 an S60 3rd Edition device.
    - If you get a "Certificate error" during installation of a self-signed 
      package, check that App.Manager -> Settings -> Software Installation is 
      set to "All." 
    
--Mobile device (S60 2nd Edition, FP3)
    cd to /ScalableScreenDrawing/group
    bldmake bldfiles
    abld build thumb urel
    cd to /ScalableScreenDrawing/sis
    Edit the ScalableScreenDrawing_S60_2nd_FP3.pkg's paths to match those on
    your system.

    makesis ScalableScreenDrawing_S60_2nd_FP3.pkg    

    Install the SIS file to the device.
    
--Emulator (WINSCW)
    cd to /ScalableScreenDrawing/group
    bldmake bldfiles
    abld build winscw udeb
    Start the emulator.
    
--------------------------------------------------------------------------------

COMPATIBILITY

S60 3rd Edition
S60 2nd Edition FP3
    
S60 3rd Edition, Feature Pack 1: Nokia N95
S60 3rd Edition: Nokia 5500 Sport, Nokia E60, Nokia E61, Nokia E70, Nokia N71, Nokia N80, Nokia N91, Nokia N93
S60 2nd Edition, Feature Pack 3: Nokia N70, Nokia N90
    
--------------------------------------------------------------------------------

VERSION HISTORY		

1.1   Minor changes to the .svg files: The viewBox attribute must be defined, 
       otherwise some S60 3rd Edition devices fail to render the image correctly
       (especially when scaling the image using AknIconUtils::SetSize()). Separated
       the menu icon and private icons used by the application to separated icon
       files.

1.0    First release

--------------------------------------------------------------------------------
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=ab7e4e35-d8c4-45c2-9d6b-c12257910944/S60_Platform_Scalable_Screen_Drawing_Example_v1_1_en.zip