Mercurial > sdl-ios-xcode
view README.Epoc @ 1211:304d8dd6a989
To: sdl@libsdl.org
From: Christian Walther <cwalther@gmx.ch>
Date: Wed, 28 Dec 2005 12:13:20 +0100
Subject: [SDL] Fix for opening documents on Mac OS X < 10.4
The current code in SDLMain.m that transforms documents opened from the
Finder into command-line arguments (introduced in revision 1.14,
2005-08-11) uses the methods -[NSString lengthOfBytesUsingEncoding:] and
-[NSString getCString:maxLength:encoding:], which are only available in
Mac OS X 10.4.
Compiling this code on 10.3 produces warnings, and running it (i.e.
starting an SDL application by opening a document) leads to weird
behavior which I didn't investigate in detail ("*** -[NSCFString
lengthOfBytesUsingEncoding:]: selector not recognized" is printed to the
console log, and the SDL window never opens).
The attached patch removes the offending calls and uses -[NSString
UTF8String] instead, which is available everywhere. Tested on 10.3.9,
and I see no reason why it shouldn't also work on 10.2 and 10.4.
Two further comments:
* The comment above the -[SDLMain application: openFile:] implementation
says "You need to have a CFBundleDocumentsType section in your
Info.plist to get this message, apparently." This is not the case in my
experience - it worked just fine with a hand-built bare-bones
application consisting only of Test.app/Contents/MacOS/test, without any
Info.plist (although you have to press the option and command keys for
such an application to accept a dragged file).
* I took the liberty of cleaning up another area of SDLMain.m: I changed
"CustomApplicationMain (argc, argv)" to "CustomApplicationMain (int
argc, char **argv)". This avoids the "type of `argv' defaults to `int'"
warnings, and I'm not sure if leaving out the types could cause problems
on platforms where an int and a char** aren't of the same size.
-Christian
| author | Ryan C. Gordon <icculus@icculus.org> |
|---|---|
| date | Sun, 01 Jan 2006 23:45:52 +0000 |
| parents | 74a8f672f2f8 |
| children |
line wrap: on
line source
============================================================================== Using the Simple DirectMedia Layer with EPOC/SymbianOS 6.0 ============================================================================== ============================================================================== I. Building the Simple DirectMedia Layer libraries: 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) ============================================================================== II. Building the Simple DirectMedia Layer programs: 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 ==============================================================================