% $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.\\

\subsection{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.\\

\subsection{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:
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.
Preset Pallete: Several preset colors are availible. Clicking on one changes the foreground of the Color Picker to the selected color.
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.
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).
Line tool: Draws a straight line.
Curve tool: Allows you to draw a line and curve it.
Rectangle tool: Draws an unfilled rectangle.
Circle tool: Draws and unfilled circle.
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.
Bucket fill: Fills an same-color or empty region with a color.
Dropper: Click on a color in the image to change the Foreground color to it.
Eraser: The opposite of the pencil; it changes painted pixels to white.
Text tool: "Draws" text on the image.
Filled rectangle: Same as the Rectangle tool, but fills it with color.
Filled circle: Same as the Circle tool, but fills it with color.
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.
Menu: This opens the Main Menu. You can also press \Menu\ to open it.

\subsection{Main Menu}
The main menu consists of the following:
Resume: Closes the Main Menu.
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.
Load: Loads a bitmap file. Simply navigate to the file as you would in the file browser.
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.
Brush speed: Changes the speed at which the selection cursor moves when you hold down a movement button.
Brush size: Allows you to adjust the drawing size of the pencil tool.
Choose color: Allows you to manually edit the foreground color. You can edit the RBG and/or the HSV values.
Grid size: Allows you to show or hide a grid over the canvas, and to specify its size.
Exit: Exits Rockpaint. BE CAREFUL. Rockpaint will NOT prompt you to save if you select this option, so any unsaved changes will be lost.

\subsection{Keys}
Unfortunately these keymaps were typed by copying and pasting from other plugins entries.... I simply don't have the time to try every target....
\begin{table}
	\begin{btnmap}{}{}
	\buttonLeft
		& Moves the cursor to the left.\\
	\buttonRight
		& Moves the cursor to the right.\\
	\buttonUp
		& Moves the cursor up.\\
	\buttonDown
		& Moves the cursor down.\\
	{SANSA_C200_PAD}{\ButtonRecord}
		& Displays the Main Menu.\\
	{SANSA_C200_PAD}{\ButtonSelect}
		& Toggles the brush and selects objects.\\