manual/plugins/rockpaint.tex

   1 % $Id$ %
   2 \subsection{Rockpaint}
   3 \screenshot{plugins/images/ss-rockpaint}{Rockpaint}%
   4 {img:Rockpaint}
   5 Rockpaint is a bitmap (\fname{.bmp}) editor for Rockbox. It can open any \fname{.bmp} file
   6 whose dimensions are the same size as your device's screen or smaller; it can
   7 also create empty bitmaps for you to work with.\\
   8
   9 \subsubsection{Opening A File}
  10 To open a file, you may use either the context menu option "Open With" in the
  11 File Browser, or you may enter Rockpaint first using the Plugins menu and open
  12 a file from there. To perform the latter, simply press Rockpaint's Menu button
  13 or move the cursor beyond the bottom of the screen; then move the cursor onto
  14 "Menu" and select it. Finally, select "Load" and navigate to the image you
  15 wish to open.\\
  16
  17 \subsubsection{Tools}
  18 Rockpaint offers several tools to aid you in editing; you can view them by
  19 either pressing Rockpaint's "Menu" key or by attempting to move the cursor
  20 beyond the bottom of the screen. From top to bottom and left to right, and
  21 by section, they are as follows:
  22 \begin{description}
  23     \item[Colour Picker]
  24         The top left tool shows your colours that are at the ready. To
  25         swap them, "click" on the background colour. To edit the foreground colour,
  26         click on it.
  27     \item[Preset Pallete]
  28         Several preset colours are availible. Clicking on one changes
  29         the foreground of the Colour Picker to the selected colour.
  30     \item[Pencil]
  31         Draws as you move the cursor. You can change the brush size with the
  32         Menu option "Brush Size". Use the Select key to toggle the tool while editing
  33         the image.
  34     \item[Selection tool]
  35         Allows you to select a rectangular region; once you do, you
  36         will be shown a menu of options (including "cancel" if you make a mistake).
  37     \item[Line tool]
  38         Draws a straight line.
  39     \item[Curve tool]
  40         Allows you to draw a line and curve it.
  41     \item[Rectangle tool]
  42         Draws an unfilled rectangle.
  43     \item[Circle tool]
  44         Draws an unfilled circle.
  45     \item[Gradient fill]
  46         To use this tool, click at the starting and ending points.
  47         Starting with the background and going to the foreground colour, Rockpaint
  48         will fill the region with a gradual colour change.
  49     \item[Bucket fill]
  50         Fills an same-colour or empty region with a colour.
  51     \item[Dropper]
  52         Click on a colour in the image to change the foreground colour to it.
  53     \item[Eraser]
  54         The opposite of the pencil; it changes painted pixels to white.
  55     \item[Text tool]
  56         "Draws" text on the image.
  57     \item[Filled rectangle]
  58         Same as the Rectangle tool, but fills it with colour.
  59     \item[Filled circle]
  60         Same as the Circle tool, but fills it with colour.
  61     \item[Curved Gradient Fill]
  62         Same as Gradient fill, but you must draw two lines.
  63         Rockpaint will draw a curved, gradual change of colour in the region.
  64     \item[Menu]
  65         This opens the Main Menu. You can also press the Menu key to open it.
  66 \end{description}
  67
  68 \subsubsection{Main Menu}
  69 The main menu consists of the following:
  70 \begin{description}
  71     \item[Resume]
  72         Closes the Main Menu.
  73     \item[New]
  74         Creates a new canvas and discards the current file. BE CAREFUL.
  75         You will lose any unsaved changes in the file that is currently open.
  76     \item[Load]
  77         Loads a bitmap file. Simply navigate to the file as you
  78         would in the file browser.
  79     \item[Save]
  80         Saves the current file. If it has not been saved before,
  81         you will be given a chance to name it and choose the saving location.
  82     \item[Set Width]
  83         Allows you to change the width of the image.
  84         Border to indicate the width will be shown but it doesn't affect drawing.
  85     \item[Set Height]
  86         Allows you to change the height of the image.
  87         Border to indicate the height will be shown but it doesn't affect drawing.
  88     \item[Brush speed]
  89         Changes the speed at which the selection cursor
  90         moves when you hold down a movement button.
  91     \item[Brush size]
  92         Allows you to adjust the drawing size of the pencil tool.
  93     \item[Choose colour]
  94         Allows you to manually edit the foreground colour.
  95         You can edit the RBG and/or the HSV values.
  96     \item[Grid size]
  97         Allows you to show or hide a grid over the canvas,
  98         and to specify its size.
  99     \item[Exit]
 100         Exits Rockpaint.
 101 \end{description}
 102
 103 \warn{BE CAREFUL. Rockpaint will NOT prompt you to save
 104 if you select Exit, so any unsaved changes will be lost.}
 105
 106 \begin{table}
 107   \begin{btnmap}{}{}
 108     \nopt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{
 109         \nopt{IRIVER_H300_PAD,GIGABEAT_S_PAD,SANSA_FUZE_PAD}
 110             {\ButtonPower}
 111         \opt{IRIVER_H300_PAD}{\ButtonOff}
 112         \opt{GIGABEAT_S_PAD}{\ButtonBack}
 113         \opt{SANSA_FUZE_PAD}{Long \ButtonHome}
 114           \opt{HAVEREMOTEKEYMAP}{& }
 115         & Quits Rockpaint immediately.\\
 116     }
 117
 118     \nopt{COWON_D2_PAD}{\ButtonLeft{} / \ButtonRight{} /}
 119     \opt{COWON_D2_PAD}{\TouchMidLeft{} / \TouchMidRight{} /}
 120     \nopt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD,IRIVER_H10_PAD,COWON_D2_PAD}
 121         {\ButtonUp{} / \ButtonDown}
 122     \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{\ButtonMenu{} / \ButtonPlay}
 123     \opt{IRIVER_H10_PAD}{\ButtonScrollUp{} / \ButtonScrollDown}
 124     \opt{COWON_D2_PAD}{\TouchTopMiddle{} / \TouchBottomMiddle}
 125       \opt{HAVEREMOTEKEYMAP}{& }
 126     & Moves the cursor around.\\
 127
 128     \opt{IRIVER_H300_PAD}{\ButtonOn}%
 129     \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{\ButtonSelect+\ButtonMenu}%
 130     \opt{SANSA_C200_PAD,SANSA_E200_PAD}{\ButtonSelect+\ButtonPower}%
 131     \opt{SANSA_FUZE_PAD}{\ButtonSelect+\ButtonDown}%
 132     \opt{IAUDIO_X5_PAD}{\ButtonPlay}%
 133     \opt{GIGABEAT_PAD,GIGABEAT_S_PAD,COWON_D2_PAD}{\ButtonMenu}%
 134     \opt{IRIVER_H10_PAD}{\ButtonPlay}%
 135       \opt{HAVEREMOTEKEYMAP}{& }
 136     & Displays the Main Menu.\\
 137
 138     \opt{IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_C200_PAD,SANSA_E200_PAD}{\ButtonRec}
 139     \opt{SANSA_FUZE_PAD}{\ButtonSelect+\ButtonLeft}
 140     \opt{IPOD_4G_PAD,IPOD_3G_PAD,IPOD_1G2G_PAD}{\ButtonMenu+\ButtonLeft}
 141     \opt{GIGABEAT_PAD}{\ButtonA}
 142     \opt{IRIVER_H10_PAD}{\ButtonRew}
 143     \opt{GIGABEAT_S_PAD}{\ButtonPlay}
 144     \opt{COWON_D2_PAD}{\TouchBottomLeft}
 145       \opt{HAVEREMOTEKEYMAP}{& }
 146     & Displays the toolbar.\\
 147
 148     \nopt{IRIVER_H10_PAD,COWON_D2_PAD}{\ButtonSelect}%
 149     \opt{IRIVER_H10_PAD}{\ButtonFF}%
 150     \opt{COWON_D2_PAD}{\TouchCenter}
 151       \opt{HAVEREMOTEKEYMAP}{& }
 152     & Toggles the brush and selects objects.\\
 153
 154   \end{btnmap}
 155 \end{table}