~ubuntu-branches/debian/squeeze/stella/squeeze

« back to all changes in this revision

Viewing changes to README-GP2X.txt

  • Committer: Bazaar Package Importer
  • Author(s): Mario Iseli
  • Date: 2006-04-08 18:38:25 UTC
  • mfrom: (1.1.2 upstream) (2.1.1 etch)
  • Revision ID: james.westby@ubuntu.com-20060408183825-vu1jk57rk929derx
* New Maintainer (Closes: #361345)
* New upstream release (Closes: #349725)
* Build-Depend now on libslang2-dev (Closes: #325577)
* Complete rebuild of debian/, upgraded to policy-standards
  3.6.2 and compat-level 5.
* Removed stellarc since stella only reads ~/.stellarc and even
  works without a first config.
* New debian/watch file.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
---------------------------------------
 
2
Stella 2.2:
 
3
Ported to GP2X by Alex Zaballa
 
4
Contact: azaballa@users.sourceforge.net
 
5
Homepage: http://stella.sourceforge.net
 
6
---------------------------------------
 
7
 
 
8
--------
 
9
Changes:
 
10
--------
 
11
>From 2.1-rv3
 
12
Added Rom Browser mode and enabled it by default
 
13
>From 2.1-rv2
 
14
Scroll bug fixed (finally)
 
15
>From 2.1-rv1
 
16
Warlords graphics bug fixed
 
17
>From 2.1
 
18
Joystick fixed
 
19
Phosphor effect enabled
 
20
>From 2.0.1:
 
21
Stopped using the ROM Script (No more ROM limit. 'Single binary' zip
 
22
support available.)
 
23
Opened up the Native GUI for use through Joymouse Emulation
 
24
SOUND!
 
25
Diagonals
 
26
Snapshots
 
27
Some button mapping (but still comfortably familiar)
 
28
 
 
29
-----------
 
30
Known Bugs:
 
31
-----------
 
32
None reported.
 
33
Please report all bugs to me at azaballa@users.sourceforge.net.
 
34
 
 
35
------------------------------
 
36
Known GP2X Performance Issues:
 
37
------------------------------
 
38
Pitfall2 runs slow due to extra hardware emulation. (Steve foresees this
 
39
being fixed in the future.)
 
40
 
 
41
---------------------
 
42
Installation to GP2X:
 
43
---------------------
 
44
Place files stella and stella.gpe into a chosen directory. Upon first run,
 
45
Stella will ask for your ROM directory and snapshot directory. Remember that
 
46
the path to the sd card is '/mnt/sd'.
 
47
 
 
48
-----------
 
49
Navigation:
 
50
-----------
 
51
The joystick moves the mouse cursor in all menus except the ROM Launcher,
 
52
with any button acting as a click. In the ROM Launcher, up/down scrolls through
 
53
the ROM list and left/right selects options across the bottom, with any
 
54
button serving as a click.
 
55
 
 
56
-------------
 
57
GP2X Mapping:
 
58
-------------
 
59
  A      = Snapshot
 
60
  B      = Fire
 
61
  X      = Pause
 
62
  Y      = Settings Menu
 
63
  L      = Console Reset
 
64
  R      = Console Select
 
65
  START  = Launcher Menu
 
66
  SELECT = Command Menu
 
67
 
 
68
Note: Nothing has been taken away by changing this mapping. Save, Change, and
 
69
Load State are all available through the Command Menu (SELECT).
 
70
 
 
71
Caution: Changing video and audio settings could lead to a non-working Stella
 
72
setup. If you do feel the need to change the settings (as we all do) and happen
 
73
to cause a crash or hang, delete the 'stellarc' file and that should clear up
 
74
the problem. If anyone finds any settings that give better performance in
 
75
sound and gameplay, let me know and I might incorporate them into the next
 
76
build. Happy tinkering.
 
77
 
 
78
-------------
 
79
Compile Info:
 
80
-------------
 
81
Since the GP2X branch was so graciously added to Stella, GP2X compilation is
 
82
now built in. If you plan on doing a compile yourself, you need the GP2X devkit
 
83
pro and SDL Open2X libs with zlib support. I recommend theoddbot's Open2X
 
84
libraries which work very nicely for this. Any questions, email me.
 
85
 
 
86
Make sure your path includes your arm-linux compilers:
 
87
export PATH=<your arm-linux compiler path>:$PATH
 
88
 
 
89
This is what my configure line looks like:
 
90
./configure
 
91
  --prefix=<your destination folder>
 
92
  --enable-zlib
 
93
  --disable-cheats
 
94
  --disable-developer
 
95
  --host=gp2x
 
96
  --with-zlib-prefix=<your gp2x zlib path>
 
97
  --with-png-prefix=<your gp2x png path (configure appends '/include')>
 
98
  --with-sdl-prefix=<your sdl config path>
 
99
  --x-libraries=<your X11 libraries path>
 
100
 
 
101
Then:
 
102
make
 
103
 
 
104
Then strip the exec:
 
105
make gp2x-strip
 
106
 
 
107
You should get an exec ~2mb in size. Much better than 7mb right?
 
108
 
 
109
To gather all necessary files into directory './stella/gp2x' for easy
 
110
access, type:
 
111
make gp2x-organize
 
112
 
 
113
Note: /gp2x directory created in the main stella source directory
 
114
(next to configure, Makefile, etc.).
 
115
 
 
116
---------------
 
117
Special Thanks:
 
118
---------------
 
119
... to Steve Anthony for the major improvements in the port and incorporating
 
120
    the GP2X. Not to mention the wealth of information and help... did I
 
121
    mention patience? ;-)
 
122
... to Eckhard Stolberg for making me known to the Stella Team.
 
123
... to the Stella Team for the excellent emulator and the hospitality.
 
124
... to theoddbot for the excellent Open2X toolchain libs.
 
125
... to TelcoLou for his hardwork, playtesting ad infinitum.
 
126
... to the community for all of the interest.