2006-04-17 16:55:14 +00:00
|
|
|
% $Id$ %
|
2006-03-31 11:54:55 +00:00
|
|
|
\chapter{Plugins}\label{ref:plugins}
|
2008-07-14 22:47:40 +00:00
|
|
|
Plugins are programs that Rockbox can load and run. Only one plugin can
|
2006-07-25 20:46:04 +00:00
|
|
|
be loaded at a time. Plugins have exclusive control over the user interface.
|
2008-07-14 22:47:40 +00:00
|
|
|
This means you cannot switch back and forth between a plugin and Rockbox. When
|
|
|
|
|
a plugin is loaded, you need to exit it to return to the Rockbox interface.
|
|
|
|
|
Most plugins will not interfere with music playback but some of them will stop
|
2006-08-15 10:53:14 +00:00
|
|
|
playback while running. Plugins have the file extension \fname{.rock}. Most of
|
2009-08-25 21:51:55 +00:00
|
|
|
them can be started from \setting{Browse Plugins} in the \setting{Main Menu}.\\
|
2006-07-25 20:46:04 +00:00
|
|
|
|
|
|
|
|
Viewer plugins get started automatically by opening an associated file (i.e.
|
Mostly cosmetic changes to some plugin descriptions in the manual: 1) In main.tex - don't mention chip8 games in the Player manual and give the correct path to the viewers directory. 2) Correct wrongly placed 'end' in zxbox.tex and remove link to the wiki as this chapter is based off of that page and there is no additional information on it. 3) Let long lists of button names break so they don't overlap with the next column in the pdf - blackjack, bubbles, demystify, flipit, logo, oscilloscope, pegbox, rockblox1d, rockblox, rockboy, sliding puzzle, snake2, solitaire, sudoku. 4) While at it, break long (code) lines in bubbles.tex. 5) Additionally exclude lines which showed only 'n/a' in the button tables for a specific target - pegbox, sokoban. 6) Use 'fname' to mark a path in disktidy.tex, also simplify the button table. 7) Use 'ButtonHold' in doom.tex.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@18580 a1c6a512-1295-4272-9138-f99709370657
2008-09-23 17:25:32 +00:00
|
|
|
text files%
|
|
|
|
|
\opt{lcd_bitmap}{, chip8 games}%
|
|
|
|
|
), or from the \setting{Open with} option on the \setting{Context Menu}.
|
2006-02-11 01:29:51 +00:00
|
|
|
|
|
|
|
|
\section{Games}
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}
|
2006-08-01 11:57:38 +00:00
|
|
|
{See also the Chip{}-8 emulator in \reference{ref:Chip8emulator}
|
2008-12-07 23:00:15 +00:00
|
|
|
\opt{recorder,recorderv2fm,h100,m5,lcd_color}
|
2006-08-01 11:57:38 +00:00
|
|
|
{and Rockboy in \reference{ref:Rockboy}}.}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/blackjack.tex}}
|
2007-01-16 21:05:15 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/brickmania.tex}}
|
2006-03-11 16:28:33 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/bubbles.tex}}
|
2006-03-21 20:41:06 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/chessbox.tex}}
|
2006-03-12 12:56:49 +00:00
|
|
|
|
2009-07-08 20:55:53 +00:00
|
|
|
\opt{lcd_color}{\input{plugins/clix.tex}}
|
2009-07-08 17:42:37 +00:00
|
|
|
|
2008-09-08 23:43:29 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/chopper.tex}}
|
|
|
|
|
|
|
|
|
|
{\input{plugins/dice.tex}}
|
|
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{swcodec}{\input{plugins/doom.tex}}
|
2006-04-04 19:12:02 +00:00
|
|
|
|
2006-10-18 13:56:39 +00:00
|
|
|
{\input{plugins/flipit.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2009-02-11 16:03:17 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/goban.tex}}
|
|
|
|
|
|
2009-02-14 07:54:05 +00:00
|
|
|
\opt{lcd_non-mono}{\nopt{h10_5gb,ipodmini,c200}{
|
|
|
|
|
\input{plugins/invadrox.tex}}}
|
|
|
|
|
|
2009-07-08 20:27:21 +00:00
|
|
|
{\input{plugins/jackpot.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/jewels.tex}}
|
2006-03-20 11:27:04 +00:00
|
|
|
|
2008-04-10 23:28:19 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/mazezam.tex}}
|
|
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/minesweeper.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
|
|
|
|
\opt{player}{\input{plugins/nim.tex}}
|
|
|
|
|
|
2008-12-07 23:00:15 +00:00
|
|
|
\opt{h100,m5,lcd_color}{\nopt{c200}{\input{plugins/pacbox.tex}}}
|
2006-03-13 21:36:35 +00:00
|
|
|
|
2008-04-03 22:43:39 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/pegbox.tex}}
|
|
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/pong.tex}}
|
2006-03-12 22:29:15 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/robotfindskitten.tex}}
|
2007-10-05 20:02:32 +00:00
|
|
|
|
2006-10-08 10:06:11 +00:00
|
|
|
{\input{plugins/rockblox.tex}}
|
2006-10-02 19:13:44 +00:00
|
|
|
|
2008-06-30 20:28:42 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/rockblox1d.tex}}
|
|
|
|
|
|
2009-04-03 21:45:38 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/rocklife.tex}}
|
|
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/sliding.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/snake.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/snake2.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/sokoban.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/solitaire.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/spacerocks.tex}}
|
2006-05-31 11:26:25 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/star.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/sudoku.tex}}
|
2006-06-06 15:54:11 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/wormlet.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/xobox.tex}}
|
2006-03-19 18:41:17 +00:00
|
|
|
|
2006-02-11 01:29:51 +00:00
|
|
|
\section{Demos}
|
|
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/bounce.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2006-03-25 18:16:36 +00:00
|
|
|
{\input{plugins/credits.tex}}
|
|
|
|
|
|
2006-05-30 10:28:00 +00:00
|
|
|
{\input{plugins/cube.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/demystify.tex}}
|
2006-03-19 18:41:17 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/fire.tex}}
|
2006-03-16 20:53:09 +00:00
|
|
|
|
|
|
|
|
{\input{plugins/logo.tex}}
|
|
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/mandelbrot.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2006-06-06 15:54:11 +00:00
|
|
|
{\input{plugins/mosaic.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/oscilloscope.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2009-03-22 16:55:24 +00:00
|
|
|
\opt{tagcache}{\opt{lcd_bitmap}{\input{plugins/pictureflow.tex}}}
|
2009-02-16 20:10:01 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/plasma.tex}}
|
2006-03-16 20:53:09 +00:00
|
|
|
|
2006-06-06 15:54:11 +00:00
|
|
|
{\input{plugins/snow.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/starfield.tex}}
|
2006-03-16 20:53:09 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/vumeter.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
|
|
|
|
\section{\label{ref:Viewersplugins}Viewers}
|
|
|
|
|
|
|
|
|
|
Viewers are plugins which are associated with specific file extensions.
|
2009-09-21 10:56:58 +00:00
|
|
|
They cannot be run directly but are started by ``playing'' the associated file.
|
2009-09-21 10:43:22 +00:00
|
|
|
Viewers are stored in the \fname{/.rockbox/rocks/viewers/} directory.
|
|
|
|
|
\par
|
|
|
|
|
\note{
|
|
|
|
|
Some viewer plugins can only be used by selecting the \setting{Open With...}
|
|
|
|
|
option from the \setting{Context Menu} (see \reference{ref:Contextmenu}).}
|
|
|
|
|
\begin{table}
|
|
|
|
|
\begin{rbtabular}{.92\textwidth}{Xlc}%
|
|
|
|
|
{\textbf{Viewer Plugin}& \textbf{Associated filetype(s)} & \textbf{Context Menu only}}%
|
|
|
|
|
{}{}
|
|
|
|
|
Shortcuts & \fname{.link} & \\
|
|
|
|
|
Chip-8 Emulator & \fname{.ch8} & \\
|
|
|
|
|
JPEG Viewer & \fname{.jpg, .jpeg} & \\
|
|
|
|
|
Lua scripting language& \fname{.lua} & \\
|
|
|
|
|
Midiplay & \fname{.mid, .midi} & \\
|
|
|
|
|
\opt{swcodec}{
|
|
|
|
|
MPEG Player & \fname{.mpg, .mpeg, .mpv, .m2v} & \\}
|
|
|
|
|
\opt{masf}{\opt{lcd_bitmap}{
|
|
|
|
|
Movie Player & \fname{.rvf} & \\}}
|
|
|
|
|
PNG viewer & \fname{.png} & \\
|
|
|
|
|
\opt{lcd_color}{
|
|
|
|
|
PPM viewer & \fname{.ppm} & \\}
|
|
|
|
|
Rockboy & \fname{.gb, .gbc} & \\
|
|
|
|
|
Search & \fname{.m3u, .m3u8} & x \\
|
|
|
|
|
Sort & \fname{.*} & x \\
|
|
|
|
|
Text Viewer & \fname{.txt, .*} & \\
|
|
|
|
|
VBRfix & \fname{.mp3} & x \\
|
|
|
|
|
\opt{masf}{
|
|
|
|
|
Wavplay & \fname{.wav} & \\}
|
|
|
|
|
ZXBox & \fname{.tap, .tax, .sna, .z80} & \\
|
|
|
|
|
\end{rbtabular}
|
|
|
|
|
\end{table}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-31 19:08:25 +00:00
|
|
|
{\input{plugins/shortcuts.tex}}
|
|
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/chip8emulator.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/jpegviewer.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2009-06-02 20:17:21 +00:00
|
|
|
\opt{large_plugin_buffer}{\input{plugins/lua.tex}}
|
|
|
|
|
|
2008-06-13 19:29:36 +00:00
|
|
|
\opt{swcodec}{\input{plugins/midiplay.tex}}
|
|
|
|
|
|
2006-02-21 11:54:53 +00:00
|
|
|
\opt{recorder,recorderv2fm,ondio}{\input{plugins/movieplayer.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-05-24 00:01:13 +00:00
|
|
|
\opt{lcd_bitmap}{\opt{swcodec}{\input{plugins/mpegplayer.tex}}}
|
2007-06-01 08:42:40 +00:00
|
|
|
|
2009-08-01 13:42:51 +00:00
|
|
|
\opt{lcd_bitmap}{\opt{lcd_color}{\input{plugins/pngviewer.tex}}}
|
|
|
|
|
|
2008-06-30 19:27:06 +00:00
|
|
|
\opt{lcd_color}{\input{plugins/ppmviewer.tex}}
|
|
|
|
|
|
2006-02-21 11:54:53 +00:00
|
|
|
\opt{recorder,recorderv2fm,ondio}{\input{plugins/rockbox_flash.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-12-07 23:00:15 +00:00
|
|
|
\opt{recorder,recorderv2fm,h100,m5,lcd_color}{\input{plugins/rockboy.tex}}
|
2006-03-14 08:20:39 +00:00
|
|
|
|
2006-05-20 11:54:27 +00:00
|
|
|
{\input{plugins/search.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2006-05-20 11:54:27 +00:00
|
|
|
{\input{plugins/sort.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2006-03-28 22:46:54 +00:00
|
|
|
{\input{plugins/text_viewer.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2006-05-20 11:54:27 +00:00
|
|
|
{\input{plugins/vbrfix.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2006-08-27 17:05:57 +00:00
|
|
|
\opt{recorder,recorderv2fm,ondio}{\input{plugins/wavplay.tex}}
|
|
|
|
|
|
2008-06-05 14:42:32 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/zxbox.tex}}
|
|
|
|
|
|
2006-02-11 01:29:51 +00:00
|
|
|
\section{Applications}
|
|
|
|
|
|
2006-03-28 12:18:51 +00:00
|
|
|
\opt{player,recorder,recorderv2fm}{\input{plugins/alpinecdc.tex}}
|
|
|
|
|
|
2006-03-27 17:12:14 +00:00
|
|
|
{\input{plugins/batterybenchmark.tex}}
|
|
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/calculator.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-10-25 17:26:44 +00:00
|
|
|
\opt{rtc}{\input{plugins/calendar.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2006-05-20 11:54:27 +00:00
|
|
|
{\input{plugins/chess_clock.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{rtc}{\input{plugins/clock.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2007-01-19 06:45:59 +00:00
|
|
|
{\input{plugins/disktidy.tex}}
|
2006-09-03 11:58:25 +00:00
|
|
|
|
2006-05-31 12:41:53 +00:00
|
|
|
\opt{player}{\input{plugins/euro_converter.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2006-02-21 11:54:53 +00:00
|
|
|
\opt{recorder,recorderv2fm,ondio}{\input{plugins/firmware_flash.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2008-07-07 14:40:41 +00:00
|
|
|
{\input{plugins/keybox.tex}}
|
|
|
|
|
|
2008-05-07 21:59:45 +00:00
|
|
|
\opt{HAVE_BACKLIGHT}{\input{plugins/lamp.tex}}
|
|
|
|
|
|
2008-06-30 01:43:26 +00:00
|
|
|
{\input{plugins/md5sum.tex}}
|
|
|
|
|
|
2006-05-20 11:54:27 +00:00
|
|
|
{\input{plugins/metronome.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2009-09-08 20:55:45 +00:00
|
|
|
\opt{swcodec}{\opt{recording_mic}{\input{plugins/pitch_detector.tex}}}
|
|
|
|
|
|
2008-06-26 03:05:24 +00:00
|
|
|
{\input{plugins/random_folder_advance_config.tex}}
|
|
|
|
|
|
2009-05-21 00:05:00 +00:00
|
|
|
\opt{lcd_color}{\input{plugins/rockpaint.tex}}
|
|
|
|
|
|
2006-02-21 11:54:53 +00:00
|
|
|
\opt{recorder,recorderv2fm,ondio}{\input{plugins/split_editor.tex}}
|
2006-02-11 01:29:51 +00:00
|
|
|
|
2006-03-25 18:16:36 +00:00
|
|
|
{\input{plugins/stats.tex}}
|
|
|
|
|
|
2006-05-20 11:54:27 +00:00
|
|
|
{\input{plugins/stopwatch.tex}}
|
2006-04-05 18:32:07 +00:00
|
|
|
|
2008-03-23 22:07:09 +00:00
|
|
|
\opt{lcd_bitmap}{\input{plugins/text_editor.tex}}
|
