1Troubleshooting
2===============
3
4Graphics
5--------
6
7Q: Under GNU/Linux on 16:9 screens, the image is streched horizontally
8
9A: You can configure your screen scaling mode; with xrandr in a console:
10
11     xrandr  # check your screenname, e.g. LVDS-1
12     xrandr --output LVDS-1 --set "scaling mode" "Full aspect"
13
14
15Sound
16-----
17
18Q: I want FreeDink to use my MIDI hardware or fluidsynth setup, but it
19   uses TiMidity or default Fluidsynth instead.
20
21A: SDL_mixer (the MIDI component that FreeDink uses) can use both
22   hardware and software sequencer. If '/etc/timidity/timidity.cfg' is
23   present, it will use that first. You can remove that file if you
24   want to use '/dev/sequencer' directly :)
25
26   Under Debian, you can disable fluidsynth by using a wrong soundfont
27   path:
28     SDL_FORCE_SOUNDFONTS=1 freedink
29
30   (you may also try fiddling with SDL_SOUNDFONTS=<paths>)
31
32   You can also see above that there are some issues if
33   '/dev/sequencer' is present but not functionnal, so it's best we
34   use TiMidity by default for common Dinkers, and just let you remove
35   '/etc/timidity/timidity.cfg' if you know better ;)
36
37
38Q: FreeDink is eating all the memory
39
40A: Try running FreeDink with fluidsynth *disabled* (see previous entry):
41
42     SDL_FORCE_SOUNDFONTS=1 SDL_SOUNDFONTS= freedink
43
44   Cf. https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=748090
45
46
47Q: Under GNU/Linux, FreeDink freezes when trying to play a sound or
48   music.
49
50A: SDL_mixer (the component that provides the sound) is known to
51   freeze when:
52   * /dev/sequencer is present and
53   * /etc/timidity/timidity.cfg isn't.
54   An easy fix is to install Timidity++ (see BUILD).
55
56   More information at
57   http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369670
58
59   Note that the Debian version of SDL_mixer now attemps to read
60   /etc/timidity/freepats.cfg as well.
61
62
63Joystick
64--------
65
66Q: The mouse cursor is constanatly going up by itself.
67
68A: If you run FreeDink in debug mode (option -d), and you see
69   something like this:
70
71   [info ]     ThinkPad HDAPS joystick emulation
72   [info ]     ThinkPad HDAPS accelerometer data
73   [info ] Picking the first one...
74   [info ] Name: ThinkPad HDAPS joystick emulation
75   [info ] Number of axes: 2
76   [info ] Number of buttons: 0
77   [info ] Number of balls: 0
78   [info ] Number of hats: 0
79
80   This means SDL interprets your laptop's accelerometer as a joystick
81   device. This is nearly guaranteed to cause trouble, see here for
82   more information:
83
84   http://www.thinkwiki.org/wiki/HDAPS
85   http://bugs.debian.org/690483
86
87   You can also disable the joystick (option --nojoy).
88