33cb13dee5
Co-conspirators: Franklin Wei, Benjamin Brown -------------------------------------------------------------------- This work is based on: - Fabien Sanglard's "Fabother World" based on - Piotr Padkowski's newRaw interpreter which was based on - Gregory Montoir's reverse engineering of - Eric Chahi's assembly code -------------------------------------------------------------------- Progress: * The plugin runs pretty nicely (with sound!) on most color targets * Keymaps for color LCD targets are complete * The manual entry is finished * Grayscale/monochrome support is NOT PLANNED - the game looks horrible in grayscale! :p -------------------------------------------------------------------- Notes: * The original game strings were built-in to the executable, and were copyrighted and could not be used. * This port ships with an alternate set of strings by default, but can load the "official" strings from a file at runtime. -------------------------------------------------------------------- To be done (in descending order of importance): * vertical stride compatibility <30% done> * optimization <10% done> Change-Id: I3155b0d97c2ac470cb8a2040f40d4139ddcebfa5 Reviewed-on: http://gerrit.rockbox.org/1077 Reviewed-by: Michael Giacomelli <giac2000@hotmail.com>
271 lines
7.7 KiB
TeX
271 lines
7.7 KiB
TeX
% $Id$ %
|
|
\chapter{Plugins}\label{ref:plugins}
|
|
\opt{mpiohd200}{%
|
|
\fixme{The manual for MPIO HD200 is incomplete. Keymap definitions for plugins are missing.}\\
|
|
|
|
}
|
|
Plugins are programs that Rockbox can load and run. Only one plugin can
|
|
be loaded at a time. Plugins have exclusive control over the user interface.
|
|
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
|
|
playback while running. Plugins have the file extension \fname{.rock}. Most of
|
|
them can be started from \setting{Browse Plugins} in the \setting{Main Menu}.\\
|
|
|
|
Viewer plugins get started automatically by opening an associated file (i.e.
|
|
text files%
|
|
\opt{lcd_bitmap}{, chip8 games}%
|
|
), or from the \setting{Open with} option on the \setting{Context Menu}.
|
|
|
|
\section{Games}
|
|
\opt{lcd_bitmap}
|
|
{See also the Chip{}-8 emulator in \reference{ref:Chip8emulator}
|
|
\opt{archosrecorder,archosfmrecorder,iriverh100,iaudiom5,lcd_color}
|
|
{and Rockboy in \reference{ref:Rockboy}}.}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/2048.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/blackjack.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/codebuster.tex}}
|
|
|
|
{\input{plugins/dice.tex}}
|
|
|
|
\opt{swcodec}{\nopt{lowmem}{\input{plugins/doom.tex}}}
|
|
|
|
{\input{plugins/flipit.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/goban.tex}}
|
|
|
|
\opt{lcd_non-mono}{\nopt{iriverh10_5gb,ipodmini1g,c200,c200v2,mpiohd200,clipzip,samsungyh820}{
|
|
\input{plugins/invadrox.tex}}}
|
|
|
|
{\input{plugins/jackpot.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/jewels.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/mazezam.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/minesweeper.tex}}
|
|
|
|
\opt{archosplayer}{\input{plugins/nim.tex}}
|
|
|
|
\opt{iriverh100,iaudiom5,lcd_color}{\nopt{c200,c200v2,clipzip,samsungyh820}{\input{plugins/pacbox.tex}}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/pegbox.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/pong.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/reversi.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/robotfindskitten.tex}}
|
|
|
|
{\input{plugins/rockblox.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/rockblox1d.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/sliding.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/snake.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/snake2.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/sokoban.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/solitaire.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/spacerocks.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/star.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/sudoku.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/wormlet.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/xobox.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/xworld.tex}}
|
|
|
|
\section{Demos}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/bounce.tex}}
|
|
|
|
{\input{plugins/credits.tex}}
|
|
|
|
{\input{plugins/cube.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/demystify.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/fire.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/fractals.tex}}
|
|
|
|
{\input{plugins/logo.tex}}
|
|
|
|
{\input{plugins/mosaic.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/oscilloscope.tex}}
|
|
|
|
\opt{tagcache}{\opt{lcd_bitmap}{\input{plugins/pictureflow.tex}}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/plasma.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/rocklife.tex}}
|
|
|
|
{\input{plugins/snow.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/starfield.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/vumeter.tex}}
|
|
|
|
\section{\label{ref:Viewersplugins}Viewers}
|
|
|
|
Viewers are plugins which are associated with specific file extensions.
|
|
They cannot be run directly but are started by ``playing'' the associated file.
|
|
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} & \\
|
|
Frotz & \fname{.z1 - .z8} & \\
|
|
Image Viewer & \fname{.bmp, .jpg, .jpeg, .png\opt{lcd_color}{, .ppm}} & \\
|
|
Lua scripting language& \fname{.lua} & \\
|
|
\opt{swcodec}{\nopt{lowmem}{
|
|
Midiplay & \fname{.mid, .midi} & \\
|
|
MPEG Player & \fname{.mpg, .mpeg, .mpv, .m2v} & \\
|
|
}}
|
|
\opt{swcodec}{
|
|
MP3 Encoder & \fname{.wav} & x \\
|
|
}
|
|
\opt{masf}{
|
|
\opt{lcd_bitmap}{
|
|
Movie Player & \fname{.rvf} & \\
|
|
}
|
|
}
|
|
\opt{lcd_bitmap}{
|
|
\nopt{ondio}{% not enough buttons
|
|
Rockboy & \fname{.gb, .gbc} & \\
|
|
}
|
|
}
|
|
Search & \fname{.m3u, .m3u8} & x \\
|
|
Sort & \fname{.*} & x \\
|
|
Text Viewer & \fname{.txt,.nfo, .*} & \\
|
|
VBRfix & \fname{.mp3} & x \\
|
|
\opt{masf}{
|
|
Wavplay & \fname{.wav} & \\
|
|
}
|
|
ZXBox & \fname{.tap, .tax, .sna, .z80} & \\
|
|
Shopping list & \fname{.shopper} & \\
|
|
\end{rbtabular}
|
|
\end{table}
|
|
|
|
{\input{plugins/shortcuts.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/chip8emulator.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/frotz.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/imageviewer.tex}}
|
|
|
|
\opt{large_plugin_buffer}{\input{plugins/lua.tex}}
|
|
|
|
\opt{swcodec}{\nopt{lowmem}{\input{plugins/midiplay.tex}}}
|
|
|
|
\opt{archosrecorder,archosfmrecorder,ondio}{\input{plugins/movieplayer.tex}}
|
|
|
|
\opt{lcd_bitmap}{\opt{swcodec}{\nopt{lowmem}{\input{plugins/mpegplayer.tex}}}}
|
|
|
|
\opt{swcodec}{\input{plugins/mp3_encoder.tex}}
|
|
|
|
|
|
\opt{archosrecorder,archosfmrecorder,ondio}{\input{plugins/rockbox_flash.tex}}
|
|
|
|
\opt{lcd_bitmap}{\nopt{%
|
|
ONDIO_PAD%,m200, % not enough buttons for keymap
|
|
,ipod1g2g,ipod3g,ipod4g,ipodmini% horizontal pixelformat not implemented
|
|
,iaudiom3,mpiohd200, % vertical interleaved pixelformat not implemented
|
|
,mrobe100% lcd size/depth not implemented
|
|
}{
|
|
\input{plugins/rockboy.tex}}}
|
|
|
|
{\input{plugins/search.tex}}
|
|
|
|
{\input{plugins/shopper.tex}}
|
|
|
|
{\input{plugins/sort.tex}}
|
|
|
|
{\input{plugins/text_viewer.tex}}
|
|
|
|
{\input{plugins/theme_remove.tex}}
|
|
|
|
{\input{plugins/vbrfix.tex}}
|
|
|
|
\opt{archosrecorder,archosfmrecorder,ondio}{\input{plugins/wavplay.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/zxbox.tex}}
|
|
|
|
\section{Applications}
|
|
|
|
\opt{rtc}{\input{plugins/alarmclock.tex}}
|
|
|
|
\opt{archosplayer,archosrecorder,archosfmrecorder}{\input{plugins/alpinecdc.tex}}
|
|
|
|
{\input{plugins/batterybenchmark.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/calculator.tex}}
|
|
|
|
\opt{rtc}{\input{plugins/calendar.tex}}
|
|
|
|
{\input{plugins/chess_clock.tex}}
|
|
|
|
\opt{rtc}{\input{plugins/clock.tex}}
|
|
|
|
{\input{plugins/disktidy.tex}}
|
|
|
|
\opt{archosplayer}{\input{plugins/euro_converter.tex}}
|
|
|
|
\opt{archosrecorder,archosfmrecorder,ondio}{\input{plugins/firmware_flash.tex}}
|
|
|
|
{\input{plugins/keybox.tex}}
|
|
|
|
\opt{HAVE_BACKLIGHT}{\input{plugins/lamp.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/lrcplayer.tex}}
|
|
|
|
{\input{plugins/md5sum.tex}}
|
|
|
|
{\input{plugins/metronome.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/periodic_table.tex}}
|
|
|
|
\opt{swcodec}{\opt{recording_mic}{\input{plugins/pitch_detector.tex}}}
|
|
|
|
{\input{plugins/random_folder_advance_config.tex}}
|
|
|
|
{\input{plugins/resistor.tex}}
|
|
|
|
\opt{lcd_color}{\input{plugins/rockpaint.tex}}
|
|
|
|
\opt{archosrecorder,archosfmrecorder,ondio}{\input{plugins/split_editor.tex}}
|
|
|
|
{\input{plugins/stats.tex}}
|
|
|
|
{\input{plugins/stopwatch.tex}}
|
|
|
|
\opt{lcd_bitmap}{\input{plugins/text_editor.tex}}
|