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