summaryrefslogtreecommitdiffstats
path: root/manual
diff options
context:
space:
mode:
authorSebastian Leonhardt <sebastian.leonhardt@web.de>2016-04-13 00:14:02 +0200
committerGerrit Rockbox <gerrit@rockbox.org>2016-04-15 01:15:30 +0200
commit6548dc294357f4f13a17bf34206038a3a93f1ff7 (patch)
tree01db3583288e51d135901b2f92614fb32190d9a8 /manual
parent8a0360dd1e25a83186ec1aad1cecaad915de1ea6 (diff)
downloadrockbox-6548dc294357f4f13a17bf34206038a3a93f1ff7.tar.gz
rockbox-6548dc294357f4f13a17bf34206038a3a93f1ff7.tar.bz2
rockbox-6548dc294357f4f13a17bf34206038a3a93f1ff7.zip
Manual: Add missing plugins
The text is usually only a short description taken from the wiki and don't contain screenshots or keymaps, but should be better than nothing. :) Added manual entries: - Boomshine - Dict - FFT - main_menu_config - Matrix - Maze (including keymap) - PDbox - Superdom Additional changes/fixes: - fix "Clix" alphabetical order - add Frotz & ZXBox to games preamble Change-Id: I169870420cbac8123695747ccfcbaaf3478c11cc
Diffstat (limited to 'manual')
-rw-r--r--manual/advanced_topics/main.tex5
-rw-r--r--manual/plugins/boomshine.tex5
-rw-r--r--manual/plugins/dict.tex23
-rw-r--r--manual/plugins/fft.tex4
-rw-r--r--manual/plugins/frotz.tex2
-rw-r--r--manual/plugins/main.tex28
-rw-r--r--manual/plugins/main_menu_config.tex17
-rw-r--r--manual/plugins/matrix.tex4
-rw-r--r--manual/plugins/maze.tex39
-rw-r--r--manual/plugins/pdbox.tex11
-rw-r--r--manual/plugins/superdom.tex53
11 files changed, 184 insertions, 7 deletions
diff --git a/manual/advanced_topics/main.tex b/manual/advanced_topics/main.tex
index ba51422e17..9ddf680106 100644
--- a/manual/advanced_topics/main.tex
+++ b/manual/advanced_topics/main.tex
@@ -32,8 +32,9 @@ for changing the settings (the latter will be added automatically).
To reset the menu items to the default, use \config{root~menu~order:-} (i.e.
use a hyphen instead of ``items'').
-This configuration entry can only be created and edited with a text editor. It is
-not possible to change this setting via the settings menu.
+This configuration entry can only be created and edited with a text editor or
+the Main Menu Config Plugin (see \reference{ref:main_menu_config}).
+It is not possible to change this setting via the settings menu.
\opt{lcd_bitmap}{
\subsection{\label{ref:GettingExtras}Getting Extras}
diff --git a/manual/plugins/boomshine.tex b/manual/plugins/boomshine.tex
new file mode 100644
index 0000000000..d3a3d8504b
--- /dev/null
+++ b/manual/plugins/boomshine.tex
@@ -0,0 +1,5 @@
+\subsection{Boomshine}
+
+This is a game coded in Lua that's a clone of \url{http://www.yvoschaap.com/chainrxn/}.
+It is a rather basic game, but probably a good way to show off some of Lua's features
+in Rockbox.
diff --git a/manual/plugins/dict.tex b/manual/plugins/dict.tex
new file mode 100644
index 0000000000..95ea274a9f
--- /dev/null
+++ b/manual/plugins/dict.tex
@@ -0,0 +1,23 @@
+\subsection{Dict}
+
+\subsubsection{Prerequisites for using the plugin}
+To use the plugin, firstly you need to have the dictionary files which contain
+the words (index) and their description -- \fname{dict.index} and
+\fname{dict.desc}, respectively -- on \fname{/.rockbox/rocks/apps/} folder.
+
+The dictionary files can be created by yourself, or you can get them crafted
+from the web. More information can be found at \wikilink{PluginDict}.
+
+\subsubsection{Using the plugin}
+Now that you already have the two necessary files in place, you can launch the
+dict plugin (under Applications on the Browse plugins menu). The first thing
+you will see is the text input screen.
+
+Type part of a word (or the whole word) or anything the dict files have a
+definition to and accept the text input. The plugin will search for matching
+entries on the \fname{dict.index} file and display according description/meaning
+contained in the \fname{dict.desc} file.
+
+If no matches are found on the dictionary, a ``Not found'' message will be
+displayed and the plugin will exit. You can do another search by relaunching
+the plugin.
diff --git a/manual/plugins/fft.tex b/manual/plugins/fft.tex
new file mode 100644
index 0000000000..69cbbfd8df
--- /dev/null
+++ b/manual/plugins/fft.tex
@@ -0,0 +1,4 @@
+% $Id$ %
+\subsection{FFT}
+This plugin is a basic frequency analyzer with 3 different frequency-amplitude
+plots (lines, bars, and spectrogram).
diff --git a/manual/plugins/frotz.tex b/manual/plugins/frotz.tex
index 4e7882d6be..b9eb4f3ec2 100644
--- a/manual/plugins/frotz.tex
+++ b/manual/plugins/frotz.tex
@@ -1,5 +1,5 @@
% $Id$ %
-\subsection{Frotz}
+\subsection{\label{ref:Frotz}Frotz}
Frotz is a Z-Machine interpreter for playing Infocom's interactive fiction
games, and newer games using the same format. To start a game open a
\fname{.z1 - .z8} file in the \setting{File Browser}. Most modern games are
diff --git a/manual/plugins/main.tex b/manual/plugins/main.tex
index 4143fd6b63..e5f5deb140 100644
--- a/manual/plugins/main.tex
+++ b/manual/plugins/main.tex
@@ -19,24 +19,28 @@ text files%
\section{Games}
\opt{lcd_bitmap}
- {See also the Chip{}-8 emulator in \reference{ref:Chip8emulator}
+ {See also the Chip{}-8 emulator in \reference{ref:Chip8emulator},
+ Frotz in \reference{ref:Frotz},
\opt{archosrecorder,archosfmrecorder,iriverh100,iaudiom5,lcd_color}
- {and Rockboy in \reference{ref:Rockboy}}.}
+ {Rockboy in \reference{ref:Rockboy}}
+ and ZXBox in \reference{ref:ZXBox}.}
\opt{lcd_bitmap}{\input{plugins/2048.tex}}
\opt{lcd_bitmap}{\input{plugins/blackjack.tex}}
+\opt{large_plugin_buffer}{\input{plugins/boomshine.tex}}
+
\opt{lcd_bitmap}{\input{plugins/brickmania.tex}}
\opt{lcd_bitmap}{\input{plugins/bubbles.tex}}
\opt{lcd_bitmap}{\input{plugins/chessbox.tex}}
-\opt{lcd_color}{\input{plugins/clix.tex}}
-
\opt{lcd_bitmap}{\input{plugins/chopper.tex}}
+\opt{lcd_color}{\input{plugins/clix.tex}}
+
\opt{lcd_color}{\input{plugins/codebuster.tex}}
{\input{plugins/dice.tex}}
@@ -54,6 +58,8 @@ text files%
\opt{lcd_bitmap}{\input{plugins/jewels.tex}}
+\opt{lcd_bitmap}{\input{plugins/maze.tex}}
+
\opt{lcd_bitmap}{\input{plugins/mazezam.tex}}
\opt{lcd_bitmap}{\input{plugins/minesweeper.tex}}
@@ -90,6 +96,9 @@ text files%
\opt{lcd_bitmap}{\input{plugins/sudoku.tex}}
+\opt{lcd_non-mono}{\nopt{iriverh10_5gb,ipodmini1g,c200,c200v2,mpiohd200,clipzip,samsungyh820}{
+ \input{plugins/superdom.tex}}}
+
\opt{lcd_bitmap}{\input{plugins/wormlet.tex}}
\opt{lcd_bitmap}{\input{plugins/xobox.tex}}
@@ -106,12 +115,16 @@ text files%
\opt{lcd_bitmap}{\input{plugins/demystify.tex}}
+\opt{swcodec}{\input{plugins/fft.tex}}
+
\opt{lcd_bitmap}{\input{plugins/fire.tex}}
\opt{lcd_bitmap}{\input{plugins/fractals.tex}}
{\input{plugins/logo.tex}}
+\opt{lcd_bitmap}{\input{plugins/matrix.tex}}
+
{\input{plugins/mosaic.tex}}
\opt{lcd_bitmap}{\input{plugins/oscilloscope.tex}}
@@ -193,6 +206,9 @@ option from the \setting{Context Menu} (see \reference{ref:Contextmenu}).}
\opt{swcodec}{\input{plugins/mp3_encoder.tex}}
+\opt{iriverh300,iriverh100,SANSA_FUZE_PAD,SANSA_E200_PAD,IPOD_4G_PAD,IPOD_3G_PAD%
+ ,IPOD_1G2G_PAD,SAMSUNG_YPR0_PAD}{
+ \input{plugins/pdbox.tex}}
\opt{archosrecorder,archosfmrecorder,ondio}{\input{plugins/rockbox_flash.tex}}
@@ -236,6 +252,8 @@ option from the \setting{Context Menu} (see \reference{ref:Contextmenu}).}
\opt{rtc}{\input{plugins/clock.tex}}
+{\input{plugins/dict.tex}}
+
{\input{plugins/disktidy.tex}}
\opt{archosplayer}{\input{plugins/euro_converter.tex}}
@@ -248,6 +266,8 @@ option from the \setting{Context Menu} (see \reference{ref:Contextmenu}).}
\opt{lcd_bitmap}{\input{plugins/lrcplayer.tex}}
+{\input{plugins/main_menu_config.tex}}
+
{\input{plugins/md5sum.tex}}
{\input{plugins/metronome.tex}}
diff --git a/manual/plugins/main_menu_config.tex b/manual/plugins/main_menu_config.tex
new file mode 100644
index 0000000000..b21c0020c6
--- /dev/null
+++ b/manual/plugins/main_menu_config.tex
@@ -0,0 +1,17 @@
+\subsection{Main Menu Configuration}
+{\label{ref:main_menu_config}}
+
+This plugin helps you customizing the main menu (i.e. reorder or hide menu
+items). It changes the appropriate configuration file as described in
+\reference{ref:CustomisingTheMainMenu}.
+
+When you start the plugin, the available main menu items will be displayed.
+By pressing \ActionStdOk{} you open a menu with the following options:
+\begin{description}
+\item[Toggle Item] Hide the selected menu item or make it visible again
+\item[Move Item Up] Swap the selected menu item with the previous one
+\item[Move Item down] Swap the selected menu item with the next one
+\item[Load Default Configuration] Discards all customization
+\item[Exit] Save your changes to the configuration file and exit the plugin
+\end{description}
+You can leave the plugin without saving by pressing \ActionStdCancel{}.
diff --git a/manual/plugins/matrix.tex b/manual/plugins/matrix.tex
new file mode 100644
index 0000000000..8f5622b626
--- /dev/null
+++ b/manual/plugins/matrix.tex
@@ -0,0 +1,4 @@
+\subsection{Matrix}
+
+This plugin is a visual demo resembling the scrolling code from ``The Matrix''
+(\url{https://en.wikipedia.org/wiki/The_Matrix}).
diff --git a/manual/plugins/maze.tex b/manual/plugins/maze.tex
new file mode 100644
index 0000000000..186a650b4d
--- /dev/null
+++ b/manual/plugins/maze.tex
@@ -0,0 +1,39 @@
+\subsection{Maze}
+
+This is a simple maze generator that creates perfect mazes that have only
+one solution.
+
+\begin{btnmap}
+ \opt{IPOD_3G_PAD}{\ButtonScrollBack/\ButtonScrollFwd/\ButtonLeft/\ButtonRight}
+ \nopt{IPOD_3G_PAD}{\PluginUp/\PluginDown/\PluginLeft/\PluginRight}
+ &
+ \opt{HAVEREMOTEKEYMAP}{
+ \PluginRCUp, \PluginRCDown, \PluginRCLeft, \PluginRCRight
+ &}
+ Navigate maze
+ \\
+
+ \opt{IPOD_3G_PAD}{\ButtonMenu}
+ \nopt{IPOD_3G_PAD}{\PluginCancel}
+ &
+ \opt{HAVEREMOTEKEYMAP}{\PluginRCCancel
+ &}
+ Exit plugin
+ \\
+
+ \opt{IPOD_3G_PAD}{Long \ButtonSelect}
+ \nopt{IPOD_3G_PAD}{\PluginSelectRepeat}
+ &
+ \opt{HAVEREMOTEKEYMAP}{\PluginRCSelectRepeat
+ &}
+ New Maze
+ \\
+
+ \opt{IPOD_3G_PAD}{\ButtonSelect}
+ \nopt{IPOD_3G_PAD}{\PluginSelect}
+ &
+ \opt{HAVEREMOTEKEYMAP}{\PluginRCSelect
+ &}
+ Display solution (toggle)
+ \\
+\end{btnmap}
diff --git a/manual/plugins/pdbox.tex b/manual/plugins/pdbox.tex
new file mode 100644
index 0000000000..8301ea2c04
--- /dev/null
+++ b/manual/plugins/pdbox.tex
@@ -0,0 +1,11 @@
+\subsection{PDBox}
+
+PDBox is a Pure Data audio environment with small-size GUI. Those who do not know
+what Pure Data is are advised to look at the book \href{http://aspress.co.uk/ds/}
+{``Designing Sound''}, both at the abridged text and at the sample chapters.
+Another good Pure Data tutorial can be found at \url{http://www.pd-tutorial.com/}.
+
+\subsubsection{Prerequisites for using the plugin}
+To test the abilities of PDBox get the file
+\href{http://www.rockbox.org/wiki/pub/Main/PureDataOnRockbox/PureData.zip}
+{\fname{PureData.zip}}. See \wikilink{PluginPdbox} for more information.
diff --git a/manual/plugins/superdom.tex b/manual/plugins/superdom.tex
new file mode 100644
index 0000000000..59ebffa0b4
--- /dev/null
+++ b/manual/plugins/superdom.tex
@@ -0,0 +1,53 @@
+\subsection{Superdom}
+
+Superdom is a turn based strategy game, where the aim is to defeat the computer
+player by overpowering them using your army.
+
+When the game starts the player is given roughly 50% of the tiles on the map,
+two farms, and two factories. To overpower the enemy, you must place resources
+in adjacent tiles (diagonals do not count), such that your strength is greater
+than the computers, then attack the square.
+
+Each ``year'' is broken up into three phases: purchasing, movement, and war.
+During the purchasing phase you are allocated money and food, may purchase
+units/buildings, and may access the bank.
+
+During the movement phase you can move your units only to adjacent squares
+(except planes, which may move anywhere), at a cost of 1 move per unit you move.
+(Men are considered to be one unit, no matter how many you move). You can change
+the number of moves you receive by default in the settings, and you may purchase
+additional moves for \$100 each. You may also launch nuclear weapons if you have
+purchased any.
+
+During the war phase you can attack the enemy. This is where the strengths come
+into play. Each tile has its own strength for both the computer, and the human
+player. If you attack a square owned by the computer player where your strength
+is greater than the computer's, you will win the tile - and take control of any
+building that were on it. If the strengths are equal, a victor is chosen at
+random.
+
+The bank (in the purchasing phase) is a place where you can store your money
+and earn interest (usually about 10% p.a.), however, while the money is in the
+bank, it is not accessible until the next purchasing phase.
+
+\subsubsection{Notes on food}
+Each year you are allocated an amount of food based on the number of farms you
+control. Food is used to feed your men, but if you do not have enough food to
+feed your population of men, some will die of starvation.
+
+\subsubsection{Summary of units}
+\begin{table}
+ \begin{rbtabular}{\textwidth}{lccX}%
+ {\textbf{Unit} & \textbf{Cost} & \textbf{Individual strength}%
+ & \textbf{Special abilities}}{}{}
+ Men & \$1 each & 1.33 per 100 & No square population limit, however %
+ require 1 food each per year\\
+ Tanks & \$300 & 3 & None\\
+ Planes & \$600 & 4 & Can move to any human controlled point on the map\\
+ Farms & \$1150 & 3 & Generates additional food at start of year\\
+ Factories & \$1300 & 3 & Generates additional food at start of year\\
+ Nukes & \$2000 & 2 & During the movement phase you may lauch a nuke %
+ to destroy all units on a given tile\\
+ \end{rbtabular}
+\end{table}
+Also note that the colour of the adjacent tiles also count towards your strength.