Code

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