Added a README for Qtopia
authorSam Lantinga <slouken@libsdl.org>
Sat, 01 Jun 2002 18:43:51 +0000
changeset 3862c5d4c22a2ac
parent 385 daa944f00154
child 387 469d5c0da01d
Added a README for Qtopia
Makefile.am
README.Qtopia
     1.1 --- a/Makefile.am	Fri May 31 04:45:46 2002 +0000
     1.2 +++ b/Makefile.am	Sat Jun 01 18:43:51 2002 +0000
     1.3 @@ -31,6 +31,7 @@
     1.4  	README.MiNT	\
     1.5  	README.NanoX	\
     1.6  	README.QNX	\
     1.7 +	README.Qtopia	\
     1.8  	README.WinCE	\
     1.9  	README-SDL.txt	\
    1.10  	BorlandC.html	\
     2.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     2.2 +++ b/README.Qtopia	Sat Jun 01 18:43:51 2002 +0000
     2.3 @@ -0,0 +1,84 @@
     2.4 +
     2.5 +==============================================================================
     2.6 +Using the Simple DirectMedia Layer with Qtopia/OPIE
     2.7 +==============================================================================
     2.8 +
     2.9 +==============================================================================
    2.10 +I.  Setting up the Qtopia development environment.
    2.11 +
    2.12 +  This document will not explain how to setup the Qtopia development
    2.13 +  environment. That is outside the scope of the document. You can read
    2.14 +  more on this subject in this excellent howto:
    2.15 +
    2.16 +	http://www.zauruszone.com/howtos/linux_compiler_setup_howto.html
    2.17 +
    2.18 +==============================================================================
    2.19 +II.  Building the Simple DirectMedia Layer libraries using the arm
    2.20 +     cross-compiler
    2.21 +
    2.22 +  This is somewhat tricky since the name of the compiler binaries
    2.23 +  differ from the standard. Also you should disable features not
    2.24 +  needed. The command below works for me. Note that it's all one
    2.25 +  line. You can also set the NM, LD etc environment variables
    2.26 +  separately.
    2.27 +
    2.28 +	NM=arm-linux-nm LD=arm-linux-ld CC=arm-linux-gcc CXX=arm-linux-g++ RANLIB=arm-linux-ranlib AR=arm-linux-ar ./configure --enable-video-qtopia --disable-video-dummy --disable-video-fbcon  --disable-video-dga --disable-arts --disable-esd --disable-alsa --disable-cdrom --disable-video-x11 --disable-nasm --prefix=/opt/Qtopia/sharp/ arm-unknown-linux-gnu
    2.29 +
    2.30 +  One thing to note is that the above configure will include joystick
    2.31 +  support, even though you can't have joysticks on the Zaurus. The
    2.32 +  reason for this is to avoid link / compile / runtime errors with
    2.33 +  applications that have joystick support.
    2.34 +
    2.35 +==============================================================================
    2.36 +III.  Building the Simple DirectMedia Layer test programs:
    2.37 +
    2.38 +  After installing, making sure the correct sdl-config is in your
    2.39 +  path, run configure like this:
    2.40 +
    2.41 +	NM=arm-linux-nm LD=arm-linux-ld CC=arm-linux-gcc CXX=arm-linux-g++ AR=arm-linux-ar ./configure arm-unknown-linux-gnu
    2.42 +
    2.43 +==============================================================================
    2.44 +IV.  Application porting notes
    2.45 +
    2.46 +  One thing I have noticed is that applications sometimes don't exit
    2.47 +  correctly. Their icon remains in the taskbar and they tend to
    2.48 +  relaunch themselves automatically. I believe this problem doesn't
    2.49 +  occur if you exit your application using the exit() method. However,
    2.50 +  if you end main() with 'return 0;' or so, this seems to happen.
    2.51 +
    2.52 +  Also note that when running in landscape mode - i.e requesting a
    2.53 +  window that is HEIGHT pixels wide and WIDTH pixels high, where WIDTH
    2.54 +  and HEIGHT normally is 240 and 320 - the image is blitted so that
    2.55 +  the hardware buttons are on the left side of the display. This might
    2.56 +  not always be desirable but such is the code today.
    2.57 +
    2.58 +
    2.59 +==============================================================================
    2.60 +V.  Enjoy! :)
    2.61 +
    2.62 +  If you have a project you'd like me to know about, or want to ask questions,
    2.63 +  go ahead and join the SDL developer's mailing list by sending e-mail to:
    2.64 +
    2.65 +	sdl-request@libsdl.org
    2.66 +
    2.67 +  and put "subscribe" into the subject of the message. Or alternatively you
    2.68 +  can use the web interface:
    2.69 +
    2.70 +	http://www.libsdl.org/mailman/listinfo/sdl
    2.71 +  
    2.72 +==============================================================================
    2.73 +VI.  What is supported:
    2.74 +
    2.75 +Keyboard (Sharp Zaurus)
    2.76 +Hardware buttons
    2.77 +Stylus input (mouse)
    2.78 +Video. Allows fullscreen both in portrait mode (up to WIDTHxHEIGHT
    2.79 +size window) and in landscape mode (up to HEIGHTxWIDTH). 
    2.80 +
    2.81 +All other SDL functionality works like a normal Linux system (threads,
    2.82 +audio etc).
    2.83 +
    2.84 +-- 
    2.85 +David Hedbor <david@hedbor.org>
    2.86 +http://david.hedbor.org/ 	http://eongames.com/
    2.87 +