README.Qtopia
author Sam Lantinga <slouken@libsdl.org>
Thu, 13 Apr 2006 13:25:21 +0000
changeset 1623 09375aed0208
parent 386 2c5d4c22a2ac
permissions -rw-r--r--
Added a delay so the warning message isn't accidentally missed.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
386
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     1
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     2
==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     3
Using the Simple DirectMedia Layer with Qtopia/OPIE
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     4
==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     5
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     6
==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     7
I.  Setting up the Qtopia development environment.
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     8
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
     9
  This document will not explain how to setup the Qtopia development
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    10
  environment. That is outside the scope of the document. You can read
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    11
  more on this subject in this excellent howto:
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    12
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    13
	http://www.zauruszone.com/howtos/linux_compiler_setup_howto.html
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    14
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    15
==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    16
II.  Building the Simple DirectMedia Layer libraries using the arm
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    17
     cross-compiler
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    18
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    19
  This is somewhat tricky since the name of the compiler binaries
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    20
  differ from the standard. Also you should disable features not
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    21
  needed. The command below works for me. Note that it's all one
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    22
  line. You can also set the NM, LD etc environment variables
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    23
  separately.
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    24
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    25
	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
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    26
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    27
  One thing to note is that the above configure will include joystick
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    28
  support, even though you can't have joysticks on the Zaurus. The
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    29
  reason for this is to avoid link / compile / runtime errors with
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    30
  applications that have joystick support.
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    31
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    32
==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    33
III.  Building the Simple DirectMedia Layer test programs:
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    34
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    35
  After installing, making sure the correct sdl-config is in your
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    36
  path, run configure like this:
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    37
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    38
	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
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    39
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    40
==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    41
IV.  Application porting notes
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    42
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    43
  One thing I have noticed is that applications sometimes don't exit
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    44
  correctly. Their icon remains in the taskbar and they tend to
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    45
  relaunch themselves automatically. I believe this problem doesn't
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    46
  occur if you exit your application using the exit() method. However,
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    47
  if you end main() with 'return 0;' or so, this seems to happen.
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    48
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    49
  Also note that when running in landscape mode - i.e requesting a
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    50
  window that is HEIGHT pixels wide and WIDTH pixels high, where WIDTH
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    51
  and HEIGHT normally is 240 and 320 - the image is blitted so that
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    52
  the hardware buttons are on the left side of the display. This might
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    53
  not always be desirable but such is the code today.
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    54
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    55
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    56
==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    57
V.  Enjoy! :)
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    58
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    59
  If you have a project you'd like me to know about, or want to ask questions,
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    60
  go ahead and join the SDL developer's mailing list by sending e-mail to:
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    61
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    62
	sdl-request@libsdl.org
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    63
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    64
  and put "subscribe" into the subject of the message. Or alternatively you
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    65
  can use the web interface:
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    66
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    67
	http://www.libsdl.org/mailman/listinfo/sdl
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    68
  
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    69
==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    70
VI.  What is supported:
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    71
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    72
Keyboard (Sharp Zaurus)
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    73
Hardware buttons
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    74
Stylus input (mouse)
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    75
Video. Allows fullscreen both in portrait mode (up to WIDTHxHEIGHT
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    76
size window) and in landscape mode (up to HEIGHTxWIDTH). 
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    77
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    78
All other SDL functionality works like a normal Linux system (threads,
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    79
audio etc).
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    80
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    81
-- 
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    82
David Hedbor <david@hedbor.org>
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    83
http://david.hedbor.org/ 	http://eongames.com/
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
    84