rockbox/manual/plugins/main.tex
Martin Arver c7fd0fee7a Patch[1430311] by Henrico Witvliet. Split plugins to individual files. Proper naming of the targets.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@8763 a1c6a512-1295-4272-9138-f99709370657
2006-02-21 11:54:53 +00:00

122 lines
3.7 KiB
TeX

\chapter{Plugins}
\newpage
Plugins are little programs that Rockbox can load and run. Plugins have
the file extension .rock. Most of them can be started from the main
menu if you put them in the \textbf{/.rockbox/rocks} directory. Press
PLAY on them to start them.
Viewer plugins get started automatically by
``playing'' an associated file (i.e. text
files, chip8 games), or from the ``Open with'' option on the File menu.
Plugins listed here have the platforms they run under (Player for
Jukebox players, Recorder for Jukebox recorders including Jukebox FM,
and Ondio for the Ondio SP and FM). If no platforms are listed then
the plugin runs on all Rockbox platforms.\\
\textbf{The plugin loader}
Only one plugin can be loaded at a time. Plugins run in the GUI thread
and have exclusive control over the user interface. This means you
cannot switch back and forth between a plugin and Rockbox. A plugin is
loaded, run and then exited, which returns control to Rockbox. Music
will carry on playing whilst plugins are being run.
\section{Games}
See also the Chip{}-8 emulator on page \pageref{ref:Chip8emulator}.
\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/flipit.tex}}
\opt{player}{\input{plugins/jackpot.tex}}
\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/minesweeper.tex}}
\opt{player}{\input{plugins/nim.tex}}
\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/rockblox.tex}}
\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/sliding.tex}}
\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/snake.tex}}
\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/snake2.tex}}
\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/sokoban.tex}}
\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/solitaire.tex}}
\opt{recorder,recorderv2fm,ondio,h1xx}{\input{plugins/star.tex}}
\opt{recorder,recorderv2fm}{\input{plugins/wormlet.tex}}
\section{Demos}
\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/bounce.tex}}
\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/cube.tex}}
\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/grayscale.tex}}
{\input{plugins/hello.tex}}
\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/mandelbrot.tex}}
\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/mosaic.tex}}
\opt{recorder,recorderv2fm,ondio}{\input{plugins/oscillograph.tex}}
\opt{recorder,recorderv2fm,ondio,h1xx,h300}{\input{plugins/snow.tex}}
\opt{recorder,recorderv2fm,ondio}{\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
\textbf{/.rockbox/viewers/ }directory.
\opt{recorder,recorderv2fm,ondio}{\input{plugins/chip8emulator.tex}}
\opt{recorder,recorderv2fm,ondio,h1xx}{\input{plugins/jpegviewer.tex}}
\opt{recorder,recorderv2fm,ondio}{\input{plugins/movieplayer.tex}}
\opt{recorder,recorderv2fm,ondio}{\input{plugins/rockbox_flash.tex}}
\input{plugins/search.tex}
\input{plugins/sort.tex}
\input{plugins/text_viewer.tex}
\input{plugins/vbrfix.tex}
\section{Applications}
\input{plugins/battery_test.tex}
\opt{recorder,recorderv2fm,ondio,h1xx}{\input{plugins/calculator.tex}}
\opt{recorder,recorderv2fm,ondio}{\input{plugins/calendar.tex}}
\input{plugins/chess_clock.tex}
\opt{recorder,recorderv2fm}{\input{plugins/clock.tex}}
\opt{recorder,recorderv2fm}{\input{plugins/euro_converter.tex}}
\input{plugins/favorites.tex}
\opt{recorder,recorderv2fm,ondio}{\input{plugins/firmware_flash.tex}}
\input{plugins/metronome.tex}
\opt{recorder,recorderv2fm,ondio}{\input{plugins/split_editor.tex}}
\input{plugins/stopwatch.tex}