diff options
Diffstat (limited to 'manual/plugins/rockpaint.tex')
-rw-r--r-- | manual/plugins/rockpaint.tex | 224 |
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} |
5 | Rockpaint is a bitmap (\fname{.bmp}) editor for Rockbox. It can open any \fname{.bmp} file | 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 | 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.\\ | 7 | also create empty bitmaps for you to work with.\\ |
8 | 8 | ||
9 | \subsubsection{Opening A File} | 9 | \subsubsection{Opening A File} |
10 | To open a file, you may use either the context menu option "Open With" in the | 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 | 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 | 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 | 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 | 14 | "Menu" and select it. Finally, select "Load" and navigate to the image you |
15 | wish to open.\\ | 15 | wish to open.\\ |
16 | 16 | ||
17 | \subsubsection{Tools} | 17 | \subsubsection{Tools} |
18 | Rockpaint offers several tools to aid you in editing; you can view them by | 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 | 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 | 20 | beyond the bottom of the screen. From top to bottom and left to right, and |
21 | by section, they are as follows: | 21 | by 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} |
69 | The main menu consists of the following: | 69 | The 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 |
98 | if you select Exit, so any unsaved changes will be lost.} | 98 | if 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} | ||