README.Epoc
author Sam Lantinga <slouken@libsdl.org>
Sat, 12 Feb 2005 18:03:54 +0000
changeset 1036 50f4e7e4d117
parent 250 74a8f672f2f8
permissions -rw-r--r--
[SDL] [PATCH] fix FB_VideoQuit for ia64
Jesse Barnes
Fri Jan 14 11:13:54 PST 2005

I noticed that on my ia64 machine when SDL_Quit was called, the machine would
hang in weird ways. It turned out to be caused by a machine check in the
memset() call near the top of FB_VideoQuit. Generally memset shouldn't be
used on I/O regions like the framebuffer or other I/O device memory (the
Linux kernel has special routines for dealing with I/O memory), so I changed
the #ifdef __powerpc__ to #if defined(__powerpc__) || defined(__ia64__) and
SDL_Quit now works properly. The change should probably be made
unconditional though since doing one byte at a time is the only way to be
portable, afaik.
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