README.Epoc
author Ryan C. Gordon <icculus@icculus.org>
Thu, 19 Jan 2006 08:43:00 +0000
changeset 1251 86d0d01290ea
parent 250 74a8f672f2f8
permissions -rw-r--r--
Updated Windows CE/PocketPC support...adds GAPI driver, landscape mode,
updated project files, VS2005 support, VGA mode, more device support, etc,
etc, etc.

Fixes Bugzilla #47 and #28.

--ryan.
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