README.Epoc
author Sam Lantinga <slouken@libsdl.org>
Fri, 14 Dec 2001 12:37:34 +0000
changeset 250 74a8f672f2f8
parent 173 83018110dce8
permissions -rw-r--r--
Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
173
83018110dce8 Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     1
250
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
     2
==============================================================================
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
     3
Using the Simple DirectMedia Layer with EPOC/SymbianOS 6.0
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
     4
==============================================================================
173
83018110dce8 Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     5
250
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
     6
==============================================================================
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
     7
I.  Building the Simple DirectMedia Layer libraries:
173
83018110dce8 Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     8
250
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
     9
  You can get Symbian SDK from: 
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    10
    http://www.symbian.com.
173
83018110dce8 Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    11
 
250
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    12
  First create "Epoc" directory under SDL main directory and unpack 
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    13
  EpocBuildFiles.zip in it.
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    14
   
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    15
  To build the librarys goto "epoc" directory and type:
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    16
    bldmake bldfiles
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    17
    abld makefile vc6 (for creating Microsoft Visual C++ makefiles)
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    18
    abld build wins udeb (building for wins emulator)
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    19
    abld build armi urel (building for real device)
173
83018110dce8 Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    20
250
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    21
==============================================================================
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    22
II. Building the Simple DirectMedia Layer programs:
173
83018110dce8 Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    23
250
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    24
  Building SDL test programs is easy once you have built the libraries:
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    25
    abld test build wins udeb
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    26
    abld test build armi urel
173
83018110dce8 Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    27
250
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    28
  Supported real screen resolutions
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    29
    320 x 200 x  8 bit
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    30
    320 x 200 x 12 bit
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    31
    640 x 200 x  8 bit
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    32
    640 x 200 x 12 bit
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    33
  Supported "emulated" screen resolutions 
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    34
    640 x 400 x  8 bit
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    35
    640 x 400 x 12 bit
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    36
    640 x 480 x  8 bit
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    37
    640 x 480 x 12 bit
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    38
  "Emulated" resolutions are implemented by by shrinking the screen vertically 
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    39
  i.e. only every second scanline is drawn. This is mainly ment to be used for 
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    40
  testing quick ports of programs. Using faked resolutions is a waste of memory 
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    41
  and cpu power!
173
83018110dce8 Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    42
250
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    43
==============================================================================
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    44
III. Running test programs
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    45
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    46
  Copy executable to the device and run it from the File manager.   The Esc 
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    47
  key quits demo programs. In Crystal, Exe programs do not appear in task list 
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    48
  nor in Extras :-(. Test programs are tested in Nokia 9210 Communicator.
173
83018110dce8 Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    49
250
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    50
  Special keys used in SDL:
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    51
    The Caps lock key enables or disables the virtual cursor. 
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    52
    Function keys are mapped as follows: 
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    53
    F1=chr+q, F2=chr+w,..., F8=chr+i, 
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    54
    F9=chr+a,..., F12=chr+d.
173
83018110dce8 Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    55
250
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    56
==============================================================================
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    57
IV.  Enjoy! :)
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    58
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    59
  If you have a project you'd like me to know about, or want to ask questions,
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    60
  go ahead and join the SDL developer's mailing list by sending e-mail to:
173
83018110dce8 Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    61
250
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    62
	sdl-request@libsdl.org
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    63
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    64
  and put "subscribe" into the subject of the message. Or alternatively you
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    65
  can use the web interface:
173
83018110dce8 Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    66
250
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    67
	http://www.libsdl.org/mailman/listinfo/sdl
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    68
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    69
  You can find more info about Epoc version of SDL from Hannu Viitala's 
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    70
  homepage
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    71
    http://www.mbnet.fi/~haviital
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    72
  
74a8f672f2f8 Added support for building SDL for EPOC/SymbianOS 6.0 (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents: 173
diff changeset
    73
==============================================================================
173
83018110dce8 Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    74
83018110dce8 Added initial support for EPOC/Symbian OS (thanks Hannu!)
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    75