Use plain int (instead of char) for field selection_size in struct simplelist_info
[kugel-rb.git] / manual / plugins / sokoban.tex
blob846dc6a17b4ae4ff02208c3d7b33a7b10789da26
1 \subsection{Sokoban}
2 \screenshot{plugins/images/ss-sokoban}{Sokoban}{fig:sokoban}
4 The object of the game is to push boxes into their correct position in a
5 crowded warehouse with a minimal number of pushes and moves. The boxes
6 can only be pushed, never pulled, and only one can be pushed at a time.
8 Sokoban may be used as a viewer for viewing saved solutions and playing
9 external level sets with the \fname{.sok} extension. Level sets should be in
10 the standard Sokoban text format or RLE (Run Length Encoded). For more
11 information about the level format, see
12 \url{http://sokobano.de/wiki/index.php?title=Level_format}
14 \begin{table}
15 \begin{btnmap}{}{}
16 \multicolumn{2}{c}{\textbf{In game}} \\
17 \hline
18 \opt{RECORDER_PAD,ARCHOS_AV300_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD%
19 ,IAUDIO_X5_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD,SANSA_E200_PAD%
20 ,SANSA_FUZE_PAD,SANSA_C200_PAD}
21 {\ButtonUp, \ButtonDown, }%
22 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonMenu, \ButtonPlay, }%
23 \opt{IRIVER_H10_PAD}{\ButtonScrollUp, \ButtonScrollDown, }%
24 \opt{RECORDER_PAD,ARCHOS_AV300_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD%
25 ,IAUDIO_X5_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD,SANSA_E200_PAD%
26 ,SANSA_FUZE_PAD,SANSA_C200_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IRIVER_H10_PAD}
27 {\ButtonLeft, \ButtonRight}
28 \opt{COWON_D2_PAD}
29 {\TouchTopMiddle, \TouchBottomMiddle, \TouchMidLeft, \TouchMidRight}
30 \opt{HAVEREMOTEKEYMAP}{& }
31 & Move the ``sokoban'' up, down, left, or right\\
32 \opt{RECORDER_PAD,ARCHOS_AV300_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}
33 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonMenu}
34 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,GIGABEAT_PAD,MROBE100_PAD,SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonPower}
35 \opt{SANSA_FUZE_PAD}{Long \ButtonHome}
36 \opt{GIGABEAT_S_PAD,COWON_D2_PAD}{\ButtonMenu}
37 \opt{HAVEREMOTEKEYMAP}{&
38 \opt{IRIVER_RC_H100_PAD}{\ButtonRCStop}
40 & Menu \\
41 \nopt{IAUDIO_X5_PAD}{
42 \opt{RECORDER_PAD,ARCHOS_AV300_PAD}{\ButtonFOne}
43 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonLeft}
44 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonDown}
45 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonLeft}
46 \opt{IRIVER_H10_PAD}{\ButtonPlay+\ButtonScrollDown}
47 \opt{GIGABEAT_PAD,SANSA_C200_PAD}{\ButtonVolDown}
48 \opt{MROBE10_PAD}{\ButtonDisplay}
49 \opt{SANSA_E200_PAD,SANSA_FUZE_PAD}{\ButtonSelect+\ButtonDown}
50 \opt{GIGABEAT_S_PAD}{\ButtonPrev}
51 \opt{COWON_D2_PAD}{\ButtonMinus}
52 \opt{HAVEREMOTEKEYMAP}{& }
53 & Back to previous level \\
55 \nopt{IPOD_4G_PAD,IPOD_3G_PAD}{
56 \opt{RECORDER_PAD,ARCHOS_AV300_PAD}{\ButtonFTwo}
57 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonUp}
58 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn}
59 \opt{IAUDIO_X5_PAD}{\ButtonRec}
60 \opt{IRIVER_H10_PAD}{\ButtonPlay+\ButtonRight}
61 \opt{GIGABEAT_PAD,MROBE100_PAD}{\ButtonMenu}
62 \opt{SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD}{\ButtonSelect+\ButtonRight}
63 \opt{GIGABEAT_S_PAD}{\ButtonPlay}
64 \opt{COWON_D2_PAD}{\TouchTopRight}
65 \opt{HAVEREMOTEKEYMAP}{& }
66 & Restart level \\
68 \nopt{IAUDIO_X5_PAD}{
69 \opt{RECORDER_PAD,ARCHOS_AV300_PAD}{\ButtonFThree}
70 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonRight}
71 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonUp}
72 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonRight}
73 \opt{IRIVER_H10_PAD}{\ButtonPlay+\ButtonScrollUp}
74 \opt{GIGABEAT_PAD,SANSA_C200_PAD}{\ButtonVolUp}
75 \opt{GIGABEAT_S_PAD}{\ButtonNext}
76 \opt{MROBE100_PAD}{\ButtonPlay}
77 \opt{SANSA_E200_PAD,SANSA_FUZE_PAD}{\ButtonSelect+\ButtonUp}
78 \opt{COWON_D2_PAD}{\ButtonPlus}
79 \opt{HAVEREMOTEKEYMAP}{& }
80 & Go to next level \\
82 \opt{RECORDER_PAD,ARCHOS_AV300_PAD}{\ButtonOn}
83 \opt{ONDIO_PAD}{\ButtonMenu}
84 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonRec}
85 \opt{IPOD_4G_PAD,IPOD_3G_PAD,IAUDIO_X5_PAD,GIGABEAT_PAD,MROBE100_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD}{\ButtonSelect}
86 \opt{IRIVER_H10_PAD}{\ButtonRew}
87 \opt{GIGABEAT_S_PAD}{\ButtonVolUp}
88 \opt{COWON_D2_PAD}{\TouchTopRight}
89 \opt{HAVEREMOTEKEYMAP}{& }
90 & Undo last movement \\
92 \opt{RECORDER_PAD,ARCHOS_AV300_PAD,IAUDIO_X5_PAD}{\ButtonPlay}
93 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonDown}
94 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonMode}
95 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonPlay}
96 \opt{IRIVER_H10_PAD}{\ButtonFF}
97 \opt{GIGABEAT_PAD}{\ButtonA}
98 \opt{GIGABEAT_S_PAD}{\ButtonVolDown}
99 \opt{MROBE100_PAD}{\ButtonDisplay}
100 \opt{SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonRec}
101 \opt{SANSA_FUZE_PAD}{\ButtonSelect+\ButtonLeft}
102 \opt{COWON_D2_PAD}{\TouchBottomLeft}
103 \opt{HAVEREMOTEKEYMAP}{& }
104 & Redo previously undone move \\
105 \hline
106 \multicolumn{2}{c}{\textbf{Solution playback}} \\
107 \hline
108 \opt{RECORDER_PAD,ARCHOS_AV300_PAD,IAUDIO_X5_PAD,IRIVER_H10_PAD}{\ButtonPlay}
109 \opt{ONDIO_PAD}{\ButtonMenu}
110 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn}
111 \opt{IPOD_4G_PAD,IPOD_3G_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD%
112 ,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD}{\ButtonSelect}
113 \opt{COWON_D2_PAD}{\TouchCenter}
114 \opt{HAVEREMOTEKEYMAP}{& }
115 & Pause/resume \\
116 \opt{RECORDER_PAD,ARCHOS_AV300_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD%
117 ,IAUDIO_X5_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD,SANSA_E200_PAD%
118 ,SANSA_FUZE_PAD,SANSA_C200_PAD}
119 {\ButtonUp/\ButtonDown}
120 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonMenu/\ButtonPlay}
121 \opt{IRIVER_H10_PAD}{\ButtonScrollUp/\ButtonScrollDown}
122 \opt{COWON_D2_PAD}{\TouchTopMiddle/\TouchBottomMiddle}
123 \opt{HAVEREMOTEKEYMAP}{& }
124 & Increase/decrease playback speed \\
125 \opt{RECORDER_PAD,ARCHOS_AV300_PAD,IAUDIO_X5_PAD,IRIVER_H10_PAD,ONDIO_PAD%
126 ,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD,IPOD_3G_PAD,GIGABEAT_PAD%
127 ,GIGABEAT_S_PAD,MROBE100_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_C200_PAD}
128 {\ButtonLeft/\ButtonRight}
129 \opt{COWON_D2_PAD}{\TouchMidLeft/\TouchMidRight}
130 \opt{HAVEREMOTEKEYMAP}{& }
131 & Go backward/forward (while paused) \\
132 \opt{RECORDER_PAD,ARCHOS_AV300_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}
133 \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonMenu}
134 \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,GIGABEAT_PAD,MROBE100_PAD,SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonPower}
135 \opt{SANSA_FUZE_PAD}{Long \ButtonHome}
136 \opt{GIGABEAT_S_PAD,COWON_D2_PAD}{\ButtonMenu}
137 \opt{HAVEREMOTEKEYMAP}{& }
138 & Quit \\
139 \end{btnmap}
140 \end{table}
142 Some places where can you can find level sets:
143 \begin{itemize}
144 \item \url{http://www.sourcecode.se/sokoban/levels.php}
145 \item \url{http://sokobano.de/en/levels.php}
146 \end{itemize}
147 Note that some level sets may contain levels that are too large for this
148 version of Sokoban and are unplayable as a result.