From 11298a53e93c5d62340d9eba1c20c8b25a1adebf Mon Sep 17 00:00:00 2001
From: Sam Lantinga <slouken@libsdl.org>
Date: Fri, 14 Dec 2001 12:37:34 +0000
Subject: [PATCH] Added support for building SDL for EPOC/SymbianOS 6.0 (thanks
 Hannu!)

--HG--
extra : convert_revision : svn%3Ac70aab31-4412-0410-b14c-859654838e24/trunk%40251
---
 BUGS               |  13 ++++
 CREDITS            |   2 +
 EpocBuildFiles.zip | Bin 0 -> 2012 bytes
 README.Epoc        | 146 +++++++++++++++++++++------------------------
 docs.html          |   1 +
 5 files changed, 83 insertions(+), 79 deletions(-)
 create mode 100644 EpocBuildFiles.zip

diff --git a/BUGS b/BUGS
index 5d20bc5d8..263eba223 100644
--- a/BUGS
+++ b/BUGS
@@ -135,6 +135,18 @@ IRIX:
 
 	The keyboard modifiers are not set to the correct state on startup.
 
+EPOC:
+    Only Crystal version of Epoc/SymbianOS is currently supported.
+
+    SDL is implemented in static library only. SDL uses static/global
+    variables and that is not allowed in EPOC dll libraries.
+
+    Sound is not yet supported.
+
+    Joystick, OpenGL and cdrom is not supported (think about cdrom in a cell phone:-).
+    
+    No console output screen. Printing to stdout do not have any effect.
+
 OpenBSD:  -= NOT YET SUPPORTED =-
 	This is reported to work, but I haven't verified this.
 
@@ -208,3 +220,4 @@ AmigaOS:  -= NOT YET SUPPORTED =-
 	Continuous relative mouse motion is not implemented.
 
 	The AmigaOS port was done by Gabriele.Greco@galactica.it
+
diff --git a/CREDITS b/CREDITS
index b8446148a..2db981e57 100644
--- a/CREDITS
+++ b/CREDITS
@@ -19,6 +19,8 @@ Thanks to everyone who made this possible, including:
 
 * Patrick Trainor and Jim Boucher, for the QNX Neutrino port
 
+* Hannu Viitala for the EPOC port
+
 * Gabriele Greco, for the Amiga port
 
 * Carsten Griwodz for the AIX port
diff --git a/EpocBuildFiles.zip b/EpocBuildFiles.zip
new file mode 100644
index 0000000000000000000000000000000000000000..9de7244f97e583faca089e0a27331bc2b4c2aa18
GIT binary patch
literal 2012
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

literal 0
HcmV?d00001

diff --git a/README.Epoc b/README.Epoc
index 780e4c2ca..380cb2527 100644
--- a/README.Epoc
+++ b/README.Epoc
@@ -1,87 +1,75 @@
-31.8.2001 HJV
 
-SDL for EPOC/Symbian OS
-=======================
+==============================================================================
+Using the Simple DirectMedia Layer with EPOC/SymbianOS 6.0
+==============================================================================
 
-This is an Epoc port of SDL (1.2.0). It is not yet complete, but good enough for starting to port all those wonderful SDL based demos, games and other programs to Epoc! I have tested a bunch of demos and test programs in Nokia 9210 Communicator, which is a fancy device with combined PDA/GSM phone features, Symbian OS (Crystal), a full keyboard and a color screen (640x200x12bit).
+==============================================================================
+I.  Building the Simple DirectMedia Layer libraries:
 
-Btw. Also SDLDoom works over SDL Epoc port now (CDoom)!
+  You can get Symbian SDK from: 
+    http://www.symbian.com.
  
+  First create "Epoc" directory under SDL main directory and unpack 
+  EpocBuildFiles.zip in it.
+   
+  To build the librarys goto "epoc" directory and type:
+    bldmake bldfiles
+    abld makefile vc6 (for creating Microsoft Visual C++ makefiles)
+    abld build wins udeb (building for wins emulator)
+    abld build armi urel (building for real device)
 
-How to install to device
-========================
+==============================================================================
+II. Building the Simple DirectMedia Layer programs:
 
-Extract binary packets of the demo and test programs and copy the files to N9210.
+  Building SDL test programs is easy once you have built the libraries:
+    abld test build wins udeb
+    abld test build armi urel
+
+  Supported real screen resolutions
+    320 x 200 x  8 bit
+    320 x 200 x 12 bit
+    640 x 200 x  8 bit
+    640 x 200 x 12 bit
+  Supported "emulated" screen resolutions 
+    640 x 400 x  8 bit
+    640 x 400 x 12 bit
+    640 x 480 x  8 bit
+    640 x 480 x 12 bit
+  "Emulated" resolutions are implemented by by shrinking the screen vertically 
+  i.e. only every second scanline is drawn. This is mainly ment to be used for 
+  testing quick ports of programs. Using faked resolutions is a waste of memory 
+  and cpu power!
+
+==============================================================================
+III. Running test programs
+
+  Copy executable to the device and run it from the File manager.   The Esc 
+  key quits demo programs. In Crystal, Exe programs do not appear in task list 
+  nor in Extras :-(. Test programs are tested in Nokia 9210 Communicator.
+
+  Special keys used in SDL:
+    The Caps lock key enables or disables the virtual cursor. 
+    Function keys are mapped as follows: 
+    F1=chr+q, F2=chr+w,..., F8=chr+i, 
+    F9=chr+a,..., F12=chr+d.
+
+==============================================================================
+IV.  Enjoy! :)
+
+  If you have a project you'd like me to know about, or want to ask questions,
+  go ahead and join the SDL developer's mailing list by sending e-mail to:
+
+	sdl-request@libsdl.org
+
+  and put "subscribe" into the subject of the message. Or alternatively you
+  can use the web interface:
+
+	http://www.libsdl.org/mailman/listinfo/sdl
+
+  You can find more info about Epoc version of SDL from Hannu Viitala's 
+  homepage
+    http://www.mbnet.fi/~haviital
+  
+==============================================================================
 
 
-How to use
-==========
-
-Run exe's from the File manager. The Caps lock key enables or disables the virtual cursor. 
-The Esc key quits demo programs.
-Function keys are mapped as follows: 
-- F1=chr+q, F2=chr+w,..., F8=chr+i, 
-- F9=chr+a,..., F12=chr+d.
-
-In Crystal, Exe programs do not appear in task list nor in Extras :-(
-
-
-How to build
-============
-
-Building SDL, SDL_IMAGE and tests & demos:
-- Build files are in "\sdl\epoc\" and "\sdl_image\epoc\" directories
-- Building as usual: "bldmake bldfiles" "abld build wins udeb" "abld build armi urel"
-- Test and demos programs are build: "abld test build wins udeb" "abld test build armi urel" 
-
-
-Building and sources
-====================
-Information about the Epoc implementation: 
-- Made over SDL 1.2.0
-- Ported sources: SDL, SDL_image, xflame, fire, warp, newvox, graywin, testalpha, SDLDoom(CDoom)
-- Test programs do not have any major changes: usually only screen size and depth is 
-  changed for 9210, if needed
-- Like in all the other platform implementations, the Epoc specific code is in "Epoc" subdirectories. All build files for Epoc are in the directory \sdl\epoc\. Adding a new OS support requires always some changes also in generic files (search for "#ifdef __SYMBIAN32__").
-- Currently, two resolutions and bit depths are supported: 320x200 and 640x200 with 8 or 12 bit color.
-- I addition, two faked resolutions are supported: 640x400, 640x480. These are implemented by shrinking the screen vertically i.e. only every second scanline is drawn. This can be used for testing and for non-resource intensive programs. Thought, using faked resolutions is a waste of memory and cpu power! 
-
-Change history
-==============
-
-31.8.2001 Alpha 0.2:
-- Now you should build ARMI binaries instead of THUMB. It runs faster. 
-- sdl_main.cpp: removed check for existing instance of sdlprogram
-- sdl_error.h: Added debug macros under conditional compilation in Epoc
-- sdl_epocevents.cpp: Added focus lost&gained event handling, added modifier handling, added a lot more key event handling (function keys and others). Function keys are mapped as follows: 
-  F1=chr+q, F2=chr+w,..., F8=chr+i, F9=chr+a,..., F12=chr+d.
-- sdl_epocvideo.h: Added EPOC_ScreenOffset variable. Added EPOC_IsWindowFocused variable (but not used for anything yet!). Added RedrawWindowL() function.
-- sdl_epocvideo.cpp: Added debugging functions: Debug_AvailMem2() and Debug_AvailMem(). 
-  Changed window to have white background. Centralize game screen if it is not full size. 
-  Added RedrawWindowL() function. Force other windows to redraw if SDL window lost focus. This cleans up possible game graphics from screen. Redraw after getting focus again.
-
-
-Todo
-====
-
-This Epoc port is (of course;-) not thoroughly tested. For testing, I have compiled and run a couple of test programs and demos in N9210. Still, e.g. thread related functions have not been tested at all.
-
-Known bugs and unimplemented features:
-- No sound
-- No console output screen. Printing to stdout do not have any effect.
-- Epoc do not allow static/global variables in DLL libraries. So I could only use static linking with SDL.
-- Some test programs may take so much cpu in 9210 that e.g. SMS sending and receiving is not possible at a same time. Also screen may look awkward if there appear visible notes, dialogs etc. when an sdl program is active. SDL program runs in the lowest possible priority for minimum interference in the system. Unfortunately, this is always not enough.  Perhaps some Delay() commands are needed.
-
-P.s. I have ported also the SDL version of MirrorMagic puzzle game to Epoc. I will put the sources and binaries available as soon as I bother to clean the ported sources a bit... 
-
-
-Open Source & "bazaar" style software development
-=================================================
-
-You can take part in this porting project. This is Open Source software and you are very welcome to try it, test it, improve the code and implement the missing pieces. If you have any fix suggestions, improvements, code excerpts etc., contact me by email. Please start the mail subject with a string "EPOC SDL:".
-
-Cheers,
-Hannu
-
-Mail:hannu.j.viitala@mbnet.fi
-Homepage of SDL for Epoc: www.mbnet.fi/~haviital
diff --git a/docs.html b/docs.html
index 8481f9209..a749a5c69 100644
--- a/docs.html
+++ b/docs.html
@@ -16,6 +16,7 @@ be found at the <A HREF="http://www.libsdl.org/"> main SDL page</A>.
 Major changes since SDL 1.0.0:
 </H2>
 <UL>
+	<LI> 1.2.4: Added support for building SDL for EPOC/SymbianOS 6.0
 	<LI> 1.2.4: Added support for Xi Graphics XME fullscreen extension
 	<LI> 1.2.3: Added X11 Xinerama support - fullscreen starts on screen 0
 	<LI> 1.2.3: Added platform independent OpenGL header - SDL_opengl.h