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