README.Qtopia
changeset 386 2c5d4c22a2ac
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/README.Qtopia	Sat Jun 01 18:43:51 2002 +0000
     1.3 @@ -0,0 +1,84 @@
     1.4 +
     1.5 +==============================================================================
     1.6 +Using the Simple DirectMedia Layer with Qtopia/OPIE
     1.7 +==============================================================================
     1.8 +
     1.9 +==============================================================================
    1.10 +I.  Setting up the Qtopia development environment.
    1.11 +
    1.12 +  This document will not explain how to setup the Qtopia development
    1.13 +  environment. That is outside the scope of the document. You can read
    1.14 +  more on this subject in this excellent howto:
    1.15 +
    1.16 +	http://www.zauruszone.com/howtos/linux_compiler_setup_howto.html
    1.17 +
    1.18 +==============================================================================
    1.19 +II.  Building the Simple DirectMedia Layer libraries using the arm
    1.20 +     cross-compiler
    1.21 +
    1.22 +  This is somewhat tricky since the name of the compiler binaries
    1.23 +  differ from the standard. Also you should disable features not
    1.24 +  needed. The command below works for me. Note that it's all one
    1.25 +  line. You can also set the NM, LD etc environment variables
    1.26 +  separately.
    1.27 +
    1.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
    1.29 +
    1.30 +  One thing to note is that the above configure will include joystick
    1.31 +  support, even though you can't have joysticks on the Zaurus. The
    1.32 +  reason for this is to avoid link / compile / runtime errors with
    1.33 +  applications that have joystick support.
    1.34 +
    1.35 +==============================================================================
    1.36 +III.  Building the Simple DirectMedia Layer test programs:
    1.37 +
    1.38 +  After installing, making sure the correct sdl-config is in your
    1.39 +  path, run configure like this:
    1.40 +
    1.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
    1.42 +
    1.43 +==============================================================================
    1.44 +IV.  Application porting notes
    1.45 +
    1.46 +  One thing I have noticed is that applications sometimes don't exit
    1.47 +  correctly. Their icon remains in the taskbar and they tend to
    1.48 +  relaunch themselves automatically. I believe this problem doesn't
    1.49 +  occur if you exit your application using the exit() method. However,
    1.50 +  if you end main() with 'return 0;' or so, this seems to happen.
    1.51 +
    1.52 +  Also note that when running in landscape mode - i.e requesting a
    1.53 +  window that is HEIGHT pixels wide and WIDTH pixels high, where WIDTH
    1.54 +  and HEIGHT normally is 240 and 320 - the image is blitted so that
    1.55 +  the hardware buttons are on the left side of the display. This might
    1.56 +  not always be desirable but such is the code today.
    1.57 +
    1.58 +
    1.59 +==============================================================================
    1.60 +V.  Enjoy! :)
    1.61 +
    1.62 +  If you have a project you'd like me to know about, or want to ask questions,
    1.63 +  go ahead and join the SDL developer's mailing list by sending e-mail to:
    1.64 +
    1.65 +	sdl-request@libsdl.org
    1.66 +
    1.67 +  and put "subscribe" into the subject of the message. Or alternatively you
    1.68 +  can use the web interface:
    1.69 +
    1.70 +	http://www.libsdl.org/mailman/listinfo/sdl
    1.71 +  
    1.72 +==============================================================================
    1.73 +VI.  What is supported:
    1.74 +
    1.75 +Keyboard (Sharp Zaurus)
    1.76 +Hardware buttons
    1.77 +Stylus input (mouse)
    1.78 +Video. Allows fullscreen both in portrait mode (up to WIDTHxHEIGHT
    1.79 +size window) and in landscape mode (up to HEIGHTxWIDTH). 
    1.80 +
    1.81 +All other SDL functionality works like a normal Linux system (threads,
    1.82 +audio etc).
    1.83 +
    1.84 +-- 
    1.85 +David Hedbor <david@hedbor.org>
    1.86 +http://david.hedbor.org/ 	http://eongames.com/
    1.87 +