Index: manual/plugins/main.tex
===================================================================
--- manual/plugins/main.tex (revision 20999)
+++ manual/plugins/main.tex (working copy)
@@ -181,6 +181,8 @@
{\input{plugins/random_folder_advance_config.tex}}
+\opt{lcd_color}{\input{plugins/rockpaint.tex}}
+
\opt{recorder,recorderv2fm,ondio}{\input{plugins/split_editor.tex}}
{\input{plugins/stats.tex}}
Index: manual/plugins/rockpaint.tex
===================================================================
--- manual/plugins/rockpaint.tex (revision 0)
+++ manual/plugins/rockpaint.tex (revision 0)
@@ -0,0 +1,149 @@
+% $Id$ %
+\subsection{Rockpaint}
+\screenshot{plugins/images/ss-rockpaint}{Rockpaint}%
+{img:Rockpaint}
+Rockpaint is a bitmap (.bmp) editor for Rockbox. It can open any .bmp file
+whose dimensions are the same size as your device's screen or smaller; it can
+also create empty .bmps for you to work with.\\
+
+\subsubsection{Opening A File}
+To open a file, you may use either the context menu option "Open With" in the
+File Browser, or you may enter Rockpaint first using the Plugins menu and open
+a file from there. To perform the latter, simply press Rockpaint's Menu button
+or move the cursor beyond the bottom of the screen; then move the cursor onto
+"Menu" and select it. Finally, select "Load" and navigate to the image you
+wish to open.\\
+
+\subsubsection{Tools}
+Rockpaint offers several tools to aid you in editing; you can view them by
+either pressing Rockpaint's "Menu" key or by attempting to move the cursor
+beyond the bottom of the screen. From top to bottom and left to right, and
+by section, they are as follows:
+\begin{description}
+\item[Color Picker]
+The NW-most tool shows your colors that are at the ready. To
+swap them, "click" on the background color. To edit the foreground color,
+click on it.
+\item[Preset Pallete]
+Several preset colors are availible. Clicking on one changes
+the foreground of the Color Picker to the selected color.
+\item[Pencil]
+Draws as you move the cursor. You can change the brush size with the
+Menu option "Brush Size". Use the Select key to toggle the tool while editing
+the image.
+\item[Selection tool]
+Allows you to select a rectangular region; once you do, you
+will be shown a menu of options (including "cancel" if you make a mistake).
+\item[Line tool]
+Draws a straight line.
+\item[Curve tool]
+Allows you to draw a line and curve it.
+\item[Rectangle tool]
+Draws an unfilled rectangle.
+\item[Circle tool]
+Draws and unfilled circle.
+\item[Gradient fill]
+To use this tool, click at the starting and ending points.
+Starting with the background and going to the foreground color, Rockpaint
+will fill the region with a gradual color change.
+\item[Bucket fill]
+Fills an same-color or empty region with a color.
+\item[Dropper]
+Click on a color in the image to change the Foreground color to it.
+\item[Eraser]
+The opposite of the pencil; it changes painted pixels to white.
+\item[Text tool]
+"Draws" text on the image.
+\item[Filled rectangle]
+Same as the Rectangle tool, but fills it with color.
+\item[Filled circle]
+Same as the Circle tool, but fills it with color.
+\item[Curved Gradient Fill]
+Same as Gradient fill, but you must draw two lines.
+Rockpaint will draw a curved, gradual change of color in the region.
+\item[Menu]
+This opens the Main Menu. You can also press the Menu key to open it.
+\end{description}
+
+\subsubsection{Main Menu}
+The main menu consists of the following:
+\begin{description}
+\item[Resume]
+Closes the Main Menu.
+\item[New]
+Creates a new canvas and discards the current file. BE CAREFUL.
+You will lose any unsaved changes in the file that is currently open.
+\item[Load]
+Loads a bitmap file. Simply navigate to the file as you
+would in the file browser.
+\item[Save]
+Saves the current file. If it has not been saved before,
+you will be given a chance to name it and choose the saving location.
+\item[Brush speed]
+Changes the speed at which the selection cursor
+moves when you hold down a movement button.
+\item[Brush size]
+Allows you to adjust the drawing size of the pencil tool.
+\item[Choose color]
+Allows you to manually edit the foreground color.
+You can edit the RBG and/or the HSV values.
+\item[Grid size]
+Allows you to show or hide a grid over the canvas,
+and to specify its size.
+\item[Exit]Exits Rockpaint.
+\end{description}
+
+\warn{BE CAREFUL. Rockpaint will NOT prompt you to save
+if you select Exit, so any unsaved changes will be lost.}
+
+\begin{table}
+\begin{btnmap}{}{}
+ \ButtonLeft
+ & Moves the cursor to the left.\\
+ \ButtonRight
+ & Moves the cursor to the right.\\
+ \nopt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD,IRIVER_H10_PAD}{\ButtonUp}
+ \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{\ButtonMenu}
+ \opt{IRIVER_H10_PAD}{\ButtonScrollUp}
+ & Moves the cursor up.\\
+ \nopt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD,IRIVER_H10_PAD}{\ButtonDown}
+ \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{\ButtonPlay}
+ \opt{IRIVER_H10_PAD}{\ButtonScrollDown}
+ & Moves the cursor down.\\
+
+ \opt{IRIVER_H300_PAD}{\ButtonOn}
+ \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{\ButtonSelect+\ButtonMenu}
+ \opt{SANSA_C200_PAD,SANSA_E200_PAD}{\ButtonSelect+\ButtonPower}
+ \opt{IAUDIO_X5M5_PAD}{\ButtonPlay}
+ \opt{GIGABEAT_PAD}{\ButtonMenu}
+ \opt{IRIVER_H10_PAD}{\ButtonPlay}
+ \opt{GIGABEAT_S_PAD}{\ButtonMenu}
+ & Displays the Main Menu.\\
+
+ \opt{IRIVER_H300_PAD}{\ButtonRec}
+ \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{\ButtonMenu+\ButtonLeft}
+ \opt{SANSA_C200_PAD,SANSA_E200_PAD}{\ButtonRec}
+ \opt{IAUDIO_X5M5_PAD}{\ButtonRec}
+ \opt{GIGABEAT_PAD}{\ButtonA}
+ \opt{IRIVER_H10_PAD}{\ButtonScrollRew}
+ \opt{GIGABEAT_S_PAD}{\ButtonPlay}
+ & Displays the toolbar.\\
+
+ \opt{SANSA_C200_PAD,SANSA_E200_PAD}{\ButtonSelect}
+ \opt{IRIVER_H300_PAD}{\ButtonSelect}
+ \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{\ButtonSelect}
+ \opt{IAUDIO_X5M5_PAD}{\ButtonSelect}
+ \opt{GIGABEAT_PAD}{\ButtonSelect}
+ \opt{IRIVER_H10_PAD}{\ButtonFF}
+ \opt{GIGABEAT_S_PAD}{\ButtonSelect}
+ & Toggles the brush and selects objects.\\
+
+ \opt{SANSA_C200_PAD,SANSA_E200_PAD}{\ButtonPower}
+ \opt{IRIVER_H300_PAD}{\ButtonOff}
+ \opt{IAUDIO_X5M5_PAD}{\ButtonPower}
+ \opt{GIGABEAT_PAD}{\ButtonPower}
+ \opt{IRIVER_H10_PAD}{\ButtonPower}
+ \opt{GIGABEAT_S_PAD}{\ButtonBack}
+ \nopt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{& Quits Rockpaint immediately.}\\
+ \end{btnmap}
+\end{table}