Code

fix rubberband selection in gradient
[inkscape.git] / doc / keys.xml
1 <root xmlns="http://www.inkscape.org/namespaces/keys" 
2   title="Inkscape keyboard and mouse reference"
3   ver  ="0.46"
4 >
6 <p>This document describes the default keyboard and mouse shortcuts of Inkscape, corresponding to the
7 share/keys/default.xml file in Inkscape distribution. Most (but not all) of these keys
8 are configurable by the user; see the default.xml file for details on how to do that.</p>
10 <p>Unless noted otherwise, keypad keys (such as arrows, Home, End, +, -, digits) are
11 supposed to work the same as corresponding regular keys. If you have a new shortcut
12 idea, please contact the developers (by writing to the <a
13 href="http://lists.sourceforge.net/lists/listinfo/inkscape-devel">devel mailing list</a>
14 or by <a href="http://sourceforge.net/tracker/?group_id=93438&amp;atid=604309">submitting an
15 RFE</a>).</p>
17 <column>
19 *<section title="Tools" color="f5f5f5">
21 <group>
22 <keys><key><keyf f="F1"/></key><key>s</key>    <action>Selector</action></keys>
23 <keys><key><misc-wide f="Space"/></key>   <action>Selector (temporary)</action></keys>
24 <note>Space switches to the Selector tool temporarily; another Space switches back.</note>
25 <note>When the "Left mouse button pans when Space is pressed" option is on in Preferences, Space+mouse drag pans canvas instead of switching to Selector.</note>
26 <keys><key><keyf f="F2"/></key><key>n</key>     <action>Node tool</action></keys>
27 <keys><key><shift/><keyf f="F2"/></key><key>w</key>     <action>Tweak tool</action></keys>
28 <keys><key><keyf f="F3"/></key><key>z</key>      <action>Zoom tool</action></keys>
29 <keys><key><keyf f="F4"/></key><key>r</key>      <action>Rectangle tool</action></keys>
30 <keys><key><shift/><keyf f="F4"/></key><key>x</key>      <action>3D box tool</action></keys>
31 <keys><key><keyf f="F5"/></key><key>e</key>      <action>Ellipse/arc tool</action></keys>
32 <keys><key><keyf f="F6"/></key><key>p</key>      <action>Freehand (Pencil) tool</action></keys>
33 <keys><key><shift/><keyf f="F6"/></key><key>b</key>      <action>Bezier (Pen) tool</action></keys>
34 <keys><key><ctrl/><keyf f="F6"/></key><key>c</key>       <action>Calligraphy tool</action></keys>
35 <keys><key><shift/><keyf f="F7"/></key><key>u</key>      <action>Paint Bucket tool</action></keys>
36 <keys><key><ctrl/><keyf f="F1"/></key><key>g</key>       <action>Gradient tool</action></keys>
37 <keys><key><keyf f="F7"/></key><key>d</key>      <action>Dropper tool</action></keys>
38 <keys><key><keyf f="F8"/></key><key>t</key>      <action>Text tool</action></keys>
39 <keys><key><keyf f="F9"/></key><key>i</key>      <action>Spiral tool</action></keys>
40 <keys><key><shift/><keyf f="F9"/></key><key>*</key>      <action>Star tool</action></keys>
41 <keys><key><ctrl/><keyf f="F2"/></key><key>o</key>       <action>Connector tool</action></keys>
42 <note>Double click on the tool buttons opens the Preferences dialog showing the page of the corresponding tool.</note>
43 </group>
44 </section>
47 *<section title="Dialogs" color="f0eae7">
48 <group>
49 <title>Open</title>
50 <keys><key><shift/><ctrl/>F</key> <action>Fill and Stroke</action></keys>
51 <keys><key><shift/><ctrl/>W</key> <action>Swatches</action></keys>
52 <keys><key><shift/><ctrl/>T</key> <action>Text and Font</action></keys>
53 <keys><key><shift/><ctrl/>M</key> <action>Transform</action></keys>
54 <keys><key><shift/><ctrl/>L</key> <action>Layers</action></keys>
55 <keys><key><shift/><ctrl/>A</key> <action>Align and Distribute</action></keys>
56 <keys><key><shift/><ctrl/>O</key> <action>Object Properties</action></keys>
57 <keys><key><shift/><ctrl/>H</key> <action>Undo History</action></keys>
58 <keys><key><shift/><ctrl/>X</key> <action>XML Editor</action></keys>
59 <keys><key><shift/><ctrl/>D</key> <action>Document Preferences</action></keys>
60 <keys><key><shift/><ctrl/>P</key> <action>Inkscape Preferences</action></keys>
61 <keys><key><shift/><ctrl/>E</key>        <action>Export to PNG</action></keys>
62 <keys><key><ctrl/>F</key>        <action>Find</action></keys>
63 <keys><key><shift/><alt/>B</key>         <action>Trace Bitmap</action></keys>
64 <keys><key><shift/><ctrl/>7</key>        <action>Path Effects</action></keys>
65 <note>These shortcuts open a new dialog window if it wasn't open yet, otherwise the corresponding dialog gets focus.</note>
66 </group>
68 <group>
69 <title>Toggle visibility</title>
70 <keys><key><keyf f="F12"/></key> <action>toggle dialogs</action></keys>
71 <note>This temporarily hides all open dialogs; another F12 shows them again.</note>
72 </group>
74 <group>
75 <title>Within a dialog</title>
76 <keys><key><misc f="Esc"/></key> <action>return to the canvas</action></keys>
77 <keys><key><ctrl/><keyf f="F4"/></key> <key><ctrl/>W</key> <action>close the dialog</action></keys>
78 <keys><key><misc f="Tab"/></key> <action>jump to next widget</action></keys>
79 <keys><key><shift/><misc f="Tab"/></key> <action>jump to previous widget</action></keys>
80 <keys><key><misc-wide f="Enter"/></key> <action>set the new value</action></keys>
81 <note>This accepts the new value you typed in a text field and returns focus to canvas.</note>
82 <keys><key><ctrl/><misc-wide f="Enter"/></key> <action>in XML Editor, set the attr value</action></keys>
83 <note>When editing an attribute value in XML Editor, this sets the new value (same as clicking the "Set attribute" button).</note>
84 <keys><key><misc-wide f="Space"/></key> <key><misc-wide f="Enter"/></key> <action>activate current button or list</action></keys>
85 <keys><key><ctrl/><misc f="PgUp"/></key> <key><ctrl/><misc f="PgDn"/></key> <action>in a multi-tab dialog, switch tabs</action></keys>
86 </group>
87 </section>
89 *<section title="Controls bar" color="f8f3e9">
91 <group>
92 <title>Access</title>
93 <note>The Controls bar at the top of the document window provides different buttons and controls for each tool.</note>
94 <keys><key><alt/>X</key> <action>jump to the first editable field</action></keys>
95 </group>
97 <group>
98 <title>Navigate</title>
99 <keys><key><misc f="Tab"/></key> <action>jump to next field</action></keys>
100 <keys><key><shift/><misc f="Tab"/></key> <action>jump to previous field</action></keys>
101 <note>Use these to navigate between fields in the Controls bar (the value in the field you leave, if changed, is accepted).</note>
102 </group>
104 <group>
105 <title>Change values</title>
106 <mouse><key><up/></key> <key><down/></key> <action>change value by 0.1</action></mouse>
107 <keys><key><misc f="PgUp"/></key><key><misc f="PgDn"/></key> <action>change value by 5.0</action></keys>
108 <keys><key><misc-wide f="Enter"/></key> <action>accept the new value</action></keys>
109 <note>This accepts the new value you typed in a text field and returns focus to canvas.</note>
110 <keys><key><misc f="Esc"/></key>   <action>cancel changes, return to canvas</action></keys>
111 <note>This cancels any changes you made in a text field and returns focus to canvas.</note>
112 <keys><key><ctrl/>Z</key> <action>cancel changes</action></keys>
113 <note>This cancels any changes you made in a text field but you stay in the field.</note>
114 </group>
115  
116 </section>
118 *<section title="Canvas" color="e5f1e7">
120 <group>
121 <title>Zoom</title>
122 <keys><key>=</key> <key>+</key>          <action>zoom in</action></keys>
123 <keys><key>-</key>       <action>zoom out</action></keys>
124 <note>The keypad +/- keys do zooming even when you are editing a text object, unless NumLock is on.</note>
125 <mouse><key><mid-click/></key>  <key><ctrl/><right-click/></key>   <action>zoom in</action></mouse>
126 <mouse><key><shift/><mid-click/></key>  <key><shift/><right-click/></key> <action>zoom out</action></mouse>
127 <mouse><key><ctrl/><wheel/></key> <action>zoom in or out</action></mouse>
128 <note>When the "Mouse wheel zooms by default" option is on in Preferences, Ctrl+wheel scrolls instead of zooming. To zoom, use wheel without Ctrl.</note>
129 <mouse><key><shift/><mid-drag/></key> <action>zoom into the area</action></mouse>
130 <keys><key><alt/>Z</key> <action>activate zoom field</action></keys>
131 <note>The zoom field in the lower left corner of the window allows you to specify zoom level precisely.</note>
132 </group>
134 <group>
135 <title>Preset zooms</title>
136 <keys><key>1</key>       <action>zoom 1:1</action></keys>
137 <keys><key>2</key>      <action>zoom 1:2</action></keys>
138 <keys><key>3</key>      <action>zoom to selection</action></keys>
139 <keys><key>4</key>      <action>zoom to drawing</action></keys>
140 <keys><key>5</key>      <action>zoom to page</action></keys>
141 <keys><key><ctrl/>E</key><key>6</key>   <action>zoom to page width</action></keys>
142 </group>
144 <group>
145 <title>Zoom history</title>
146 <keys><key>`</key> <action>(back quote) previous zoom </action></keys>
147 <keys><key><shift/>`</key> <action>next zoom</action></keys>
148 <note>With these keys, you can travel back and forth through the history of zooms in this session</note>
149 </group>
151 <group>
152 <title>Scroll (pan)</title>
153 <mouse><key><ctrl/><arrows/></key>  <action>scroll canvas</action></mouse>
154 <note>Scrolling by keys is accelerated, i.e. it speeds up when you press Ctrl+arrows in quick succession, or press and hold.</note>
155 <mouse><key><mid-drag/></key>  <action>pan canvas</action></mouse>
156 <mouse><key><shift/><right-drag/></key> <key><ctrl/><right-drag/></key> <action>pan canvas</action></mouse>
157 <mouse><key><wheel/></key> <action>scroll canvas vertically</action></mouse>
158 <note>When the "Mouse wheel zooms by default" option is on in Preferences, mouse wheel zooms instead of scrolling. To scroll, use Ctrl+wheel.</note>
159 <mouse><key><shift/><wheel/></key> <action>scroll canvas horizontally</action></mouse>
160 <note>When the "Left mouse button pans when Space is pressed" option is on in Preferences, Space+mouse drag also pans canvas.</note>
161 </group>
163 <group>
164 <title>Guides, grids, snapping</title>
165 <mouse><key><left-drag/></key> <action>drag off a ruler to create guide</action></mouse>
166 <note>Drag off the horizontal or vertical ruler to create a new guideline. Drag a guideline onto the ruler to delete it.</note>
167 <keys><key>|</key> <key><shift/>\</key> <action>toggle guides and snapping to guides</action></keys>
168 <note>If you want to see the guides but not snap to them, use the global snapping toggle (% key).</note>
169 <note>When you create a new guide by dragging off the ruler, guide visibility and snapping are turned on.</note>
170 <keys><key>#</key> <key><shift/>3</key> <action>toggle grids and snapping to grids</action></keys>
171 <note>If you want to see the grids but not snap to them, use the global snapping toggle (% key).</note>
172 <note>Note that only the 3 key on the main keyboard works, not on the keypad.</note>
173 <keys><key>%</key> <action>toggle snapping on and off</action></keys>
174 <note>This toggle affects snapping to grids, guides, and objects in all tools.</note>
175 </group>
177 <group>
178 <title>Display mode</title>
179 <keys><key><ctrl/><misc-wide f="keypad 5"/></key>  <action>toggle normal/outline mode</action></keys>
180 </group>
181 </section>
183 *<section title="Palette" color="efcfdf">
184 <group>
185 <note>These keys work both in the floating palette dialog and in the palette frame at the bottom of the window.</note>
186 <mouse><key><left-click/></key> <action>set fill color on selection</action></mouse>
187 <mouse><key><shift/><left-click/></key> <action>set stroke color on selection</action></mouse>
188 <mouse><key><right-click/></key> <action>set stroke color on selection</action></mouse>
189 <mouse><key><left-drag/></key> <action>drag fill color to objects</action></mouse>
190 <mouse><key><shift/><left-drag/></key> <action>drag stroke color to objects</action></mouse>
191 <note>To change fill/stroke of an object by dragging color on it, that object need not be selected.</note>
192 <note>You can also drag colors to the Fill (F) and Stroke (S) indicators in the statusbar to change the selection.</note>
193 </group>
194 </section>
197 </column>
203 <column>
205 *<section title="File" color="f3f2e2">
207 <group>
208 <keys><key><ctrl/>N</key>        <action>create new document</action></keys>
209 <keys><key><ctrl/>O</key>        <action>open an SVG document</action></keys>
210 <keys><key><shift/><ctrl/>E</key>        <action>export to PNG</action></keys>
211 <keys><key><ctrl/>I</key>        <action>import bitmap or SVG</action></keys>
212 <keys><key><ctrl/>P</key>        <action>print document</action></keys>
213 <keys><key><ctrl/>S</key>        <action>save document</action></keys>
214 <keys><key><shift/><ctrl/>S</key>        <action>save under a new name</action></keys>
215 <keys><key><shift/><ctrl/><alt/>S</key>  <action>save a copy</action></keys>
216 <keys><key><ctrl/>Q</key>        <action>exit Inkscape</action></keys>
217 </group>
219 </section>
221 *<section title="Window" color="e8fae1">
223 <group>
224 <keys><key><ctrl/>R</key> <action>toggle rulers</action></keys>
225 <keys><key><ctrl/>B</key> <action>toggle scrollbars</action></keys>
226 <keys><key><keyf f="F11"/></key> <action>toggle fullscreen</action></keys>
227 </group>
229 <group>
230 <keys><key><keyf f="F10"/></key> <action>main menu</action></keys>
231 <note>Menus can also be activated by Alt with the letter underscored in the menu name.</note>
232 <keys><key><shift/><keyf f="F10"/></key> <key><right-click/></key> <action>drop-down (context) menu</action></keys>
233 </group>
235 <group>
236 <keys><key><ctrl/><keyf f="F4"/></key> <key><ctrl/>W</key>       <action>close document window</action></keys>
237 <note>This shuts down Inkscape if it was the only document window open.</note>
238 <keys><key><ctrl/><misc f="Tab"/></key> <action>next document window</action></keys>
239 <keys><key><shift/><ctrl/><misc f="Tab"/></key> <action>previous document window</action></keys>
240 <note>These cycle through the active document windows forward and backward.</note>
241 </group>
243 </section>
245 *<section title="Layers" color="f6f9d9">
246 <group>
247 <keys><key><shift/><misc f="PgUp"/></key> <action>move to layer above</action></keys>
248 <keys><key><shift/><misc f="PgDn"/></key> <action>move to layer below</action></keys>
249 <note>These commands move the selected objects from one layer to another.</note>
251 <keys><key><shift/><ctrl/><misc f="PgUp"/></key> <action>raise layer</action></keys>
252 <keys><key><shift/><ctrl/><misc f="PgDn"/></key> <action>lower layer</action></keys>
253 <keys><key><shift/><ctrl/><misc f="Home"/></key> <action>raise layer to top</action></keys>
254 <keys><key><shift/><ctrl/><misc f="End"/></key> <action>lower layer to bottom</action></keys>
255 <note>These commands move the current layer among its siblings (normally other layers).</note>
256 </group>
257 </section>
260 *<section title="Object" color="f4ecf5">
262 <group>
263 <title>Undo/redo</title>
264 <keys><key><shift/><ctrl/>Y</key> <key><ctrl/>Z</key>    <action>undo</action></keys>
265 <keys><key><shift/><ctrl/>Z</key> <key><ctrl/>Y</key>    <action>redo</action></keys>
266 </group>
268 <group>
269 <title>Clipboard</title>
270 <keys><key><ctrl/>C</key>        <action>copy selection</action></keys>
271 <note>This places a copy of the selection to the Inkscape clipboard. Text from text objects is also placed onto the system clipboard.</note>
272 <keys><key><ctrl/>X</key>        <action>cut selection</action></keys>
273 <note>This works the same as "copy selection" followed by deleting the selection.</note>
274 <keys><key><ctrl/>V</key>        <action>paste clipboard</action></keys>
275 <note>This places the clipboard objects at the mouse cursor, or at the center of the window if mouse is outside the canvas.</note>
276 <note>When editing text with the text tool, this pastes the text from the system clipboard into the current text object.</note>
277 <keys><key><ctrl/><alt/>V</key>  <action>paste in place</action></keys>
278 <note>This places the clipboard objects to the original location from which they were copied.</note>
279 <keys><key><shift/><ctrl/>V</key>  <action>paste style</action></keys> 
280 <note>This applies the style of the (first of the) copied object(s) to the current selection.</note>
281 <note>If a gradient handle (in Gradient tool) or a text span (in Text tool) are selected, they get the style instead of the entire object.</note>
282 <keys><key><ctrl/>7</key>  <action>paste path effect</action></keys> 
283 <note>This applies the path effect of the copied path to the paths/shapes in current selection.</note>
284 </group>
286 <group>
287 <title>Duplicate</title>
288 <keys><key><ctrl/>D</key>        <action>duplicate selection</action></keys> 
289 <note>New object(s) are placed exactly over the original(s) and selected.</note>
290 </group>
292 <group>
293 <title>Clone</title>
294 <keys><key><alt/>D</key>         <action>clone object</action></keys> 
295 <note>A clone can be moved/scaled/rotated/skewed independently, but it updates the path, fill, and stroke from its original.</note>
296 <note>The clone is placed exactly over the original object and is selected.</note>
297 <note>You can only clone one object at a time; if you want to clone several objects together, group them and clone the group.</note>
298 <keys><key><shift/><alt/>D</key>         <action>unlink clone</action></keys> 
299 <note>Unlinking a clone cuts the link to the original, turning the clone into a plain copy.</note>
300 <keys><key><shift/>D</key>       <action>select original</action></keys> 
301 <note>To find out which object this is a clone of, select the clone and give this command. The original will be selected.</note>
302 </group>
304 <group>
305 <title>Bitmaps</title>
306 <keys><key><alt/>B</key> <action>create a bitmap copy</action></keys>
307 <note>This exports the selected object(s) (all other objects hidden) as PNG in the document's directory and imports it back.</note>
308 <note>The imported bitmap is placed over the original selection and is selected.</note>
309 <keys><key><shift/><alt/>B</key> <action>trace bitmap</action></keys>
310 <note>This opens the Trace Bitmap dialog allowing you to convert a bitmap object to path(s).</note> 
311 </group>
313 <group>
314 <title>Patterns</title>
315 <keys><key><alt/>I</key>         <action>object(s) to pattern</action></keys> 
316 <note>This converts the selection to a rectangle with tiled pattern fill.</note>
317 <keys><key><shift/><alt/>I</key>         <action>pattern to object(s)</action></keys> 
318 <note>Each selected object with pattern fill is broken into the same object without fill and a single pattern object.</note>
319 </group>
321 <group>
322 <title>Group</title>
323 <keys> <key><shift/><ctrl/>U</key>  <key><ctrl/>G</key> <action>group selected objects</action></keys>
324 <note>Use Ctrl+click to select objects within group.</note>
325 <keys><key><shift/><ctrl/>G</key> <key><ctrl/>U</key>  <action>ungroup selected group(s)</action></keys>
326 <note>This removes only one level of grouping; press Ctrl+U repeatedly to ungroup nested groups.</note>
327 </group>
329 <group>
330 <title>Z-order</title>
331 <keys><key><misc f="Home"/></key>        <action>raise selection to top</action></keys>
332 <keys><key><misc f="End"/></key>         <action>lower selection to bottom</action></keys>
333 <keys><key><misc f="PgUp"/></key>        <action>raise selection one step</action></keys>
334 <keys><key><misc f="PgDn"/></key>      <action>lower selection one step</action></keys>
335  </group>
337 </section>
339 *<section title="Path" color="f9f1d9">
341 <group>
342 <title>Convert to path</title>
343 <keys><key><shift/><ctrl/>C</key> <action>convert selected object(s) to path</action></keys>
344 <keys><key><ctrl/><alt/>C</key> <action>convert stroke to path</action></keys>
345 </group>
347 <group>
348 <title>Boolean operations</title>
349 <keys><key><ctrl/>+</key>  <action>union</action></keys>
350 <note>Union combines any number of objects into a single path, removing overlaps.</note>
351 <keys><key><ctrl/>-</key>  <action>difference</action></keys>
352 <note>Difference works on 2 objects, extracting the top from the bottom.</note>
353 <keys><key><ctrl/>*</key>  <action>intersection</action></keys>
354 <note>Intersection creates a path representing the common (overlapping) area of all selected objects.</note>
355 <keys><key><ctrl/>^</key>  <action>exclusive OR (XOR)</action></keys>
356 <note>XOR is similar to Union, except that it works on 2 objects and removes areas where the objects overlap.</note>
357 <keys><key><ctrl/>/</key>  <action>division (cut)</action></keys>
358 <note>Division cuts the bottom object into pieces by the top object, preserving the fill and stroke of the bottom.</note>
359 <keys><key><ctrl/><alt/>/</key>  <action>cut path</action></keys>
360 <note>Cut Path cuts the bottom object's stroke only where it is intersected by the top path, removing any fill from the result.</note>
361 <note>The result of Union, Difference, Intersection, and XOR inherits the id= attribute and therefore the clones of the bottom object.</note>
362 <note>Division and Cut path normally produce several objects; of them, a random one inherits the id= of the bottom source object.</note>
363 </group>
365 <group>
366 <title>Offsets</title>
367 <keys><key><ctrl/>(</key>  <action>inset path (towards center)</action></keys>
368 <keys><key><ctrl/>)</key>  <action>outset path (away from center)</action></keys>
369 <note>The default offset distance is 2 px (SVG pixel units, not screen pixels).</note>
370 <keys><key><alt/>(</key>  <action>inset path by 1 pixel</action></keys>
371 <keys><key><alt/>)</key>  <action>outset path by 1 pixel</action></keys>
372 <keys><key><shift/><alt/>(</key>  <action>inset path by 10 pixels</action></keys>
373 <keys><key><shift/><alt/>)</key>  <action>outset path by 10 pixels</action></keys>
374 <note>The actual distance for pixel offsets depends on zoom level. Zoom in for finer adjustment.</note>
375 <note>All the (, ) commands convert the object to path, if necessary, and produce regular path.</note>
376 <keys><key><ctrl/>J</key>  <action>create dynamic offset</action></keys>
377 <keys><key><ctrl/><alt/>J</key>  <action>create linked offset</action></keys>
378 <note>These commands produce an offset object, editable by the node tool, standalone or linked to the original.</note>
379 <keys><key><shift/>D</key>       <action>select source</action></keys> 
380 <note>Selecting a linked offset and giving this command will select the source path of the linked offset.</note>
381 </group>
383 <group>
384 <title>Combine</title>
385 <keys><key><ctrl/>K</key>  <action>combine paths</action></keys>
386 <note>This is different from grouping in that combined paths create one object.</note>
387 <note>This is different from Union in that overlapping areas are not affected.</note>
388 <note>Whether overlapping areas are filled is controlled by the Fill: winding/alternating switch on the Fill &amp; Stroke dialog.</note>
389 <keys><key><shift/><ctrl/>K</key>  <action>break paths apart</action></keys>
390 <note>This attempts to break an object into constituent paths; it will fail if the object is one solid path.</note>
391 </group>
393 <group>
394 <title>Simplify</title>
395 <keys><key><ctrl/>L</key>  <action>simplify</action></keys>
396 <note>This command attempts to simplify selected path(s) by removing extra nodes. It converts all objects to paths first.</note>
397 <note>If you invoke this command several times in quick succession, it will act more and more aggressively.</note>
398 <note>Invoking Simplify again after a pause restores the default threshold (settable in the Inkscape Preferences dialog).</note>
399 </group>
401 </section>
403 </column>
405 <column>
407 *<section title="Selector" color="eee4dc">
409 <group>
410 <title>Select (mouse)</title>
411 <mouse><key><left-click/></key> <action>select an object</action></mouse>
412 <note>When you left-click on an object, previous selection is deselected.</note>
413 <mouse><key><shift/><left-click/></key> <action>toggle selection </action></mouse>
414 <note>Shift+click adds an object to the current selection if it was not selected, or deselects it otherwise.</note>
415 <mouse><key><left-click/><left-click/></key> <action>edit the object</action></mouse>
416 <note>For paths, double clicking switches to Node tool; for shapes, to corresponding shape tool; for text, to Text tool.</note>
417 <note>For groups, double clicking performs the "Enter group" command (the group becomes temporary layer).</note>
418 <note>Double clicking in empty space swithes to the parent layer in the hierarchy, if any.</note>
419 </group>
421 <group>
422 <title>Rubberband, touch selection</title>
423 <mouse><key><left-drag/></key> <action>select by rubberband</action></mouse>
424 <note>Dragging around objects does "rubberband" selection; previous selection is deselected.</note>
425 <mouse><key><shift/><left-drag/></key> <action>add objects to selection</action></mouse>
426 <note>Normally, you need to start from an empty space to initiate a rubberband.</note> 
427 <note>However, if you press Shift before dragging, Inkscape will do rubberband selection even if you start from an object.</note>
428 <mouse><key><alt/><left-drag/></key><key><shift/><alt/><left-drag/></key> <action>select by touch</action></mouse>
429 <note>Alt+dragging over objects selects those objects that are touched by the path.</note>
430 <note>To start touch selection with Alt, you must have nothing selected; otherwise use Shift+Alt.</note>
431 <note>You can switch rubberband selection to touch selection and back while dragging by pressing/releasing Alt.</note>
432 </group>
434 <group>
435 <title>Select (keyboard)</title>
436 <keys><key><misc f="Tab"/></key>  <action>select next object </action></keys>
437 <keys><key><shift/><misc f="Tab"/></key> <action>select previous object </action></keys>
438 <note>These keys pick objects in their z-order (Tab cycles from bottom to top, Shift+Tab cycles from top to bottom).</note> 
439 <note>Unless you did manual rearrangements, the last object you created is always on top.</note> 
440 <note>As a result, if nothing is selected, pressing Shift+Tab once conveniently selects the object you created last.</note>
441 <note>This works on objects within the current layer (unless you change that in preferences).</note>
442 <keys><key><ctrl/>A</key>        <action>select all (current layer)</action></keys>
443 <note>This works on objects within the current layer (unless you change that in preferences).</note>
444 <keys><key><ctrl/><alt/>A</key>  <action>select all (all layers)</action></keys>
445 <note>This works on objects in all visible and unlocked layers.</note>
446 <keys><key>!</key> <action>invert selection (current layer)</action></keys>
447 <note>This inverts selection (deselects what was selected and vice versa) in the current layer.</note>
448 <keys><key><alt/>!</key> <action>invert selection (all layers)</action></keys>
449 <note>This inverts selection (deselects what was selected and vice versa) in visible and unlocked layers.</note>
450 <keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
451 <keys><key><misc-wide f="Backspace"/></key><key><misc f="Del"/></key>    <action>delete selection</action></keys>
452 </group>
454 <group>
455 <title>Select within group, select under</title>
456 <mouse><key><ctrl/><left-click/></key> <action>select within group</action></mouse>
457 <note>Ctrl+click selects the object at click point disregarding any levels of grouping that this object might belong to.</note>
458 <mouse><key><ctrl/><shift/><left-click/></key> <action>toggle selection within group</action></mouse>
459 <mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
460 <note>Alt+click selects the object at click point which is beneath (in z-order) the lowest selected object at click point.</note>
461 <note>If the bottom object is reached, Alt+click again selects the top object. So, several Alt+clicks cycle through z-order stack at point.</note>
462 <note>On Linux, Alt+click and Alt+drag may be reserved by the window manager.  If you reconfigure your window manager </note>
463 <note>to not map Alt+click, then it will be free for Inkscape to use.  </note>
464 <note>If your keyboard has a Meta key, you may wish to set your "Modifier
465 key" to use it instead of Alt.</note>
466 <note>(Sometimes you can also use Ctrl+Alt+click (select under in
467 groups) with the same effect as Alt+click.)</note>
468 <mouse><key><shift/><alt/><left-click/></key> <action>toggle under</action></mouse>
469 <mouse><key><ctrl/><alt/><left-click/></key> <action>select under, in groups</action></mouse>
470 <mouse><key><shift/><ctrl/><alt/><left-click/></key> <action>toggle under, in groups</action></mouse>
471 <keys><key><ctrl/><misc-wide f="Enter"/></key> <action>enter group</action></keys>
472 <keys><key><ctrl/><misc-wide f="Backspace"/></key>       <action>go to parent group/layer</action></keys>
473 </group>
475 <group>
476 <title>Move (mouse)</title>
477 <mouse><key><left-drag/></key> <action>select + move</action></mouse>
478 <note>Dragging an object selects it if it was not selected, then moves selection.</note>
479 <mouse><key><alt/><left-drag/></key> <action>move selected</action></mouse>
480 <note>Alt+drag moves the current selection (without selecting what is under cursor), no matter where you start the drag.</note>
481 <note>On Linux, Alt+click and Alt+drag may be reserved by the window manager. Reconfigure it so you can use them in Inkscape.</note>
482 <mouse><key><ctrl/><left-drag/></key> <action>restrict movement to horizontal or vertical</action></mouse>
483 <mouse><key><shift/><left-drag/></key> <action>temporarily disable snapping</action></mouse>
484 <note>This temporaily disables snapping to grid or guides when you are dragging with grid or guides on.</note>
485 <mouse><key><left-drag/><misc-wide f="Space"/></key> <action>drop a copy</action></mouse>
486 <note>When dragging or transforming with mouse, each Space leaves a copy of the selected object.</note> 
487 <note>You can press and hold Space while dragging for a nice "trail."</note>
488 </group>
490 <group>
491 <title>Move (keyboard)</title>
492 <mouse><key><arrows/></key>  <action>move selection by the nudge distance</action></mouse>
493 <mouse><key><shift/><arrows/></key>  <action>move selection by 10x nudge distance</action></mouse>
494 <note>The default nudge distance is 2 px (SVG pixel units, not screen pixels).</note>
495 <mouse><key><alt/><arrows/></key>  <action>move selection by 1 pixel</action></mouse>
496 <mouse><key><alt/><shift/><arrows/></key>  <action>move selection by 10 pixels</action></mouse>
497 <note>The actual distance for pixel movements depends on zoom level. Zoom in for finer movement.</note>
498 </group>
500 <group>
501 <title>Transform (mouse)</title>
502 <mouse><key><left-click/></key><key><shift/>S</key> <action>toggle scale/rotation handles</action></mouse>
503 <mouse><key><left-drag/></key> <action>scale (with scale handles)</action></mouse>
504 <mouse><key><left-drag/></key> <action>rotate or skew (with rotation handles)</action></mouse>
505 </group>
507 <group>
508 <title>Scale by handles</title>
509 <mouse><key><left-drag/></key> <action>scale</action></mouse>
510 <mouse><key><ctrl/><left-drag/></key> <action>scale preserving aspect ratio</action></mouse>
511 <mouse><key><shift/><left-drag/></key> <action>symmetric transformation</action></mouse>
512 <note>Holding Shift while transforming makes transformation symmetric around the center of the selection.</note>
513 <!-- FIXME: why not disable snapping? inconsistent! -->
514 <mouse><key><alt/><left-drag/></key> <action>scale by integer</action></mouse>
515 <note>Hold Alt while scaling to limit scale to 2, 3, 4, etc. or 1/2, 1/3, 1/4 etc. of the initial size.</note>
516 </group>
518 <group>
519 <title>Scale (keyboard)</title>
520 <keys><key>.</key> <key>&gt;</key> <action>scale selection up by the scale step</action></keys> 
521 <keys><key>,</key> <key>&lt;</key> <action>scale selection down by the scale step</action></keys> 
522 <note>The default scale step is 2 px (SVG pixel units, not screen pixels).</note>
523 <keys><key><ctrl/>.</key> <key><ctrl/>&gt;</key> <action>scale selection to 200%</action></keys>
524 <keys><key><ctrl/>,</key> <key><ctrl/>&lt;</key> <action>scale selection to 50%</action></keys>
525 <keys><key><alt/>.</key> <key><alt/>&gt;</key> <action>scale selection up by 1 pixel</action></keys>
526 <keys><key><alt/>,</key> <key><alt/>&lt;</key> <action>scale selection down by 1 pixel</action></keys>
527 <note>The actual size increment for pixel scaling depends on zoom level. Zoom in for finer scaling.</note>
528 <note>Scaling is uniform around the center, so that the size increment applies to the larger of the two dimensions.</note>
529 </group>
531 <group>
532 <title>Rotate/skew by handles</title>
533 <mouse><key><left-drag/></key> <action>rotate or skew</action></mouse>
534 <mouse><key><ctrl/><left-drag/></key> <action>snap skew angle</action></mouse>
535 <note>Holding Ctrl when dragging a skew (non-corner) handle snaps the skew angle to angle steps (default 15 degrees).</note>
536 <mouse><key><ctrl/><left-drag/></key> <action>snap rotation angle</action></mouse>
537 <note>Holding Ctrl when dragging a rotation (corner) handle snaps the rotation angle to angle steps (default 15 degrees).</note>
538 </group>
540 <group>
541 <title>Rotate (keyboard)</title>
542 <keys><key>[</key> <key>]</key> <action>rotate selection by the angle step</action></keys> 
543 <note>The default angle step is 15 degrees. ] rotates clockwise, [ rotates counterclockwise.</note>
544 <keys><key><ctrl/>[</key> <key><ctrl/>]</key> <action>rotate selection by 90 degrees</action></keys>
545 <keys><key><alt/>[</key> <key><alt/>]</key> <action>rotate selection by 1 pixel</action></keys>
546 <note>The actual angle for pixel rotation depends on zoom level. Zoom in for finer movement.</note>
547 <note>These commands use the rotation center, draggable in Selector (by default it's in geometric center).</note>
548 </group>
550 <group>
551 <title>Flip</title>
552 <keys><key>h</key> <action>flip selection horizontally</action></keys>
553 <keys><key>v</key> <action>flip selection vertically</action></keys>
554 <note>If the tool is in rotate mode (rotation center visible), that center becomes the axis of flipping; otherwise it flips around geometric center of selection</note>
555 </group>
557 <group>
558 <title>Rotation center</title>
559 <mouse><key><left-drag/></key> <action>move rotation center</action></mouse>
560 <note>Moved rotation center remembers and saves its position for (all) selected object(s); you can reset it.</note>
561 <note>Dragging the center snaps it to the centerlines and bounding box edges of the selection.</note>
562 <mouse><key><shift/><left-drag/></key> <action>move without snapping</action></mouse>
563 <mouse><key><shift/><left-click/></key> <action>reset rotation center</action></mouse>
564 <note>Resetting rotation center moves it back to the geometric center of the object's or selection's bounding box.</note>
565 </group>
567 <group>
568 <title>Cancel</title>
569 <keys><key><misc f="Esc"/></key> <action>cancel rubberband, move, transformation</action></keys>
570 <note>Press Esc while mouse button is still down to cancel rubberband selection, move, or transformation of any kind.</note>
571 </group>
573 </section>
575 </column>
577 <column>
578 *<section title="Node tool" color="f9f1d9">
580 <group>
581 <title>Select objects (mouse)</title>
582 <mouse><key><left-click/></key> <action>click a non-selected object to select</action></mouse>
583 <mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
584 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
585 <note>These work the same as in Selector. The nodes or handles of the single selected object become editable.</note>
586 </group>
588 <group>
589 <title>Select nodes (mouse)</title>
590 <mouse><key><left-click/></key> <action>select a node</action></mouse> 
591 <note>Clicking on a node selects it.</note>
592 <mouse><key><left-click/></key> <action>select two adjacent nodes</action></mouse> 
593 <note>Clicking on a selected path between the nodes selects the two nodes closest to the click point.</note>
594 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
595 <note>This adds/removes a node (if clicked on node) or two nodes (if clicked on path) to/from the node selection.</note>
596 <mouse><key><left-click/></key> <action>deselect</action></mouse> 
597 <note>Clicking in an empty space deselects all selected nodes. Next click will deselect the object.</note>
598 </group>
600 <group>
601 <title>Rubberband selection</title>
602 <mouse><key><left-drag/></key> <action>select multiple nodes</action></mouse>
603 <note>Dragging around nodes does "rubberband" selection; previous node selection is deselected.</note>
604 <mouse><key><shift/><left-drag/></key> <action>add nodes to selection</action></mouse>
605 <note>Normally, you need to start from a point not over a path or a node to initiate a rubberband.</note> 
606 <note>However, if you press Shift before dragging, Inkscape will do rubberband selection even if you start over the path.</note>
607 </group>
609 <group>
610 <title>Select nodes (keyboard)</title>
611 <keys><key><misc f="Tab"/></key>  <action>select next node</action></keys> 
612 <keys><key><shift/><misc f="Tab"/></key> <action>select previous node</action></keys>
613 <note>These keys select nodes within the selected path</note>
614 <keys><key><ctrl/>A</key>        <action>select all nodes in subpath(s)</action></keys>
615 <note>If the path has multiple subpaths and some nodes selected, this selects all only in subpaths with already selected nodes.</note>
616 <keys><key><ctrl/><alt/>A</key>  <action>select all nodes in path</action></keys>
617 <note>This selects all nodes in the entire path.</note>
618 <keys><key>!</key> <action>invert selection in subpath(s)</action></keys>
619 <note>If the path has multiple subpaths and some nodes selected, this inverts selection only in subpaths with already selected nodes.</note>
620 <keys><key><alt/>!</key> <action>invert selection in path</action></keys>
621 <note>This inverts selection (deselects what was selected and vice versa) in the entire path.</note>
622 <keys><key><misc f="Esc"/></key> <action>deselect all nodes</action></keys>
623 </group>
625 <group>
626 <title>Grow/shrink node selection</title>
627 <keys><key><misc f="PgUp"/></key> <key><misc f="PgDn"/></key> <action>grow/shrink selection (spatial)</action></keys>
628 <mouse><key><wheel/></key> <action>grow/shrink selection (spatial)</action></mouse>
629 <keys><key><ctrl/><misc f="PgUp"/></key> <key><ctrl/><misc f="PgDn"/></key> <action>grow/shrink selection (along path)</action></keys>
630 <mouse><key><ctrl/><wheel/></key> <action>grow/shrink selection (along path)</action></mouse>
631 <note>Your mouse pointer must be over a node for growing/shrinking.</note>
632 <note>Each key press or wheel click selects the nearest unselected node or deselects the farthest selected node.</note>
633 <note>Distance to nodes can be calculated directly (spatial mode) or along path.</note>
634 </group>
636 <group>
637 <title>Move nodes (mouse)</title>
638 <mouse><key><left-drag/></key> <action>move selected nodes</action></mouse>
639 <mouse><key><ctrl/><left-drag/></key> <action>restrict movement to horizontal or vertical</action></mouse>
640 <mouse><key><ctrl/><alt/><left-drag/></key> <action>move along handles</action></mouse>
641 <note>This restricts movement to the directions of the node's handles, their continuations and perpendiculars (total 8 snaps).</note>
642 <note>If the node has straight lines on one or both sides, this will snap it to these lines' directions and perpendiculars instead.</note>
643 <mouse><key><shift/><left-drag/></key> <action>temporarily disable snapping</action></mouse>
644 <note>Snapping nodes is enabled in Document Preferences. By default, only bounding box of objects snaps to grid/guides.</note>
645 <mouse><key><shift/><left-drag/></key> <action>drag out handle</action></mouse>
646 <note>If a node has a retracted handle, dragging with Shift lets you drag it out of the node.</note>
647 <mouse><key><left-drag/><misc-wide f="Space"/></key> <action>drop a copy</action></mouse>
648 <note>When dragging nodes with mouse, each Space leaves a copy of the selected object.</note> 
649 <note>You can press and hold Space while dragging for a nice "trail."</note>
650 <mouse><key><alt/><left-drag/></key>  <action>sculpt selected nodes</action></mouse>
651 <note>Sculpting moves the selected nodes so that the dragged node moves all the way, the farthest selected nodes stay put;</note>
652 <note>all intermediate selected nodes move intermediate distances, governed by a bell-like curve.</note>
653 <note>Sculpting is pressure-sensitive with a tablet; press harder for a blunter drag profile, press lightly for a sharper profile.</note>
654 <note>To stop sculpting without losing the pressure-sensitive profile, release Alt first and then lift the pen.</note>
655 </group>
657 <group>
658 <title>Move nodes (keyboard)</title>
659 <mouse><key><arrows/></key>  <action>move selected node(s) by the nudge distance</action></mouse>
660 <mouse><key><shift/><arrows/></key>  <action>move selected node(s) by 10x nudge distance</action></mouse>
661 <note>The default nudge distance is 2 px (SVG pixel units, not screen pixels).</note>
662 <mouse><key><alt/><arrows/></key>  <action>move selected node(s) by 1 pixel</action></mouse>
663 <mouse><key><alt/><shift/><arrows/></key>  <action>move selected node(s) by 10 pixels</action></mouse>
664 <note>The actual distance for pixel movements depends on zoom level. Zoom in for finer movement.</note>
665 </group>
667 <group>
668 <title>Move node handle (mouse)</title>
669 <mouse><key><left-drag/></key> <action>move a node handle</action></mouse>
670 <mouse><key><ctrl/><left-drag/></key> <action>snap the handle to angle steps</action></mouse>
671 <note>The default angle step is 15 degrees. This also snaps to the handle's original angle, its continuation and perpendiculars.</note>
672 <mouse><key><shift/><left-drag/></key> <action>rotate both handles</action></mouse> 
673 <mouse><key><alt/><left-drag/></key> <action>lock the handle length</action></mouse>
674 <note>Ctrl, Shift, Alt can be combined when dragging handles.</note>
675 <mouse><key><ctrl/><left-click/></key> <action>retract the handle</action></mouse>
676 <note>Retracted handle is zero length; use Shift+drag to drag it back out.</note>
677 </group>
679 <group>
680 <title>Scale handle (1 node selected)</title>
681 <keys><key>&lt;</key> <key>&gt;</key> <action>contract/expand both handles by scale step</action></keys> 
682 <note>The default scale step is 2 px (SVG pixel units, not screen pixels). May apply to more than one node.</note>
683 <keys>
684 <key><left/><ctrl/>&lt;</key> 
685 <key><left/><ctrl/>&gt;</key> 
686 <action>scale left handle by the scale step</action>
687 </keys>
688 <keys>
689 <key><right/><ctrl/>&lt;</key> 
690 <key><right/><ctrl/>&gt;</key> 
691 <action>scale right handle by the scale step</action>
692 </keys>
693 <keys>
694 <key><left/><alt/>&lt;</key> 
695 <key><left/><alt/>&gt;</key> 
696 <action>scale left handle by 1 pixel</action>
697 </keys>
698 <keys>
699 <key><right/><alt/>&lt;</key> 
700 <key><right/><alt/>&gt;</key> 
701 <action>scale right handle by 1 pixel</action>
702 </keys>
703 <note>The actual size increment for pixel scaling depends on zoom level. Zoom in for finer scaling.</note>
704 <note>Instead of the &lt; and &gt; keys, you can use the , (comma) and . (period) keys respectively.</note>
705 </group>
707 <group>
708 <title>Rotate handle (1 node selected)</title>
709 <keys><key>[</key> <key>]</key> <action>rotate both handles by the angle step</action></keys>
710 <note>The default angle step is 15 degrees. ] rotates clockwise, [ rotates counterclockwise. May apply to more than one node.</note>
711 <keys><key><left/><ctrl/>[</key> <key><left/><ctrl/>]</key> <action>rotate left handle by the angle step</action></keys>
712 <keys><key><right/><ctrl/>[</key> <key><right/><ctrl/>]</key> <action>rotate right handle by the angle step</action></keys>
713 <keys><key><left/><alt/>[</key> <key><left/><alt/>]</key> <action>rotate left handle by 1 pixel</action></keys>
714 <keys><key><right/><alt/>[</key> <key><right/><alt/>]</key> <action>rotate right handle by 1 pixel</action></keys>
715 </group>
718 <group>
719 <title>Scale nodes (&gt;1 nodes selected)</title>
720 <note>These commands scale the selected nodes as if they were an "object".</note>
721 <note>If mouse is over a node, that node becomes the axis of scaling; otherwise it scales around geometric center of selected nodes.</note>
722 <keys><key>.</key> <key>&gt;</key> <action>scale nodes up by the scale step</action></keys> 
723 <keys><key>,</key> <key>&lt;</key> <action>scale nodes down by the scale step</action></keys> 
724 <note>The default scale step is 2 px (SVG pixel units, not screen pixels).</note>
725 <keys><key><alt/>.</key> <key><alt/>&gt;</key> <action>scale nodes up by 1 pixel</action></keys>
726 <keys><key><alt/>,</key> <key><alt/>&lt;</key> <action>scale nodes down by 1 pixel</action></keys>
727 <note>The actual size increment for pixel scaling depends on zoom level. Zoom in for finer scaling.</note>
728 <note>Scaling is uniform around the center, so that the size increment applies to the larger of the two dimensions.</note>
729 </group>
731 <group>
732 <title>Rotate nodes (&gt;1 nodes selected)</title>
733 <note>These commands rotate the selected nodes as if they were an "object".</note>
734 <note>If mouse is over a node, that node becomes the axis of rotation; otherwise it rotates around geometric center of selected nodes.</note>
735 <keys><key>[</key> <key>]</key> <action>rotate nodes by the angle step</action></keys> 
736 <note>The default angle step is 15 degrees. ] rotates clockwise, [ rotates counterclockwise.</note>
737 <keys><key><alt/>[</key> <key><alt/>]</key> <action>rotate nodes by 1 pixel</action></keys>
738 <note>The actual angle for pixel rotation depends on zoom level. Zoom in for finer movement.</note>
739 </group>
741 <group>
742 <title>Flip nodes (&gt;1 nodes selected)</title>
743 <note>These commands flip the selected nodes as if they were an "object", around the center of that object.</note>
744 <keys><key>h</key> <action>flip nodes horizontally</action></keys>
745 <keys><key>v</key> <action>flip nodes vertically</action></keys>
746 <note>If mouse is over a node, that node becomes the axis of flipping; otherwise it flips around geometric center of selected nodes</note>
747 </group>
749 <group>
750 <title>Change segment(s)</title>
751 <keys><key><shift/>L</key>  <action>make line</action></keys>
752 <keys><key><shift/>U</key>  <action>make curve</action></keys>
753 <note>These commands require that more than two adjacent nodes be selected.</note>
754 </group>
756 <group>
757 <title>Change node type</title>
758 <keys><key><shift/>C</key>  <action>make cusp</action></keys>
759 <keys><key><shift/>S</key>  <action>make smooth</action></keys>
760 <keys><key><shift/>Y</key>  <action>make symmetric</action></keys>
761 <note>When making smooth or symmetric, you can lock the position of one of the handles by hovering mouse over it.</note>
762 <mouse><key><ctrl/><left-click/></key> <action>toggle smooth/cusp/symmetric</action></mouse>
763 </group>
765 <group>
766 <title>Join/break</title>
767 <keys><key><shift/>J</key>  <action>join selected nodes</action></keys>
768 <note>This requires that exactly two end nodes within the path be selected.</note>
769 <note>You can lock the position of one of the two joined nodes by hovering mouse over it.</note>
770 <keys><key><shift/>B</key>  <action>break selected node(s)</action></keys>
771 <note>After break, only one of each two new nodes is selected. May apply to more than one node.</note>
772 </group>
774 <group>
775 <title>Delete, create, duplicate</title>
776 <keys><key><misc-wide f="Backspace"/></key><key><misc f="Del"/></key> <action>delete selected node(s)</action></keys>
777 <keys><key><ctrl/><misc-wide f="Backspace"/></key><key><ctrl/><misc f="Del"/></key> <action>delete without preserving shape</action></keys>
778 <note>Deleting without Ctrl adjusts handles on the remaining nodes to preserve the shape of the curve as much as possible.</note>
779 <note>Deleting with Ctrl does not touch the remaining nodes.</note>
780 <mouse><key><ctrl/><alt/><left-click/></key> <action>create/delete node</action></mouse>
781 <note>Ctrl+Alt+click on a node deletes it; Ctrl+Alt+click on the path between nodes creates a new node in the click point.</note>
782 <note>Deleting nodes this way always tries to preserve the shape of the curve (same as Del/Backspace).</note>
783 <mouse><key><left-click/><left-click/></key> <action>create node</action></mouse>
784 <note>Double clicking on the path between nodes creates a node in the click point.</note>
785 <keys><key><misc f="Ins"/></key> <action>insert new node(s)</action></keys>
786 <note>This adds new node(s) in the middle(s) of selected segment(s), so it requires that more than two adjacent nodes be selected.</note>
787 <keys><key><shift/>D</key> <action>duplicate selected node(s)</action></keys>
788 <note>New nodes are created on the same path; they are placed exactly over the old ones and are selected.</note>
789 </group>
791 <!-- does not seem to work
792 <group>
793 <title>Active node</title>
794 <note>The active node is one under mouse or being dragged.</note>
795 <note>When you have an active node, some of the single-letter tool switch shortcuts may not work;</note> 
796 <note>move your mouse cursor so that no node is active if you want to use them.</note>
797 <keys><key>c</key>  <action>make active node cusp</action></keys> 
798 <keys><key>s</key>  <action>make active node smooth</action></keys>
799 <keys><key>y</key>  <action>make active node symmetric</action></keys>
800 <keys><key>b</key>  <action>break active node</action></keys>
801 <keys><key><misc-wide f="Backspace"/></key> <action>delete active node</action></keys>
802 </group>
803 -->
806 <group>
807 <title>Reverse</title>
808 <keys><key><shift/>r</key>  <action>reverse path direction</action></keys> 
809 </group>
811 <group>
812 <title>Edit shapes</title>
813 <note>Node tool can also drag the handles of shapes (rectangles, ellipses, stars, spirals). Click on a shape to select it.</note> 
814 <note>See the corresponding shape tools for their editing shortcuts, all of which also work in node tool.</note>
815 </group>
817 <group>
818 <title>Cancel</title>
819 <keys><key><misc f="Esc"/></key> <action>cancel rubberband or move</action></keys>
820 <note>Press Esc while mouse button is still down to cancel rubberband selection, node move, handle move, or handle move.</note>
821 </group>
823 </section>
825 </column>
826 <column>
829 *<section title="Tweak tool" color="f2f1ea">
830 <group>
831 <title>Operation</title>
832 <mouse><key><left-drag/></key> <action>act on selected paths in the current mode</action></mouse>
833 <mouse><key><ctrl/><left-drag/></key> <action>act temporarily switching to shrink mode</action></mouse>
834 <mouse><key><ctrl/><shift/><left-drag/></key> <action>act temporarily switching to grow mode</action></mouse>
835 <note>The amount of tweaking action is the greatest at the center of the circular area and drops off smoothly towards the edges.</note>
836 </group>
838 <group>
839 <title>Modes</title>
840 <keys><key><shift/>p</key> <action>push mode</action></keys>
841 <keys><key><shift/>s</key> <action>shrink (inset) mode</action></keys>
842 <keys><key><shift/>g</key> <action>grow (outset) mode</action></keys>
843 <keys><key><shift/>a</key> <action>attract mode</action></keys>
844 <keys><key><shift/>e</key> <action>repel mode</action></keys>
845 <keys><key><shift/>r</key> <action>roughen mode</action></keys>
846 <keys><key><shift/>c</key> <action>color paint mode</action></keys>
847 <keys><key><shift/>j</key> <action>color jitter mode</action></keys>
848 </group>
850 <group>
851 <title>Parameters</title>
852 <mouse><key><left-arrow/></key> <key><right-arrow/></key> <action>adjust brush width by 1</action></mouse>
853 <mouse><key><misc f="Home"/></key> <key><misc f="End"/></key> <action>set brush width to 1 / 100</action></mouse>
854 <mouse><key><up/></key> <key><down/></key> <action>adjust tweaking force</action></mouse>
855 <note>Width and force can be adjusted while drawing. With a pressure-sensitive tablet, force also depends on pen pressure.</note>
856 </group>
858 </section>
861 *<section title="Rectangle tool" color="ebf1fd">
862 <group>
863 <title>Draw</title>
864 <mouse><key><left-drag/></key> <action>draw a rectangle</action></mouse>
865 <mouse><key><ctrl/><left-drag/></key>   <action>make a square or integer-ratio rectangle</action></mouse>
866 <note>This restricts rectangle so its height/width ratio is a whole number.</note>
867 <mouse><key><shift/><left-drag/></key> <action>draw around the starting point</action></mouse>
868 <note>This creates a rectangle symmetric around the starting point of the mouse drag.</note>
869 </group>
871 <group>
872 <title>Select</title>
873 <mouse><key><left-click/></key> <action>click to select</action></mouse>
874 <mouse><key><alt/><left-click/></key> <key><ctrl/><alt/><left-click/></key> <action>select under</action></mouse>
875 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
876 <note>In this tool, selecting by click disregards any grouping (i.e. acts as clicking with Ctrl in Selector)</note>
877 <keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
878 </group>
880 <group>
881 <title>Resize by handles</title>
882 <mouse><key><left-drag/></key> <action>drag a square handle to resize</action></mouse>
883 <note>Initially, the two resize (square) handles are in top left and bottom right corners.</note>
884 <note>Resize handles change the width and height of the rectangle in its own coordinate system, before any transforms are applied.</note>
885 <mouse><key><ctrl/><left-drag/></key> <action>lock width, height, or ratio</action></mouse>
886 </group>
888 <group>
889 <title>Round corners by handles</title>
890 <mouse><key><left-drag/></key> <action>drag a circular handle to round corners</action></mouse>
891 <note>Initially, the two rounding handles are in the top right corner of the rectangle.</note>
892 <mouse><key><ctrl/><left-drag/></key> <action>lock the corner circular</action></mouse>
893 <mouse><key><ctrl/><left-click/></key> <action>set the corner circular</action></mouse>
894 <note>When rounding corners, dragging one rounding handle keeps the corner circular if the other remains at the corner.</note>
895 <note>You can drag both handles for an elliptic rounded corner, or drag/click one with Ctrl to make it circular again.</note>
896 <mouse><key><shift/><left-click/></key> <action>remove corner rounding</action></mouse>
897 </group>
898 </section>
900 *<section title="3D box tool" color="cff4e2">
901 <group>
902 <title>Draw</title>
903 <mouse><key><left-drag/></key> <action>draw a 3D box (use shift to extrude in Z direction)</action></mouse>
904 </group>
906 <group>
907 <title>Select</title>
908 <mouse><key><left-click/></key> <action>click to select</action></mouse>
909 <mouse><key><alt/><left-click/></key> <key><ctrl/><alt/><left-click/></key> <action>select under</action></mouse>
910 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
911 <keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
912 </group>
914 <group>
915 <title>Edit by handles</title>
916 <note>All editing operations occur "in perspective", i.e., either along PLs or within planes spanned by these.</note>
917 <mouse><key><left-drag/></key> <action>resize/move box</action></mouse>
918 <note>The four front handles and the center normally move withing the XY-plane, the four rear handles along the Z-axis.</note>
919 <mouse><key><shift/><left-drag/></key> <action>resize/move (with handle behaviour swapped)</action></mouse>
920 <mouse><key><ctrl/><left-drag/></key> <action>resize/move (handles snap to axes or diagonals)</action></mouse>
921 </group>
923 <group>
924 <title>Edit perspectives</title>
925 <note>In what follows, we use the abbreviations VP = vanishing point, PL = perspective line.</note>
926 <mouse><key><left-drag/></key> <action>drag square handles to move the VPs</action></mouse>
927 <keys><key>[</key> <key>]</key> <action>rotate X-PLs (if parallel) by the angle step</action></keys> 
928 <note>The default angle step is 15 degrees. ],),} rotate clockwise, [,(,{ rotate counterclockwise.</note>
929 <keys><key><alt/>[</key> <key><alt/>]</key> <action>rotate X-PLs (if parallel) by 1 pixel</action></keys> 
930 <keys><key>(</key> <key>)</key> <action>rotate Y-PLs (if parallel) by the angle step</action></keys> 
931 <keys><key><alt/>(</key> <key><alt/>)</key> <action>rotate Y-PLs (if parallel) by 1 pixel</action></keys> 
932 <keys><key>{</key> <key>}</key> <action>rotate Z-PLs (if parallel) by the angle step</action></keys> 
933 <keys><key><alt/>{</key> <key><alt/>}</key> <action>rotate Z-PLs (if parallel) by 1 pixel</action></keys> 
934 </group>
936 <group>
937 <title>Visual appearance</title>
938 <keys><key>L</key> <action>toggle visibility of PLs</action></keys>
939 <keys><key>A</key> <action>toggle PLs to all corners/only front corners</action></keys>
940 </group>
942 </section>
944 *<section title="Ellipse tool" color="ffece8">
945 <group>
946 <title>Draw</title>
947 <note>Without Alt the starting end ending point of the mouse drag mark the corners of the bounding box.</note>
948 <note>With Alt the ellipse is enlarged so that its circumference passes through these two points (Ctrl+Alt is a special case; see below).</note>
949 <mouse><key><left-drag/></key> <action>draw an ellipse</action></mouse>
950 <mouse><key><ctrl/><left-drag/></key>   <action>make circle or integer-ratio ellipse</action></mouse>
951 <note>This restricts ellipse so its height/width ratio is a whole number.</note>
952 <mouse><key><shift/><left-drag/></key> <action>draw around the starting point</action></mouse>
953 <note>This creates an ellipse symmetric around the starting point of the mouse drag.</note>
954 <mouse><key><ctrl/><alt/><left-drag/></key>create circle passing through the starting and ending point<action></action></mouse>
955 <note>This creates a perfect circle whose diameter is defined by the starting and ending point of the mouse drag.</note>
956 </group>
958 <group>
959 <title>Select</title>
960 <mouse><key><left-click/></key> <action>click to select</action></mouse>
961 <mouse><key><alt/><left-click/></key> <key><ctrl/><alt/><left-click/></key> <action>select under</action></mouse>
962 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
963 <note>In this tool, selecting by click disregards any grouping (i.e. acts as clicking with Ctrl in Selector)</note>
964 <keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
965 </group>
967 <group>
968 <title>Edit by handles</title>
969 <mouse><key><left-drag/></key> <action>resize, make arc or segment</action></mouse>
970 <note>Initially, the two resize handles are at the topmost and leftmost points; the two arc/segment handles are in the rightmost point.</note>
971 <mouse><key><ctrl/><left-drag/></key> <action>lock circle (resize handles)</action></mouse>
972 <mouse><key><ctrl/><left-drag/></key> <action>snap to angle steps (arc/segment handles)</action></mouse>
973 <note>Resize handles change the width and height of the ellipse in its own coordinate system, before any transforms are applied.</note>
974 <note>The default angle step is 15 degrees.</note>
975 <mouse><key><shift/><left-click/></key> <action>make whole (arc/segment handles)</action></mouse>
976 </group>
977 </section>
979 *<section title="Star tool" color="f8f7d5">
980 <group>
981 <title>Draw</title>
982 <mouse><key><left-drag/></key> <action>draw a star</action></mouse>
983 <mouse><key><ctrl/><left-drag/></key> <action>snap star to angle steps</action></mouse>
984 <note>The default angle step is 15 degrees.</note>
985 </group>
987 <group>
988 <title>Select</title>
989 <mouse><key><left-click/></key> <action>click to select</action></mouse>
990 <mouse><key><alt/><left-click/></key> <key><ctrl/><alt/><left-click/></key> <action>select under</action></mouse>
991 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
992 <note>In this tool, selecting by click disregards any grouping (i.e. acts as clicking with Ctrl in Selector)</note>
993 <keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
994 </group>
996 <group>
997 <title>Edit by handles</title>
998 <mouse><key><left-drag/></key> <action>drag a handle to vary the star shape</action></mouse>
999 <mouse><key><ctrl/><left-drag/></key> <action>keep star rays radial (no skew)</action></mouse>
1000 <mouse><key><shift/><left-drag/></key> <action>round the star</action></mouse>
1001 <mouse><key><shift/><left-click/></key> <action>remove rounding</action></mouse>
1002 <mouse><key><alt/><left-drag/></key> <action>randomize the star</action></mouse>
1003 <mouse><key><alt/><left-click/></key> <key><ctrl/><alt/><left-click/></key> <action>remove randomization</action></mouse>
1004 </group>
1005 </section>
1007 *<section title="Spiral tool" color="f3f3f3">
1008 <group>
1009 <title>Draw</title>
1010 <mouse><key><left-drag/></key> <action>draw a spiral</action></mouse>
1011 <mouse><key><ctrl/><left-drag/></key>   <action>snap spiral to angle steps</action></mouse>
1012 <note>The default angle step is 15 degrees.</note>
1013 </group>
1015 <group>
1016 <title>Select</title>
1017 <mouse><key><left-click/></key> <action>click to select</action></mouse>
1018 <mouse><key><alt/><left-click/></key> <key><ctrl/><alt/><left-click/></key> <action>select under</action></mouse>
1019 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
1020 <note>In this tool, selecting by click disregards any grouping (i.e. acts as clicking with Ctrl in Selector)</note>
1021 <keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
1022 </group>
1024 <group>
1025 <title>Edit by handles</title>
1026 <mouse><key><left-drag/></key> <action>roll/unroll from inside (inner handle)</action></mouse>
1027 <note>Dragging the inner handle adjusts the "inner radius" parameter.</note>
1028 <mouse><key><alt/><left-drag/></key> <action>converge/diverge (inner handle)</action></mouse>
1029 <mouse><key><alt/><left-click/></key> <key><ctrl/><alt/><left-click/></key> <action>reset divergence (inner handle)</action></mouse>
1030 <note>Vertical Alt+drag of the inner handle adjusts the "divergence" parameter, Alt+click resets it to 1.</note>
1031 <mouse><key><shift/><left-click/></key> <action>zero inner radius (inner handle)</action></mouse>
1032 <note>Shift+click on inner handle makes the spiral start from the center.</note>
1034 <mouse><key><left-drag/></key> <action>roll/unroll from outside (outer handle)</action></mouse>
1035 <note>Dragging the outer handle adjusts the "turns" parameter. Use Shift+Alt+drag to roll/unroll without changing radius.</note>
1036 <mouse><key><shift/><left-drag/></key> <action>scale/rotate (outer handle)</action></mouse>
1037 <note>Use Shift+Alt to rotate only (locks the radius of the spiral).</note>
1039 <mouse><key><ctrl/><left-drag/></key> <action>snap handles to angle steps</action></mouse>
1040 <note>The default angle step is 15 degrees. This works for both handles.</note>
1041 </group>
1042 </section>
1046 </column>
1051 <column>
1053 *<section title="Zoom tool" color="e7e9f3">
1054 <group>
1055 <mouse><key><left-click/></key> <action>zoom in</action></mouse>
1056 <mouse><key><shift/><left-click/></key> <action>zoom out</action></mouse>  
1057 <mouse><key><left-drag/></key> <action>zoom into the area</action></mouse>
1058 </group>
1059 </section>
1061 *<section title="Pencil tool" color="e9efc5">
1062 <group>
1063 <mouse><key><left-drag/></key> <action>draw a freehand line</action></mouse>
1064 <mouse><key><shift/><left-drag/></key> <action>add to selected path</action></mouse>
1065 <note>If a path is selected, Shift+dragging anywhere creates a new subpath instead of a new independent path.</note>
1066 <mouse><key><shift/><left-drag/></key> <action>temporarily disable snapping</action></mouse>
1067 <note>Shift also temporaily disables snapping to grid or guides when you are drawing with grid or guides on.</note>
1068 <mouse><key><ctrl/><left-click/></key> <action>create a single dot</action></mouse>
1069 <note>This creates a single dot, represented by a small circle. The dot size (relative to the current stroke width) can be set in the Preferences dialog. With Shift, the size is doubled. Pressing Alt while creating multiple dots randomly varies their size.</note>
1070 </group>
1071 </section>
1073 *<section title="Pen (Bezier) tool" color="e7f5d7">
1075 <group>
1076 <title>Create nodes</title>
1077 <mouse><key><left-click/></key> <action>create a sharp node</action></mouse>
1078 <note>If no path is being created, this starts a new path.</note>
1079 <mouse><key><shift/><left-click/></key> <action>add to selected path</action></mouse>
1080 <note>If a path is selected, Shift+clicking anywhere starts a new subpath instead of a new independent path.</note>
1081 <mouse><key><left-drag/></key> <action>create a bezier node with two handles</action></mouse>
1082 <mouse><key><shift/><left-drag/></key> <action>move only one handle</action></mouse>
1083 <!-- FIXME: also disables snapping! another conflict -->
1084 <note>This moves only one handle (instead of both) while creating a node, making it cusp.</note> 
1085 <mouse><key><ctrl/><left-drag/></key> <action>snap the handle to angle steps</action></mouse>
1086 <note>The default angle step is 15 degrees.</note>
1087 </group>
1089 <group>
1090 <title>Move last node</title>
1091 <note>These commands move the last created node (at the start of the red segment) while creating a path.</note>
1092 <mouse><key><arrows/></key>  <action>move last node by the nudge distance</action></mouse>
1093 <mouse><key><shift/><arrows/></key>  <action>move last node by 10x nudge distance</action></mouse>
1094 <note>The default nudge distance is 2 px (SVG pixel units, not screen pixels).</note>
1095 <mouse><key><alt/><arrows/></key>  <action>move last node by 1 pixel</action></mouse>
1096 <mouse><key><alt/><shift/><arrows/></key>  <action>move last node by 10 pixels</action></mouse>
1097 <note>The actual distance for pixel movements depends on zoom level. Zoom in for finer movement.</note>
1098 </group>
1100 <group>
1101 <title>Create/modify segments</title>
1102 <keys><key><ctrl/></key> <action>snap last segment to angle steps</action></keys>
1103 <note>This snaps the new node's angle, relative to the previous node, to angle steps (default 15 degrees).</note>
1104 <keys><key><shift/>L</key>  <action>make last segment line</action></keys>
1105 <keys><key><shift/>U</key>  <action>make last segment curve</action></keys>
1106 <note>These commands change the last (red) segment of the path to straight line or curve.</note>
1107 </group>
1109 <group>
1110 <title>Create dots</title>
1111 <mouse><key><ctrl/><left-click/></key> <action>create a single dot</action></mouse>
1112 <note>This creates a single dot, represented by a small circle. The dot size (relative to the current stroke width) can be set in the Preferences dialog. With Shift, the size is doubled. Pressing Alt while creating multiple dots randomly varies their size.</note>
1115 <group>
1116 <title>Finish</title>
1117 <keys><key><misc-wide f="Enter"/></key>  <action>finish current line</action></keys>
1118 <mouse><key><right-click/></key> <action>finish current line</action></mouse>
1119 <mouse><key><left-click/><left-click/></key> <action>finish current line</action></mouse>
1120 <note>Enter, right click, or double left click finish the current line, discarding the last unfinished (red) segment.</note>
1121 </group>
1123 <group>
1124 <title>Cancel</title>
1125 <keys><key><misc f="Esc"/></key><key><ctrl/>z</key>  <action>cancel current line</action></keys>
1126 <keys><key><misc-wide f="Backspace"/></key><key><misc f="Del"/></key> <action>erase last segment of current line</action></keys>
1127 </group>
1128 </section>
1130 *<section title="Calligraphy tool" color="e9dfef">
1131 <group>
1132 <mouse><key><left-drag/></key> <action>draw a calligraphic line</action></mouse>
1133 <mouse><key><shift/><left-drag/></key> <action>add to selected path</action></mouse>
1134 <note>Drawing with Shift unions the newly created stroke with the previous selection</note>
1135 <mouse><key><ctrl/><left-drag/></key> <action>track a guide path</action></mouse>
1136 <note>Drawing with Ctrl tracks a selected guide path at the constant distance</note>
1137 <mouse><key><left-arrow/></key> <key><right-arrow/></key> <action>adjust pen width by 1</action></mouse>
1138 <mouse><key><misc f="Home"/></key> <key><misc f="End"/></key> <action>set pen width to 1 or 100</action></mouse>
1139 <mouse><key><up/></key> <key><down/></key> <action>adjust pen angle</action></mouse>
1140 <note>Width and angle can be adjusted while drawing. </note>
1141 <keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
1142 </group>
1143 </section>
1145 *<section title="Paint Bucket" color="f2f9da">
1146 <group>
1147 <mouse><key><left-click/></key> <action>fill a bounded area</action></mouse>
1148 <mouse><key><shift/><left-click/></key> <action>add to selected path</action></mouse>
1149 <note>Clicking with Shift unions the newly created fill with the previous selection</note>
1150 <mouse><key><left-drag/></key> <action>fill from each point</action></mouse>
1151 <note>From each point, the fill spreads to the neighbors with the colors similar to that point.</note>
1152 <note>This can be used to fill an area currently filled with a gradient or blur.</note>
1153 <mouse><key><alt/><left-drag/></key> <action>fill from each point same as initial point</action></mouse>
1154 <note>From each point, the fill spreads to the neighbors with the colors similar to the initial point of the drag.</note>
1155 <note>This can be used to fill several disjoint bounded areas by starting in one and dragging over all of the areas.</note>
1156 <mouse><key><ctrl/><left-click/></key> <action>set fill color</action></mouse>
1157 <mouse><key><shift/><ctrl/><left-click/></key> <action>set stroke color</action></mouse>
1158 <note>Ctrl+clicking an object sets its fill (or stroke with Shift) to the tool's current style; the object need not be selected</note>
1159 </group>
1160 </section>
1162 *<section title="Gradient tool" color="e9f3e7">
1164 <group>
1165 <title>Select objects</title>
1166 <mouse><key><left-click/></key> <action>click an object to select</action></mouse>
1167 <mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
1168 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
1169 </group>
1171 <group>
1172 <title>Create gradients</title>
1173 <mouse><key><left-drag/></key> <action>create gradient</action></mouse>
1174 <note>This creates gradient on selected objects. The Controls bar lets you select linear/radial and fill/stroke for the new gradient.</note>
1175 <mouse><key><left-click/><left-click/></key> <action>create default gradient</action></mouse>
1176 <note>This creates default (horizontal edge-to-edge for linear, centered edge-to-edge-to-edge for radial) gradient on clicked object. </note>
1177 </group>
1179 <group>
1180 <title>Select handles</title>
1181 <mouse><key><left-click/></key> <action>select a handle</action></mouse>
1182 <mouse><key><shift/><left-click/></key> <action>add handle to selection</action></mouse>
1183 <mouse><key><shift/><left-drag/></key> <action>select by rubberband</action></mouse>
1184 <keys><key><misc f="Tab"/></key>  <action>select next handle</action></keys> 
1185 <keys><key><shift/><misc f="Tab"/></key> <action>select previous handle</action></keys>
1186 <keys><key><ctrl/>A</key>        <action>select all handles</action></keys>
1187 <keys><key><misc f="Esc"/></key> <action>deselect all handles</action></keys>
1188 <note>Single click outside all handles also deselects all handles.</note>
1189 </group>
1191 <group>
1192 <title>Create/delete intermediate stops</title>
1193 <mouse><key><ctrl/><alt/><left-click/></key> <action>create a stop</action></mouse>
1194 <mouse><key><left-click/><left-click/></key> <action>create a stop</action></mouse>
1195 <note>Ctrl+Alt+click or double click on a gradient line creates a new intermediate stop</note>
1196 <mouse><key><ctrl/><alt/><left-click/></key> <action>delete stop</action></mouse>
1197 <note>Ctrl+Alt+click on a stop's handle deletes the stop; if it was an end stop, gradient shortens or disappears</note>
1198 <keys><key><misc f="Ins"/></key> <action>insert new stop(s)</action></keys>
1199 <note>This adds new stop(s) in the middle(s) of selected segment(s), so it requires that more than two adjacent handles be selected.</note>
1200 <keys><key><misc f="Del"/></key> <action>delete selected stops</action></keys>
1201 </group>
1203 <group>
1204 <title>Move handles/stops</title>
1205 <mouse><key><left-drag/></key>  <action>move selected handle(s)</action></mouse>
1206 <mouse><key><ctrl/><left-drag/></key>  <action>move stops in 1/10 range increments</action></mouse>
1207 <note>Ctrl+dragging selected intermediate stops moves them snapping to 1/10 steps of the available range</note>
1208 <mouse><key><alt/><left-drag/></key>  <action>sculpt selected stops</action></mouse>
1209 <note>Sculpting moves the selected intermediate stops depending on how close each one is to the stop being dragged, using a smooth bell-like curve similar to the node sculpting feature in Node tool.</note>
1210 <mouse><key><arrows/></key>  <action>move selected handle by the nudge distance</action></mouse>
1211 <mouse><key><shift/><arrows/></key>  <action>move selected handle by 10x nudge distance</action></mouse>
1212 <note>The default nudge distance is 2 px (SVG pixel units, not screen pixels).</note>
1213 <mouse><key><alt/><arrows/></key>  <action>move selected handle by 1 pixel</action></mouse>
1214 <mouse><key><alt/><shift/><arrows/></key>  <action>move selected handle by 10 pixels</action></mouse>
1215 <note>If at least one end handle is selected, arrow keys move the end handle to move or resize the gradient line.</note>
1216 <note>If only mid stops are selected, arrow keys move the selected stops along the gradient line.</note>
1217 <note>The actual distance for pixel movements depends on zoom level. Zoom in for finer movement.</note>
1218 </group>
1220 <group>
1221 <title>Reverse</title>
1222 <keys><key><shift/>r</key>  <action>reverse gradient definition</action></keys> 
1223 <note>This mirrors the stop positions of the current gradient without moving the gradient handles.</note>
1224 </group>
1226 <!-- TODO: remove! -->
1227 <group>
1228 <title>Gradient editor</title>
1229 <mouse><key><left-click/><left-click/></key> <action>open gradient editor</action></mouse>
1230 <note>Double clicking a gradient handle opens the Gradient Editor with that gradient and the clicked handle chosen in the stops list.</note>
1231 </group>
1234 </section>
1237 *<section title="Dropper tool" color="feeffa">
1238 <group>
1239 <mouse><key><left-click/></key> <action>pick fill color</action></mouse>
1240 <mouse><key><shift/><left-click/></key> <action>pick stroke color</action></mouse>
1241 <mouse><key><left-drag/></key> <action>average fill color</action></mouse>
1242 <mouse><key><shift/><left-drag/></key> <action>average stroke color</action></mouse>
1243 <note>Click applies the color under cursor to the current selection. Dragging a radius calculates the average color of a circular area.</note>
1244 <note>If a gradient handle (in Gradient tool) is selected, it gets the color instead of the entire object.</note>
1245 <mouse><key><alt/><left-click/></key> <key><alt/><left-drag/></key> <key><ctrl/><alt/><left-click/></key> <key><ctrl/><alt/><left-drag/></key> <action>pick inverse color</action></mouse>
1246 <note>If Alt is pressed, picking color (with or without Shift, by click or by drag) picks the inverse of the color.</note>
1247 <keys><key><ctrl/>C</key> <action>copy color</action></keys>
1248 <note>This copies the color under cursor to the system clipboard, as text in RRGGBBAA format (8 hex digits).</note>
1249 </group>
1250 </section>
1253 </column>
1257 <column>
1258 *<section title="Text tool" color="eefdf3">
1260 <group>
1261 <title>Select/create</title>
1262 <mouse><key><left-click/></key> <action>create/select a text object</action></mouse>
1263 <!--<keys><key>letters, digits, space, ...</key> <action>type text in a text object</action></keys>-->
1264 <note>Clicking in an empty space or on a non-text creates a text object; now you can type your text.</note>
1265 <note>Clicking on a text object selects it; cursor is placed near the click point.</note>
1266 <keys><key><misc f="Esc"/></key> <action>deselect the text object</action></keys>
1267 </group>
1269 <group>
1270 <title>Navigate in text</title>
1271 <mouse><key><arrows/></key> <action>move cursor by one character</action></mouse>
1272 <mouse><key><ctrl/><left-arrow/></key> <key><ctrl/><right-arrow/></key> <action>move cursor by one word</action></mouse>
1273 <mouse><key><ctrl/><up-arrow/></key> <key><ctrl/><down-arrow/></key> <action>move cursor by one paragraph</action></mouse>
1274 <keys><key><misc f="Home"/></key> <key><misc f="End"/></key> <action>go to beginning/end of line</action></keys>
1275 <keys><key><ctrl/><misc f="Home"/></key> <key><ctrl/><misc f="End"/></key> <action>go to beginning/end of text</action></keys>
1276 <note>All these commands cancel current text selection, if any.</note>
1277 </group>
1279 <group>
1280 <title>Flowed text (internal frame)</title>
1281 <mouse><key><left-drag/></key> <action>create flowed text</action></mouse>
1282 <note>Clicking and dragging in an empty space or on a non-text creates a flowed text object with internal frame.</note>
1283 <mouse><key><left-drag/></key> <action>adjust frame size</action></mouse>
1284 <note>Dragging the handle in the lower right corner of the selected flowed text changes width/height of the frame.</note>
1285 <mouse><key><ctrl/><left-drag/></key> <action>lock width, height, or ratio of frame</action></mouse>
1286 <note>Dragging the corner handle with Ctrl resizes the frame preserving either width, or height, or ratio.</note>
1287 </group>
1289 <group>
1290 <title>Flowed text (external frame)</title>
1291 <keys><key><alt/>W</key>         <action>flow text into frame</action></keys> 
1292 <note>With a text object and a shape/path selected, this flows text into the shape/path.</note>
1293 <note>Both remain separate objects, but are linked; editing the shape/path causes the text to reflow.</note>
1294 <keys><key><alt/><shift/>W</key>         <action>unflow text from frame</action></keys> 
1295 <note>This cuts the flowed text's link to the shape/path, producing a single-line regular text object.</note>
1296 <keys><key><shift/>D</key>       <action>select external frame</action></keys> 
1297 <note>To find out which object is the frame of this flowed text, select it and press Shift+D. The frame will be selected.</note>
1298 </group>
1300 <group>
1301 <title>Text on path</title>
1302 <keys><key><shift/>D</key>       <action>select path from text</action></keys> 
1303 <note>To find out which path this text is put on, select it and press Shift+D. The path will be selected.</note>
1304 </group>
1306 <group>
1307 <title>Edit text</title>
1308 <note>To type + and - characters, use the main keyboard; keypad + and - are reserved for zoom (unless NumLock is on).</note> 
1309 <keys><key><misc-wide f="Enter"/></key> <action>start a new line or paragraph</action></keys>
1310 <note>Enter in regular text creates new line; in flowed text it creates a new paragraph</note>
1311 <keys><key><ctrl/>U</key> <action>toggle Unicode entry</action></keys> 
1312 <note>To insert an arbitrary Unicode character, type Ctrl+U, then the hexadecimal code point, then Enter.</note>
1313 <note>For example, type Ctrl+U 2 0 1 4 Enter for an em-dash; Ctrl+U a 9 Enter for a copyright sign.</note>
1314 <note>To stay in Unicode mode after inserting the character, press Space instead of Enter.</note>
1315 <note>Press Esc or another Ctrl+U to cancel Unicode mode without inserting the character.</note>
1316 <keys><key><ctrl/><misc-wide f="Space"/></key> <action>insert no-break space</action></keys>
1317 <note>A no-break space is visible even in a text object without xml:space="preserve".</note>
1318 </group>
1320 <group>
1321 <title>Select text</title>
1322 <mouse><key><left-drag/></key> <action>select text</action></mouse>
1323 <note>Left-dragging over a text object selects a text span.</note>
1324 <mouse><key><shift/><arrows/></key> <action>select text by character</action></mouse>
1325 <mouse><key><ctrl/><shift/><arrows/></key> <action>select text by word</action></mouse>
1326 <keys><key><shift/><misc f="Home"/></key> <key><shift/><misc f="End"/></key> <action>select to beginning/end of line</action></keys>
1327 <keys><key><ctrl/><shift/><misc f="Home"/></key> <key><ctrl/><shift/><misc f="End"/></key> <action>select to beginning/end of text</action></keys>
1328 <mouse><key><left-click/><left-click/></key> <action>select word</action></mouse>
1329 <mouse><key><left-click/><left-click/><left-click/></key> <action>select line</action></mouse>
1330 <keys><key><ctrl/>A</key>        <action>select all text</action></keys>
1331 <note>This selects the entire text of the current text object.</note>
1332 </group>
1334 <group>
1335 <title>Style selection</title>
1336 <keys><key><ctrl/>B</key>        <action>make selection bold</action></keys>
1337 <keys><key><ctrl/>I</key>        <action>make selection italic</action></keys>
1338 <note>Also, you can use the Text&amp;Font or Fill&amp;Stroke dialogs to assign any style to text selection.</note>
1339 </group>
1341 <group>
1342 <title>Letter spacing</title>
1343 <keys><key><alt/>&gt;</key> <action>expand line/paragraph by 1 pixel</action></keys>
1344 <keys><key><shift/><alt/>&gt;</key> <action>expand line/paragraph by 10 pixels</action></keys>
1345 <keys><key><alt/>&lt;</key> <action>contract line/paragraph by 1 pixel</action></keys>
1346 <keys><key><shift/><alt/>&lt;</key> <action>contract line/paragraph by 10 pixels</action></keys>
1347 <note>These commands (only when editing text) adjust letter spacing in the current line (regular text) or paragraph (flowed text).</note>
1348 <note>The actual adjustment for pixel movements depends on zoom level. Zoom in for finer adjustment.</note>
1349 </group>
1351 <group>
1352 <title>Line spacing</title>
1353 <keys><key><ctrl/><alt/>&gt;</key> <action>make the text object taller by 1 pixel</action></keys>
1354 <keys><key><shift/><ctrl/><alt/>&gt;</key> <action>make the text object taller by 10 pixels</action></keys>
1355 <keys><key><ctrl/><alt/>&lt;</key> <action>make the text object shorter by 1 pixel</action></keys>
1356 <keys><key><shift/><ctrl/><alt/>&lt;</key> <action>make the text object shorter by 10 pixels</action></keys>
1357 <note>These commands (only when editing text) adjust line spacing in the entire text object (regular or flowed).</note>
1358 <note>The actual adjustment for pixel movements depends on zoom level. Zoom in for finer adjustment.</note>
1359 </group>
1361 <group>
1362 <title>Kerning and shifting</title>
1363 <mouse><key><alt/><arrows/></key> <action>shift characters by 1 pixel</action></mouse>
1364 <mouse><key><shift/><alt/><arrows/></key> <action>shift characters by 10 pixels</action></mouse>
1365 <note>These commands work when editing a regular text object. Kerning does not work in flowed text.</note> 
1366 <note>With no selection, they shift (horizontally or vertically) the characters after the cursor until the end of line.</note>
1367 <note>With selection, they shift the selection relative to the rest of text (by inserting opposite kerns at both ends of selection).</note>
1368 <note>The actual adjustment for pixel movements depends on zoom level. Zoom in for finer adjustment.</note>
1369 </group>
1371 <group>
1372 <title>Rotate</title>
1373 <keys><key><ctrl/>[</key> <key><ctrl/>]</key> <action>rotate character(s) by 90 degrees</action></keys>
1374 <keys><key><alt/>[</key> <key><alt/>]</key> <action>rotate character(s) by 1 pixel</action></keys>
1375 <note>These commands rotate the next character (without selection) or all characters in the selection (with selection).</note>
1376 <note>Rotation only works in regular text (not flowed text).</note>
1377 <note>The actual angle for pixel rotation depends on zoom level. Zoom in for finer movement.</note>
1378 </group>
1380 </section>
1381 </column>
1383 </root>