README.Epoc
author Ryan C. Gordon <icculus@icculus.org>
Mon, 12 Dec 2005 09:13:12 +0000
changeset 1199 2d6dc7de1145
parent 250 74a8f672f2f8
permissions -rw-r--r--
From: Mike Frysinger <vapier@gentoo.org>
To: sdl@libsdl.org
Date: Sun, 11 Dec 2005 22:57:37 -0500
Subject: [SDL] exec stack in libsdl update

i posted back in September a patch to remove executable stacks:
http://www.devolution.com/pipermail/sdl/2005-September/070626.html

later in November, a similar patch was merged it seems:
http://www.libsdl.org/cgi/cvsweb.cgi/SDL12/src/hermes/mmx_main.asm

however, this lacks the additional output format checks that i posted in my
patch ... this isnt a problem if the hermes asm code is only ever used to
produce ELF objects, but if this is not true, then the additional checks in
my original patch will need to be merged
-mike
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