README.Epoc
author Sam Lantinga <slouken@libsdl.org>
Thu, 06 May 2004 15:55:06 +0000
changeset 886 05c551e5bc64
parent 250 74a8f672f2f8
permissions -rw-r--r--
Date: Sat, 24 Apr 2004 15:13:32 +0300
From: "Mike Gorchak"
Subject: SDL updates for the QNX6

1. Updated the README.QNX
2. Updated libtool scripts, which are shipped with SDL for QNX6 support.
3. Added some code to support the new QNX 6.3.0, which is in beta now.
4. Added code to detect the hw features, which driver supports.
5. Added hw alpha blits code.
6. Fixed bug when application switches to fullscreen more the 2 times. (afte\
r that window becames always stay on top).
7. Updated a bit README for the tests.
8. Added information about acceleration show in the testalpha.c test.
9. Added small fixes to the testoverlay2.c test.
10. Added alpha and cc+alpha blits benchmarks to the testvidinfo.c test.
slouken@173
     1
slouken@250
     2
==============================================================================
slouken@250
     3
Using the Simple DirectMedia Layer with EPOC/SymbianOS 6.0
slouken@250
     4
==============================================================================
slouken@173
     5
slouken@250
     6
==============================================================================
slouken@250
     7
I.  Building the Simple DirectMedia Layer libraries:
slouken@173
     8
slouken@250
     9
  You can get Symbian SDK from: 
slouken@250
    10
    http://www.symbian.com.
slouken@173
    11
 
slouken@250
    12
  First create "Epoc" directory under SDL main directory and unpack 
slouken@250
    13
  EpocBuildFiles.zip in it.
slouken@250
    14
   
slouken@250
    15
  To build the librarys goto "epoc" directory and type:
slouken@250
    16
    bldmake bldfiles
slouken@250
    17
    abld makefile vc6 (for creating Microsoft Visual C++ makefiles)
slouken@250
    18
    abld build wins udeb (building for wins emulator)
slouken@250
    19
    abld build armi urel (building for real device)
slouken@173
    20
slouken@250
    21
==============================================================================
slouken@250
    22
II. Building the Simple DirectMedia Layer programs:
slouken@173
    23
slouken@250
    24
  Building SDL test programs is easy once you have built the libraries:
slouken@250
    25
    abld test build wins udeb
slouken@250
    26
    abld test build armi urel
slouken@173
    27
slouken@250
    28
  Supported real screen resolutions
slouken@250
    29
    320 x 200 x  8 bit
slouken@250
    30
    320 x 200 x 12 bit
slouken@250
    31
    640 x 200 x  8 bit
slouken@250
    32
    640 x 200 x 12 bit
slouken@250
    33
  Supported "emulated" screen resolutions 
slouken@250
    34
    640 x 400 x  8 bit
slouken@250
    35
    640 x 400 x 12 bit
slouken@250
    36
    640 x 480 x  8 bit
slouken@250
    37
    640 x 480 x 12 bit
slouken@250
    38
  "Emulated" resolutions are implemented by by shrinking the screen vertically 
slouken@250
    39
  i.e. only every second scanline is drawn. This is mainly ment to be used for 
slouken@250
    40
  testing quick ports of programs. Using faked resolutions is a waste of memory 
slouken@250
    41
  and cpu power!
slouken@173
    42
slouken@250
    43
==============================================================================
slouken@250
    44
III. Running test programs
slouken@173
    45
slouken@250
    46
  Copy executable to the device and run it from the File manager.   The Esc 
slouken@250
    47
  key quits demo programs. In Crystal, Exe programs do not appear in task list 
slouken@250
    48
  nor in Extras :-(. Test programs are tested in Nokia 9210 Communicator.
slouken@173
    49
slouken@250
    50
  Special keys used in SDL:
slouken@250
    51
    The Caps lock key enables or disables the virtual cursor. 
slouken@250
    52
    Function keys are mapped as follows: 
slouken@250
    53
    F1=chr+q, F2=chr+w,..., F8=chr+i, 
slouken@250
    54
    F9=chr+a,..., F12=chr+d.
slouken@173
    55
slouken@250
    56
==============================================================================
slouken@250
    57
IV.  Enjoy! :)
slouken@173
    58
slouken@250
    59
  If you have a project you'd like me to know about, or want to ask questions,
slouken@250
    60
  go ahead and join the SDL developer's mailing list by sending e-mail to:
slouken@173
    61
slouken@250
    62
	sdl-request@libsdl.org
slouken@173
    63
slouken@250
    64
  and put "subscribe" into the subject of the message. Or alternatively you
slouken@250
    65
  can use the web interface:
slouken@173
    66
slouken@250
    67
	http://www.libsdl.org/mailman/listinfo/sdl
slouken@173
    68
slouken@250
    69
  You can find more info about Epoc version of SDL from Hannu Viitala's 
slouken@250
    70
  homepage
slouken@250
    71
    http://www.mbnet.fi/~haviital
slouken@250
    72
  
slouken@250
    73
==============================================================================
slouken@173
    74
slouken@173
    75