manual/plugins/rockboy.tex

   1 \subsection{\label{ref:Rockboy}Rockboy}
   2 \screenshot{plugins/images/ss-rockboy}{Rockboy}{img:rockboy}
   3 Rockboy is a Nintendo Game Boy and Game Boy Color emulator for Rockbox based on
   4 the gnuboy emulator. To start a game, open a ROM file saved as \fname{.gb} or
   5 \fname{.gbc} in the file browser.\\
   6
   7 \opt{ipod}{
   8     Within Rockboy the wheel is used as a touchpad. It is split into 8 sections
   9      that when tapped correspond to 8 buttons as detailed in the table below.
  10 }
  11
  12 \subsubsection{Default keys}
  13 \begin{table}
  14     \begin{btnmap}{}{}
  15     \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD%
  16         ,SANSA_C200_PAD,GIGABEAT_PAD,GIGABEAT_S_PAD}{\ButtonUp{} / \ButtonDown}
  17     \opt{IPOD_4G_PAD}{Tap \ButtonPlay{} / \ButtonMenu}
  18     \opt{IRIVER_H10_PAD}{\ButtonScrollUp{} / \ButtonScrollDown}
  19     / \ButtonLeft{} / \ButtonRight
  20        \opt{HAVEREMOTEKEYMAP}{& }
  21     & Direction keys\\
  22     %
  23     \opt{RECORDER_PAD}{\ButtonFOne}
  24     \opt{IRIVER_H100_PAD}{\ButtonOn}
  25     \opt{IRIVER_H300_PAD}{\ButtonRec}
  26     \opt{IPOD_4G_PAD}{Tap \btnfnt{Top-Right}}
  27     \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD}{\ButtonPlay}
  28     \opt{SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonSelect}
  29     \opt{GIGABEAT_PAD,GIGABEAT_S_PAD}{\ButtonVolUp}
  30        \opt{HAVEREMOTEKEYMAP}{& }
  31     & A button\\
  32     %
  33     \opt{RECORDER_PAD}{\ButtonFTwo}
  34     \opt{IRIVER_H100_PAD}{\ButtonOff}
  35     \opt{IRIVER_H300_PAD}{\ButtonMode}
  36     \opt{IPOD_4G_PAD}{Tap \btnfnt{Top-Left}}
  37     \opt{IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_C200_PAD}{\ButtonRec}
  38     \opt{IRIVER_H10_PAD}{\ButtonFF}
  39     \opt{GIGABEAT_PAD,GIGABEAT_S_PAD}{\ButtonVolDown}
  40        \opt{HAVEREMOTEKEYMAP}{& }
  41     & B button\\
  42     %
  43     \opt{RECORDER_PAD}{\ButtonFThree}
  44     \opt{IRIVER_H100_PAD}{\ButtonRec}
  45     \opt{IRIVER_H300_PAD}{\ButtonOn}
  46     \opt{IPOD_4G_PAD}{Tap \btnfnt{Bottom-Right} /~Press \ButtonSelect}
  47     \opt{IAUDIO_X5_PAD}{\ButtonSelect}
  48     \opt{SANSA_E200_PAD}{\ButtonScrollBack}
  49     \opt{SANSA_C200_PAD}{\ButtonVolDown}
  50     \opt{IRIVER_H10_PAD}{\ButtonRew}
  51     \opt{GIGABEAT_PAD}{\ButtonA}
  52     \opt{GIGABEAT_S_PAD}{\ButtonPlay}
  53        \opt{HAVEREMOTEKEYMAP}{& }
  54     & Start\\
  55     %
  56     \nopt{IAUDIO_X5_PAD,IRIVER_H10_PAD}{
  57         \opt{RECORDER_PAD}{\ButtonPlay}
  58         \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonSelect}
  59         \opt{IPOD_4G_PAD}{Tap \btnfnt{Bottom-Left}}
  60         \opt{SANSA_E200_PAD}{\ButtonScrollFwd}
  61         \opt{SANSA_C200_PAD}{\ButtonVolUp}
  62         \opt{GIGABEAT_PAD,GIGABEAT_S_PAD}{\ButtonSelect}
  63                \opt{HAVEREMOTEKEYMAP}{& }
  64         & Select\\
  65         %
  66     }
  67     \opt{RECORDER_PAD,IRIVER_H100_PAD,m5}{
  68         \opt{RECORDER_PAD}{\ButtonOn}
  69         \opt{IRIVER_H100_PAD,IAUDIO_X5_PAD}{\ButtonHold{} switch}
  70               \opt{HAVEREMOTEKEYMAP}{& }
  71         & Cycle display scaling modes\\
  72     %
  73     }
  74     \opt{RECORDER_PAD,IRIVER_H300_PAD}{\ButtonOff}
  75     \opt{IRIVER_H100_PAD}{\ButtonMode}
  76     \opt{IPOD_4G_PAD}{\ButtonHold{} switch}
  77     \opt{IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_C200_PAD,IRIVER_H10_PAD}{\ButtonPower}
  78     \opt{GIGABEAT_PAD,GIGABEAT_S_PAD}{\ButtonMenu}
  79        \opt{HAVEREMOTEKEYMAP}{& }
  80     & Open Rockboy menu\\
  81     \end{btnmap}
  82 \end{table}
  83
  84 \subsubsection{Rockboy menu}
  85 \begin{description}
  86 \item[Load Game\ldots] Loads a previously saved game.
  87 \item[Save Game\ldots] Saves your current state.
  88 \item[Options\ldots]
  89     \begin{description}
  90     \item[Max Frameskip.]
  91     Change frameskip setting to improve speed.
  92     \item[Sound.]
  93     Toggle sound on or off.
  94     \item[Stats.]
  95     Toggle showing fps and current frameskip.
  96     \item[Set Keys (BUGGY)]
  97     Select this option to set a new keymapping.
  98     \opt{lcd_color}{
  99         \item[Screen Size.]
 100         Chose whether the original aspect ratio should be kept when scaling
 101         the picture to the screen%
 102         % targets with bigger displays than the original gameboy
 103         \opt{gigabeat,h300,ipodcolor,ipodvideo,e200}{
 104             or whether it should be displayed unscaled%
 105         }.
 106         \item[Screen Rotate.]
 107         Rotate the displayed picture by 90 degrees.
 108         \item[Set Palette.]
 109         Pick one of a few predefined colour palettes.
 110     }
 111     \end{description}
 112 \item[Quit RockBoy.] Quits the Rockboy plugin.
 113 \end{description}