157 lines
6.6 KiB
TeX
157 lines
6.6 KiB
TeX
% $Id$ %
|
|
\subsection{Rockpaint}
|
|
\screenshot{plugins/images/ss-rockpaint}{Rockpaint}%
|
|
{img:Rockpaint}
|
|
Rockpaint is a bitmap (\fname{.bmp}) editor for Rockbox. It can open any \fname{.bmp} file
|
|
whose dimensions are the same size as your device's screen or smaller; it can
|
|
also create empty bitmaps 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[Colour Picker]
|
|
The top left tool shows your colours that are at the ready. To
|
|
swap them, ``click'' on the background colour. To edit the foreground colour,
|
|
click on it.
|
|
\item[Preset Pallete]
|
|
Several preset colours are availible. Clicking on one changes
|
|
the foreground of the Colour Picker to the selected colour.
|
|
\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 an 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 colour, Rockpaint
|
|
will fill the region with a gradual colour change.
|
|
\item[Bucket fill]
|
|
Fills an same-colour or empty region with a colour.
|
|
\item[Dropper]
|
|
Click on a colour in the image to change the foreground colour 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 colour.
|
|
\item[Filled circle]
|
|
Same as the Circle tool, but fills it with colour.
|
|
\item[Curved Gradient Fill]
|
|
Same as Gradient fill, but you must draw two lines.
|
|
Rockpaint will draw a curved, gradual change of colour 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[Set Width]
|
|
Allows you to change the width of the image.
|
|
Border to indicate the width will be shown but it doesn't affect drawing.
|
|
\item[Set Height]
|
|
Allows you to change the height of the image.
|
|
Border to indicate the height will be shown but it doesn't affect drawing.
|
|
\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 colour]
|
|
Allows you to manually edit the foreground colour.
|
|
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{btnmap}
|
|
\nopt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{
|
|
\nopt{IRIVER_H300_PAD,GIGABEAT_S_PAD,SANSA_FUZE_PAD,PBELL_VIBE500_PAD}
|
|
{\ButtonPower}
|
|
\opt{IRIVER_H300_PAD}{\ButtonOff}
|
|
\opt{GIGABEAT_S_PAD}{\ButtonBack}
|
|
\opt{SANSA_FUZE_PAD}{Long \ButtonHome}
|
|
\opt{PBELL_VIBE500_PAD}{\ButtonRec}
|
|
\opt{HAVEREMOTEKEYMAP}{& }
|
|
& Quits Rockpaint immediately.\\
|
|
}
|
|
|
|
\nopt{touchscreen}{\ButtonLeft{} / \ButtonRight{} /}
|
|
\opt{touchscreen}{\TouchMidLeft{} / \TouchMidRight{} /}
|
|
\nopt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD,IRIVER_H10_PAD,touchscreen}
|
|
{\ButtonUp{} / \ButtonDown}
|
|
\opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{\ButtonMenu{} / \ButtonPlay}
|
|
\opt{IRIVER_H10_PAD}{\ButtonScrollUp{} / \ButtonScrollDown}
|
|
\opt{touchscreen}{\TouchTopMiddle{} / \TouchBottomMiddle}
|
|
\opt{HAVEREMOTEKEYMAP}{& }
|
|
& Moves the cursor around.\\
|
|
|
|
\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{SANSA_FUZE_PAD}{\ButtonSelect+\ButtonDown}%
|
|
\opt{IAUDIO_X5_PAD}{\ButtonPlay}%
|
|
\opt{GIGABEAT_PAD,GIGABEAT_S_PAD,COWON_D2_PAD,PBELL_VIBE500_PAD}{\ButtonMenu}%
|
|
\opt{IRIVER_H10_PAD}{\ButtonPlay}%
|
|
\opt{HAVEREMOTEKEYMAP}{& }
|
|
& Displays the Main Menu.\\
|
|
|
|
\opt{IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_C200_PAD,SANSA_E200_PAD}{\ButtonRec}
|
|
\opt{SANSA_FUZE_PAD}{\ButtonSelect+\ButtonLeft}
|
|
\opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{\ButtonMenu+\ButtonLeft}
|
|
\opt{GIGABEAT_PAD}{\ButtonA}
|
|
\opt{IRIVER_H10_PAD}{\ButtonRew}
|
|
\opt{GIGABEAT_S_PAD}{\ButtonPlay}
|
|
\opt{touchscreen}{\TouchBottomLeft}
|
|
\opt{PBELL_VIBE500_PAD}{\ButtonOK}
|
|
\opt{HAVEREMOTEKEYMAP}{& }
|
|
& Displays the toolbar.\\
|
|
|
|
\nopt{IRIVER_H10_PAD,touchscreen,PBELL_VIBE500_PAD}{\ButtonSelect}%
|
|
\opt{IRIVER_H10_PAD}{\ButtonFF}%
|
|
\opt{touchscreen}{\TouchCenter}
|
|
\opt{PBELL_VIBE500_PAD}{\ButtonPlay}
|
|
\opt{HAVEREMOTEKEYMAP}{& }
|
|
& Toggles the brush and selects objects.\\
|
|
|
|
\end{btnmap}
|