Code

Add .a files to svn:ignore property.
[inkscape.git] / doc / keys.xml
1 <root xmlns="http://www.inkscape.org/namespaces/keys">
3 <p>Unless noted otherwise, keypad keys (such as arrows, Home, End, +, -, digits) are
4 supposed to work the same as corresponding regular keys. If you have a new shortcut
5 idea, please contact the developers (by writing to the <a
6 href="http://lists.sourceforge.net/lists/listinfo/inkscape-devel">devel mailing list</a>
7 or by <a href="http://sourceforge.net/tracker/?group_id=93438&amp;atid=604309">submitting an
8 RFE</a>).</p>
10 <column>
12 *<section title="Tools" color="f5f5f5">
14 <group>
15 <keys><key><keyf f="F1"/></key><key>s</key>    <action>Selector</action></keys>
16 <keys><key><misc-wide f="Space"/></key>   <action>Selector (temporary)</action></keys>
17 <note>Space switches to the Selector tool temporarily; another Space switches back.</note>
18 <keys><key><keyf f="F2"/></key><key>n</key>     <action>Node tool</action></keys>
19 <keys><key><keyf f="F3"/></key><key>z</key>      <action>Zoom tool</action></keys>
20 <keys><key><keyf f="F4"/></key><key>r</key>      <action>Rectangle tool</action></keys>
21 <keys><key><keyf f="F5"/></key><key>e</key>      <action>Ellipse/arc tool</action></keys>
22 <keys><key><keyf f="F6"/></key><key>p</key>      <action>Freehand (Pencil) tool</action></keys>
23 <keys><key><shift/><keyf f="F6"/></key><key>b</key>      <action>Bezier (Pen) tool</action></keys>
24 <keys><key><ctrl/><keyf f="F6"/></key><key>c</key>       <action>Calligraphic tool</action></keys>
25 <keys><key><ctrl/><keyf f="F1"/></key><key>g</key>       <action>Gradient tool</action></keys>
26 <keys><key><keyf f="F7"/></key><key>d</key>      <action>Dropper tool</action></keys>
27 <keys><key><keyf f="F8"/></key><key>t</key>      <action>Text tool</action></keys>
28 <keys><key><keyf f="F9"/></key><key>i</key>      <action>Spiral tool</action></keys>
29 <keys><key><shift/><keyf f="F9"/></key><key>*</key>      <action>Star tool</action></keys>
30 <keys><key><ctrl/><keyf f="F2"/></key><key>o</key>       <action>Connector tool</action></keys>
31 <note>Double click on the tool buttons opens the Preferences dialog showing the page of the corresponding tool.</note>
32 </group>
33 </section>
36 *<section title="Dialogs" color="f0eae7">
37 <group>
38 <keys><key><shift/><ctrl/>F</key> <action>Fill and Stroke</action></keys>
39 <keys><key><shift/><ctrl/>W</key> <action>Swatches</action></keys>
40 <keys><key><shift/><ctrl/>T</key> <action>Text and Font</action></keys>
41 <keys><key><shift/><ctrl/>M</key> <action>Transform</action></keys>
42 <keys><key><shift/><ctrl/>A</key> <action>Align and Distribute</action></keys>
43 <keys><key><shift/><ctrl/>O</key> <action>Object Properties</action></keys>
44 <keys><key><shift/><ctrl/>X</key> <action>XML Editor</action></keys>
45 <keys><key><shift/><ctrl/>D</key> <action>Document Preferences</action></keys>
46 <keys><key><shift/><ctrl/>P</key> <action>Inkscape Preferences</action></keys>
47 <keys><key><shift/><ctrl/>E</key>        <action>Export to PNG</action></keys>
48 <keys><key><ctrl/>F</key>        <action>Find</action></keys>
49 <keys><key><shift/><alt/>B</key>         <action>Trace bitmap</action></keys>
50 <note>These open a new dialog window if it wasn't open yet, otherwise the corresponding dialog gets focus.</note>
51 </group>
53 <group>
54 <title>Toggle visibility</title>
55 <keys><key><keyf f="F12"/></key> <action>toggle dialogs</action></keys>
56 <note>This temporarily hides all open dialogs; another F12 shows them again.</note>
57 </group>
59 <group>
60 <title>Within a dialog</title>
61 <keys><key><misc f="Esc"/></key> <action>return to the canvas</action></keys>
62 <keys><key><ctrl/><keyf f="F4"/></key> <key><ctrl/>W</key> <action>close the dialog</action></keys>
63 <keys><key><misc f="Tab"/></key> <action>jump to next widget</action></keys>
64 <keys><key><shift/><misc f="Tab"/></key> <action>jump to previous widget</action></keys>
65 <keys><key><misc-wide f="Enter"/></key> <action>set the new value</action></keys>
66 <note>This accepts the new value you typed in a text field and returns focus to canvas.</note>
67 <keys><key><ctrl/><misc-wide f="Enter"/></key> <action>in XML Editor, set the attr value</action></keys>
68 <note>When editing an attribute value in XML Editor, this sets the new value (same as clicking the "Set attribute" button).</note>
69 <keys><key><misc-wide f="Space"/></key> <key><misc-wide f="Enter"/></key> <action>activate current button or list</action></keys>
70 <keys><key><ctrl/><misc f="PgUp"/></key> <key><ctrl/><misc f="PgDn"/></key> <action>in a multi-tab dialog, switch tabs</action></keys>
71 </group>
72 </section>
74 *<section title="Controls bar" color="f8f3e9">
76 <group>
77 <note>The Controls bar at the top of the document window provides different buttons and controls for each tool.</note>
78 <keys><key><alt/>X</key> <action>jump to the first editable field</action></keys>
79 <keys><key><misc-wide f="Enter"/></key> <action>accept the new value</action></keys>
80 <note>This accepts the new value you typed in a text field and returns focus to canvas.</note>
81 <keys><key><misc f="Esc"/></key>   <action>cancel changes, return to canvas</action></keys>
82 <note>This cancels any changes you made in a text field and returns focus to canvas.</note>
83 <keys><key><ctrl/>Z</key> <action>cancel changes</action></keys>
84 <note>This cancels any changes you made in a text field but you stay in the field.</note>
85 <keys><key><misc f="Tab"/></key> <action>jump to next field</action></keys>
86 <keys><key><shift/><misc f="Tab"/></key> <action>jump to previous field</action></keys>
87 <note>Use these to navigate between fields in the Controls bar (the value in the field you leave, if changed, is accepted).</note>
88 </group>
90 <group>
91 <title>Changing values</title>
92 <mouse><key><up/></key> <key><down/></key> <action>change value by 0.1</action></mouse>
93 <keys><key><misc f="PgUp"/></key><key><misc f="PgDn"/></key> <action>change value by 5.0</action></keys>
94 </group>
95  
96 </section>
98 *<section title="Canvas" color="e5f1e7">
100 <group>
101 <title>Zoom</title>
102 <keys><key>=</key> <key>+</key>          <action>zoom in</action></keys>
103 <keys><key>-</key>       <action>zoom out</action></keys>
104 <note>The keypad +/- keys do zooming even when you are editing a text object, unless NumLock is on.</note>
105 <mouse><key><mid-click/></key>  <key><ctrl/><right-click/></key>   <action>zoom in</action></mouse>
106 <mouse><key><shift/><mid-click/></key>  <key><shift/><right-click/></key> <action>zoom out</action></mouse>
107 <mouse><key><ctrl/><wheel/></key> <action>zoom in or out</action></mouse>
108 <mouse><key><shift/><mid-drag/></key> <action>zoom into the area</action></mouse>
109 <keys><key><alt/>Z</key> <action>activate zoom field</action></keys>
110 <note>The zoom field in the lower left corner of the window allows you to specify zoom level precisely.</note>
111 </group>
113 <group>
114 <title>Preset zooms</title>
115 <keys><key>1</key>       <action>zoom 1:1</action></keys>
116 <keys><key>2</key>      <action>zoom 1:2</action></keys>
117 <keys><key>3</key>      <action>zoom to selection</action></keys>
118 <keys><key>4</key>      <action>zoom to drawing</action></keys>
119 <keys><key>5</key>      <action>zoom to page</action></keys>
120 <keys><key><ctrl/>E</key><key>6</key>   <action>zoom to page width</action></keys>
121 </group>
123 <group>
124 <title>Zoom history</title>
125 <keys><key>`</key> <action>(back quote) previous zoom </action></keys>
126 <keys><key><shift/>`</key> <action>next zoom</action></keys>
127 <note>With these keys, you can travel back and forth through the history of zooms in this session</note>
128 </group>
130 <group>
131 <title>Scrolling (panning)</title>
132 <mouse><key><ctrl/><arrows/></key>  <action>scroll canvas</action></mouse>
133 <note>Scrolling by keys is accelerated, i.e. it speeds up when you press Ctrl+arrows in quick succession, or press and hold.</note>
134 <mouse><key><mid-drag/></key>  <action>pan canvas</action></mouse>
135 <mouse><key><shift/><right-drag/></key> <key><ctrl/><right-drag/></key> <action>pan canvas</action></mouse>
136 <mouse><key><wheel/></key> <action>scroll canvas vertically</action></mouse>
137 <mouse><key><shift/><wheel/></key> <action>scroll canvas horizontally</action></mouse>
138 </group>
140 <group>
141 <title>Guides and grid</title>
142 <mouse><key><left-drag/></key> <action>drag off a ruler to create guide</action></mouse>
143 <note>Drag off the horizontal or vertical ruler to create a new guideline. Drag a guideline onto the ruler to delete it.</note>
144 <keys><key>|</key> <key><shift/>\</key> <action>toggle guides and snapping to guides</action></keys>
145 <note>If you want to have different values for guides visibility and snapping, set them via the Document Options dialog.</note>
146 <note>When you create a new guide by dragging off the ruler, guide visibility and snapping are turned on.</note>
147 <keys><key>#</key> <key><shift/>3</key> <action>toggle grid and snapping to grid</action></keys>
148 <note>If you want to have different values for grid visibility and snapping, set them via the Document Options dialog.</note>
149 <note>Note that only the 3 key on the main keyboard works, not on the keypad.</note>
150 </group>
151 </section>
154 </column>
160 <column>
162 *<section title="File" color="f3f2e2">
164 <group>
165 <keys><key><ctrl/>N</key>        <action>create new document</action></keys>
166 <keys><key><ctrl/>O</key>        <action>open an SVG document</action></keys>
167 <keys><key><shift/><ctrl/>E</key>        <action>export to PNG</action></keys>
168 <keys><key><ctrl/>I</key>        <action>import bitmap or SVG</action></keys>
169 <keys><key><ctrl/>P</key>        <action>print document</action></keys>
170 <keys><key><ctrl/>S</key>        <action>save document</action></keys>
171 <keys><key><shift/><ctrl/>S</key>        <action>save under a new name</action></keys>
172 <keys><key><ctrl/>Q</key>        <action>exit Inkscape</action></keys>
173 </group>
175 </section>
177 *<section title="Window" color="e8fae1">
179 <group>
180 <keys><key><ctrl/>R</key> <action>toggle rulers</action></keys>
181 <keys><key><ctrl/>B</key> <action>toggle scrollbars</action></keys>
182 <keys><key><keyf f="F11"/></key> <action>toggle fullscreen</action></keys>
183 </group>
185 <group>
186 <keys><key><keyf f="F10"/></key> <action>main menu</action></keys>
187 <note>Menus can also be activated by Alt with the letter underscored in the menu name.</note>
188 <keys><key><shift/><keyf f="F10"/></key> <key><right-click/></key> <action>drop-down (context) menu</action></keys>
189 </group>
191 <group>
192 <keys><key><ctrl/><keyf f="F4"/></key> <key><ctrl/>W</key>       <action>close document window</action></keys>
193 <note>This shuts down Inkscape if it was the only document window open.</note>
194 <keys><key><ctrl/><misc f="Tab"/></key> <action>next document window</action></keys>
195 <keys><key><shift/><ctrl/><misc f="Tab"/></key> <action>previous document window</action></keys>
196 <note>These cycle through the active document windows forward and backward.</note>
197 </group>
199 </section>
202 *<section title="Layers" color="f6f9d9">
203 <group>
204 <keys><key><shift/><misc f="PgUp"/></key> <action>move to layer above</action></keys>
205 <keys><key><shift/><misc f="PgDn"/></key> <action>move to layer below</action></keys>
206 <note>These commands move the selected objects from one layer to another.</note>
208 <keys><key><shift/><ctrl/><misc f="PgUp"/></key> <action>raise layer</action></keys>
209 <keys><key><shift/><ctrl/><misc f="PgDn"/></key> <action>lower layer</action></keys>
210 <keys><key><shift/><ctrl/><misc f="Home"/></key> <action>raise layer to top</action></keys>
211 <keys><key><shift/><ctrl/><misc f="End"/></key> <action>lower layer to bottom</action></keys>
212 <note>These commands move the current layer among its siblings (normally other layers).</note>
213 </group>
214 </section>
217 *<section title="Object" color="f4ecf5">
219 <group>
220 <title>Undo/redo</title>
221 <keys><key><shift/><ctrl/>Y</key> <key><ctrl/>Z</key>    <action>undo</action></keys>
222 <keys><key><shift/><ctrl/>Z</key> <key><ctrl/>Y</key>    <action>redo</action></keys>
223 </group>
225 <group>
226 <title>Clipboard</title>
227 <keys><key><ctrl/>C</key>        <action>copy selection</action></keys>
228 <note>This places a copy of the selection to the Inkscape clipboard. Text from text objects is also placed onto the system clipboard.</note>
229 <keys><key><ctrl/>X</key>        <action>cut selection</action></keys>
230 <note>This works the same as "copy selection" followed by deleting the selection.</note>
231 <keys><key><ctrl/>V</key>        <action>paste clipboard</action></keys>
232 <note>This places the clipboard objects at the mouse cursor, or at the center of the window if mouse is outside the canvas.</note>
233 <note>When editing text with the text tool, this pastes the text from the system clipboard into the current text object.</note>
234 <keys><key><ctrl/><alt/>V</key>  <action>paste in place</action></keys>
235 <note>This places the clipboard objects to the original location from which they were copied.</note>
236 <keys><key><shift/><ctrl/>V</key>  <action>paste style</action></keys> 
237 <note>This applies the style of the (first of the) coped object(s) to the current selection.</note>
238 <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>
239 </group>
241 <group>
242 <title>Duplicate</title>
243 <keys><key><ctrl/>D</key>        <action>duplicate selection</action></keys> 
244 <note>New object(s) are placed exactly over the original(s) and selected.</note>
245 </group>
247 <group>
248 <title>Clone</title>
249 <keys><key><alt/>D</key>         <action>clone object</action></keys> 
250 <note>A clone can be moved/scaled/rotated/skewed independently, but it updates the path, fill, and stroke from its original.</note>
251 <note>The clone is placed exactly over the original object and is selected.</note>
252 <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>
253 <keys><key><shift/><alt/>D</key>         <action>unlink clone</action></keys> 
254 <note>Unlinking a clone cuts the link to the original, turning the clone into a plain copy.</note>
255 <keys><key><shift/>D</key>       <action>select original</action></keys> 
256 <note>To find out which object this is a clone of, select the clone and give this command. The original will be selected.</note>
257 </group>
259 <group>
260 <title>Bitmaps</title>
261 <keys><key><alt/>B</key> <action>create a bitmap copy</action></keys>
262 <note>This exports the selected object(s) (all other objects hidden) as PNG in the document's directory and imports it back.</note>
263 <note>The imported bitmap is placed over the original selection and is selected.</note>
264 <keys><key><shift/><alt/>B</key> <action>trace bitmap</action></keys>
265 <note>This opens the Trace Bitmap dialog allowing you to convert a bitmap object to path(s).</note> 
266 </group>
268 <group>
269 <title>Patterns</title>
270 <keys><key><alt/>I</key>         <action>object(s) to pattern</action></keys> 
271 <note>This converts the selection to a rectangle with tiled pattern fill.</note>
272 <keys><key><shift/><alt/>I</key>         <action>pattern to object(s)</action></keys> 
273 <note>Each selected object with pattern fill is broken into the same object without fill and a single pattern object.</note>
274 </group>
276 <group>
277 <title>Group</title>
278 <keys> <key><shift/><ctrl/>U</key>  <key><ctrl/>G</key> <action>group selected objects</action></keys>
279 <note>Use Ctrl+click to select objects within group.</note>
280 <keys><key><shift/><ctrl/>G</key> <key><ctrl/>U</key>  <action>ungroup selected group(s)</action></keys>
281 <note>This removes only one level of grouping; press Ctrl+U repeatedly to ungroup nested groups.</note>
282 </group>
284 <group>
285 <title>Z-order</title>
286 <keys><key><misc f="Home"/></key>        <action>raise selection to top</action></keys>
287 <keys><key><misc f="End"/></key>         <action>lower selection to bottom</action></keys>
288 <keys><key><misc f="PgUp"/></key>        <action>raise selection one step</action></keys>
289 <keys><key><misc f="PgDn"/></key>      <action>lower selection one step</action></keys>
290  </group>
292 </section>
294 *<section title="Path" color="f9f1d9">
296 <group>
297 <title>Convert to path</title>
298 <keys><key><shift/><ctrl/>C</key> <action>convert selected object(s) to path</action></keys>
299 <keys><key><ctrl/><alt/>C</key> <action>convert stroke to path</action></keys>
300 </group>
302 <group>
303 <title>Booleans</title>
304 <keys><key><ctrl/>+</key>  <action>union</action></keys>
305 <note>Union combines any number of objects into a single path, removing overlaps.</note>
306 <keys><key><ctrl/>-</key>  <action>difference</action></keys>
307 <note>Difference works on 2 objects, extracting the top from the bottom.</note>
308 <keys><key><ctrl/>*</key>  <action>intersection</action></keys>
309 <note>Intersection creates a path representing the common (overlapping) area of all selected objects.</note>
310 <keys><key><ctrl/>^</key>  <action>exclusive OR (XOR)</action></keys>
311 <note>XOR is similar to Union, except that it works on 2 objects and removes areas where the objects overlap.</note>
312 <keys><key><ctrl/>/</key>  <action>division (cut)</action></keys>
313 <note>Division cuts the bottom object into pieces by the top object, preserving the fill and stroke of the bottom.</note>
314 <keys><key><ctrl/><alt/>/</key>  <action>cut path</action></keys>
315 <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>
316 <note>The result of Union, Difference, Intersection, and XOR inherits the id= attribute and therefore the clones of the bottom object.</note>
317 <note>Division and Cut path normally produce several objects; of them, a random one inherits the id= of the bottom source object.</note>
318 </group>
320 <group>
321 <title>Offsets</title>
322 <keys><key><ctrl/>(</key>  <action>inset path (towards center)</action></keys>
323 <keys><key><ctrl/>)</key>  <action>outset path (away from center)</action></keys>
324 <note>The default offset distance is 2 px (SVG pixel units, not screen pixels).</note>
325 <keys><key><alt/>(</key>  <action>inset path by 1 pixel</action></keys>
326 <keys><key><alt/>)</key>  <action>outset path by 1 pixel</action></keys>
327 <keys><key><shift/><alt/>(</key>  <action>inset path by 10 pixels</action></keys>
328 <keys><key><shift/><alt/>)</key>  <action>outset path by 10 pixels</action></keys>
329 <note>The actual distance for pixel offsets depends on zoom level. Zoom in for finer adjustment.</note>
330 <note>All the (, ) commands convert the object to path, if necessary, and produce regular path.</note>
331 <keys><key><ctrl/>J</key>  <action>create dynamic offset</action></keys>
332 <keys><key><ctrl/><alt/>J</key>  <action>create linked offset</action></keys>
333 <note>These commands produce an offset object, editable by the node tool, standalone or linked to the original.</note>
334 <keys><key><shift/>D</key>       <action>select source</action></keys> 
335 <note>Selecting a linked offset and giving this command will select the source path of the linked offset.</note>
336 </group>
338 <group>
339 <title>Combine</title>
340 <keys><key><ctrl/>K</key>  <action>combine paths</action></keys>
341 <note>This is different from grouping in that combined paths create one object.</note>
342 <note>This is different from Union in that overlapping areas are not affected.</note>
343 <note>Whether overlapping areas are filled is controlled by the Fill: winding/alternating switch on the Fill &amp; Stroke dialog.</note>
344 <keys><key><shift/><ctrl/>K</key>  <action>break paths apart</action></keys>
345 <note>This attempts to break an object into constituent paths; it will fail if the object is one solid path.</note>
346 </group>
348 <group>
349 <title>Simplify</title>
350 <keys><key><ctrl/>L</key>  <action>simplify</action></keys>
351 <note>This command attempts to simplify selected path(s) by removing extra nodes. It converts all objects to paths first.</note>
352 <note>If you invoke this command several times in quick succession, it will act more and more aggressively.</note>
353 <note>Invoking Simplify again after a pause restores the default threshold (settable in the Inkscape Preferences dialog).</note>
354 </group>
356 </section>
358 </column>
360 <column>
362 *<section title="Selector" color="eee4dc">
364 <group>
365 <title>Keyboard select</title>
366 <keys><key><misc f="Tab"/></key>  <action>select next object </action></keys>
367 <keys><key><shift/><misc f="Tab"/></key> <action>select previous object </action></keys>
368 <note>These keys pick objects in their z-order (Tab cycles from bottom to top, Shift+Tab cycles from top to bottom).</note> 
369 <note>Unless you did manual rearrangements, the last object you created is always on top.</note> 
370 <note>As a result, if nothing is selected, pressing Shift+Tab once conveniently selects the object you created last.</note>
371 <note>This works on objects within the current layer (unless you change that in preferences).</note>
372 <keys><key><ctrl/>A</key>        <action>select all (current layer)</action></keys>
373 <note>This works on objects within the current layer (unless you change that in preferences).</note>
374 <keys><key><ctrl/><alt/>A</key>  <action>select all (all layers)</action></keys>
375 <note>This works on objects in all visible and unlocked layers.</note>
376 <keys><key>!</key> <action>invert selection (current layer)</action></keys>
377 <note>This inverts selection (deselects what was selected and vice versa) in the current layer.</note>
378 <keys><key><alt/>!</key> <action>invert selection (all layers)</action></keys>
379 <note>This inverts selection (deselects what was selected and vice versa) in visible and unlocked layers.</note>
380 <keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
381 <keys><key><misc-wide f="Backspace"/></key><key><misc f="Del"/></key>    <action>delete selection</action></keys>
382 </group>
384 <group>
385 <title>Keyboard move</title>
386 <mouse><key><arrows/></key>  <action>move selection by the nudge distance</action></mouse>
387 <mouse><key><shift/><arrows/></key>  <action>move selection by 10x nudge distance</action></mouse>
388 <note>The default nudge distance is 2 px (SVG pixel units, not screen pixels).</note>
389 <mouse><key><alt/><arrows/></key>  <action>move selection by 1 pixel</action></mouse>
390 <mouse><key><alt/><shift/><arrows/></key>  <action>move selection by 10 pixels</action></mouse>
391 <note>The actual distance for pixel movements depends on zoom level. Zoom in for finer movement.</note>
392 </group>
394 <group>
395 <title>Keyboard scale</title>
396 <keys><key>.</key> <key>&gt;</key> <action>scale selection up by the scale step</action></keys> 
397 <keys><key>,</key> <key>&lt;</key> <action>scale selection down by the scale step</action></keys> 
398 <note>The default scale step is 2 px (SVG pixel units, not screen pixels).</note>
399 <keys><key><ctrl/>.</key> <key><ctrl/>&gt;</key> <action>scale selection to 200%</action></keys>
400 <keys><key><ctrl/>,</key> <key><ctrl/>&lt;</key> <action>scale selection to 50%</action></keys>
401 <keys><key><alt/>.</key> <key><alt/>&gt;</key> <action>scale selection up by 1 pixel</action></keys>
402 <keys><key><alt/>,</key> <key><alt/>&lt;</key> <action>scale selection down by 1 pixel</action></keys>
403 <note>The actual size increment for pixel scaling depends on zoom level. Zoom in for finer scaling.</note>
404 <note>Scaling is uniform around the center, so that the size increment applies to the larger of the two dimensions.</note>
405 </group>
407 <group>
408 <title>Keyboard rotate</title>
409 <keys><key>[</key> <key>]</key> <action>rotate selection by the angle step</action></keys> 
410 <note>The default angle step is 15 degrees. ] rotates clockwise, [ rotates counterclockwise.</note>
411 <keys><key><ctrl/>[</key> <key><ctrl/>]</key> <action>rotate selection by 90 degrees</action></keys>
412 <keys><key><alt/>[</key> <key><alt/>]</key> <action>rotate selection by 1 pixel</action></keys>
413 <note>The actual angle for pixel rotation depends on zoom level. Zoom in for finer movement.</note>
414 </group>
416 <group>
417 <title>Keyboard flip</title>
418 <keys><key>h</key> <action>flip selection horizontally</action></keys>
419 <keys><key>v</key> <action>flip selection vertically</action></keys>
420 </group>
422 <group>
423 <title>Mouse select</title>
424 <mouse><key><left-click/></key> <action>select an object</action></mouse>
425 <note>When you left-click on an object, previous selection is deselected.</note>
426 <mouse><key><shift/><left-click/></key> <action>toggle selection </action></mouse>
427 <note>Shift+click adds an object to the current selection if it was not selected, or deselects it otherwise.</note>
428 <mouse><key><left-click/><left-click/></key> <action>edit the object</action></mouse>
429 <note>For paths, double clicking switches to Node tool; for shapes, to corresponding shape tool; for text, to Text tool.</note>
430 <note>For groups, double clicking performs the "Enter group" command (the group becomes temporary layer).</note>
431 <note>Double clicking in empty space swithes to the parent layer in the hierarchy, if any.</note>
432 </group>
434 <group>
435 <title>Select within group, select under</title>
436 <mouse><key><ctrl/><left-click/></key> <action>select within group</action></mouse>
437 <note>Ctrl+click selects the object at click point disregarding any levels of grouping that this object might belong to.</note>
438 <mouse><key><ctrl/><shift/><left-click/></key> <action>toggle selection within group</action></mouse>
439 <mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
440 <note>Alt+click selects the object at click point which is beneath (in z-order) the lowest selected object at click point.</note>
441 <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>
442 <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>
443 <mouse><key><shift/><alt/><left-click/></key> <action>toggle under</action></mouse>
444 <mouse><key><ctrl/><alt/><left-click/></key> <action>select under, in groups</action></mouse>
445 <mouse><key><shift/><ctrl/><alt/><left-click/></key> <action>toggle under, in groups</action></mouse>
446 <keys><key><ctrl/><misc-wide f="Enter"/></key> <action>enter group</action></keys>
447 <keys><key><ctrl/><misc-wide f="Backspace"/></key>       <action>go to parent group</action></keys>
448 </group>
450 <group>
451 <title>Rubberband</title>
452 <mouse><key><left-drag/></key> <action>select multiple objects</action></mouse>
453 <note>Dragging around objects does "rubberband" selection; previous selection is deselected.</note>
454 <mouse><key><shift/><left-drag/></key> <action>add objects to selection</action></mouse>
455 <note>Normally, you need to start from an empty space to initiate a rubberband.</note> 
456 <note>However, if you press Shift before dragging, Inkscape will do rubberband selection even if you start from an object.</note>
457 </group>
459 <group>
460 <title>Mouse move</title>
461 <mouse><key><left-drag/></key> <action>select + move</action></mouse>
462 <note>Dragging an object selects it if it was not selected, then moves selection.</note>
463 <mouse><key><alt/><left-drag/></key> <action>move selected</action></mouse>
464 <note>Alt+drag moves the current selection (without selecting what is under cursor), no matter where you start the drag.</note>
465 <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>
466 <mouse><key><ctrl/><left-drag/></key> <action>restrict movement to horizontal or vertical</action></mouse>
467 <mouse><key><shift/><left-drag/></key> <action>temporarily disable snapping</action></mouse>
468 <note>This temporaily disables snapping to grid or guides when you are dragging with grid or guides on.</note>
469 <mouse><key><left-drag/><misc-wide f="Space"/></key> <action>drop a copy</action></mouse>
470 <note>When dragging or transforming with mouse, each Space leaves a copy of the selected object.</note> 
471 <note>You can press and hold Space while dragging for a nice "trail."</note>
472 </group>
474 <group>
475 <title>Mouse transform</title>
476 <mouse><key><left-click/></key> <action>toggle scale/rotation handles</action></mouse>
477 <mouse><key><left-drag/></key> <action>scale (scale handles)</action></mouse>
478 <mouse><key><left-drag/></key> <action>rotate or skew (rotation handles)</action></mouse>
479 </group>
481 <group>
482 <title>Scale handles</title>
483 <mouse><key><ctrl/><left-drag/></key> <action>scale preserving aspect ratio</action></mouse>
484 <!--<mouse><key><ctrl/><left-drag/></key> only smaller, keep aspect ratio--> <!-- TO BE REMOVED -->
485 <mouse><key><shift/><left-drag/></key> <action>symmetric transformation</action></mouse>
486 <note>Holding Shift while transforming makes transformation symmetric around the center of the selection.</note>
487 <!-- FIXME: why not disable snapping? inconsistent! -->
488 <mouse><key><alt/><left-drag/></key> <action>slow movement</action></mouse>
489 <note>Holding Alt while transforming makes transformation lag behind mouse movement, allowing finer changes.</note>
490 </group>
492 <group>
493 <title>Rotation handles</title>
494 <mouse><key><ctrl/><left-drag/></key> <action>snap skew angle</action></mouse>
495 <note>Holding Ctrl when dragging a skew (non-corner) handle snaps the skew angle to angle steps (default 15 degrees).</note>
496 <mouse><key><ctrl/><left-drag/></key> <action>snap rotation angle</action></mouse>
497 <note>Holding Ctrl when dragging a rotation (corner) handle snaps the rotation angle to angle steps (default 15 degrees).</note>
498 </group>
500 <group>
501 <title>Cancel</title>
502 <keys><key><misc f="Esc"/></key> <action>cancel rubberband, move, transformation</action></keys>
503 <note>Press Esc while mouse button is still down to cancel rubberband selection, move, or transformation of any kind.</note>
504 </group>
506 </section>
508 </column>
510 <column>
511 *<section title="Node tool" color="f9f1d9">
513 <group>
514 <title>Keyboard select</title>
515 <keys><key><misc f="Tab"/></key>  <action>select next node</action></keys> 
516 <keys><key><shift/><misc f="Tab"/></key> <action>select previous node</action></keys>
517 <note>These keys select nodes within the selected path</note>
518 <keys><key><ctrl/>A</key>        <action>select all nodes in subpath(s)</action></keys>
519 <note>If the path has multiple subpaths and some nodes selected, this selects all only in subpaths with already selected nodes.</note>
520 <keys><key><ctrl/><alt/>A</key>  <action>select all nodes in path</action></keys>
521 <note>This selects all nodes in the entire path.</note>
522 <keys><key>!</key> <action>invert selection in subpath(s)</action></keys>
523 <note>If the path has multiple subpaths and some nodes selected, this inverts selection only in subpaths with already selected nodes.</note>
524 <keys><key><alt/>!</key> <action>invert selection in path</action></keys>
525 <note>This inverts selection (deselects what was selected and vice versa) in the entire path.</note>
526 <keys><key><misc f="Esc"/></key> <action>deselect all nodes</action></keys>
527 </group>
529 <group>
530 <title>Keyboard move</title>
531 <mouse><key><arrows/></key>  <action>move selected node(s) by the nudge distance</action></mouse>
532 <mouse><key><shift/><arrows/></key>  <action>move selected node(s) by 10x nudge distance</action></mouse>
533 <note>The default nudge distance is 2 px (SVG pixel units, not screen pixels).</note>
534 <mouse><key><alt/><arrows/></key>  <action>move selected node(s) by 1 pixel</action></mouse>
535 <mouse><key><alt/><shift/><arrows/></key>  <action>move selected node(s) by 10 pixels</action></mouse>
536 <note>The actual distance for pixel movements depends on zoom level. Zoom in for finer movement.</note>
537 </group>
539 <group>
540 <title>Keyboard handle scale (1 node selected)</title>
541 <keys><key>&lt;</key> <key>&gt;</key> <action>contract/expand both handles by scale step</action></keys> 
542 <note>The default scale step is 2 px (SVG pixel units, not screen pixels). May apply to more than one node.</note>
543 <keys>
544 <key><left/><ctrl/>&lt;</key> 
545 <key><left/><ctrl/>&gt;</key> 
546 <action>scale left handle by the scale step</action>
547 </keys>
548 <keys>
549 <key><right/><ctrl/>&lt;</key> 
550 <key><right/><ctrl/>&gt;</key> 
551 <action>scale right handle by the scale step</action>
552 </keys>
553 <keys>
554 <key><left/><alt/>&lt;</key> 
555 <key><left/><alt/>&gt;</key> 
556 <action>scale left handle by 1 pixel</action>
557 </keys>
558 <keys>
559 <key><right/><alt/>&lt;</key> 
560 <key><right/><alt/>&gt;</key> 
561 <action>scale right handle by 1 pixel</action>
562 </keys>
563 <note>The actual size increment for pixel scaling depends on zoom level. Zoom in for finer scaling.</note>
564 <note>Instead of the &lt; and &gt; keys, you can use the , (comma) and . (period) keys respectively.</note>
565 </group>
567 <group>
568 <title>Keyboard handle rotate (1 node selected)</title>
569 <keys><key>[</key> <key>]</key> <action>rotate both handles by the angle step</action></keys>
570 <note>The default angle step is 15 degrees. ] rotates clockwise, [ rotates counterclockwise. May apply to more than one node.</note>
571 <keys><key><left/><ctrl/>[</key> <key><left/><ctrl/>]</key> <action>rotate left handle by the angle step</action></keys>
572 <keys><key><right/><ctrl/>[</key> <key><right/><ctrl/>]</key> <action>rotate right handle by the angle step</action></keys>
573 <keys><key><left/><alt/>[</key> <key><left/><alt/>]</key> <action>rotate left handle by 1 pixel</action></keys>
574 <keys><key><right/><alt/>[</key> <key><right/><alt/>]</key> <action>rotate right handle by 1 pixel</action></keys>
575 </group>
578 <group>
579 <title>Keyboard scale (&gt;1 nodes selected)</title>
580 <note>These commands scale the selected nodes as if they were an "object", around the center of that object.</note>
581 <keys><key>.</key> <key>&gt;</key> <action>scale nodes up by the scale step</action></keys> 
582 <keys><key>,</key> <key>&lt;</key> <action>scale nodes down by the scale step</action></keys> 
583 <note>The default scale step is 2 px (SVG pixel units, not screen pixels).</note>
584 <keys><key><alt/>.</key> <key><alt/>&gt;</key> <action>scale nodes up by 1 pixel</action></keys>
585 <keys><key><alt/>,</key> <key><alt/>&lt;</key> <action>scale nodes down by 1 pixel</action></keys>
586 <note>The actual size increment for pixel scaling depends on zoom level. Zoom in for finer scaling.</note>
587 <note>Scaling is uniform around the center, so that the size increment applies to the larger of the two dimensions.</note>
588 </group>
590 <group>
591 <title>Keyboard rotate (&gt;1 nodes selected)</title>
592 <note>These commands rotate the selected nodes as if they were an "object", around the center of that object.</note>
593 <keys><key>[</key> <key>]</key> <action>rotate nodes by the angle step</action></keys> 
594 <note>The default angle step is 15 degrees. ] rotates clockwise, [ rotates counterclockwise.</note>
595 <keys><key><alt/>[</key> <key><alt/>]</key> <action>rotate nodes by 1 pixel</action></keys>
596 <note>The actual angle for pixel rotation depends on zoom level. Zoom in for finer movement.</note>
597 </group>
599 <group>
600 <title>Keyboard flip (&gt;1 nodes selected)</title>
601 <note>These commands flip the selected nodes as if they were an "object", around the center of that object.</note>
602 <keys><key>h</key> <action>flip nodes horizontally</action></keys>
603 <keys><key>v</key> <action>flip nodes vertically</action></keys>
604 </group>
607 <group>
608 <title>Change segment(s)</title>
609 <keys><key><shift/>L</key>  <action>make line</action></keys>
610 <keys><key><shift/>U</key>  <action>make curve</action></keys>
611 <note>These commands require that more than two adjacent nodes be selected.</note>
612 </group>
614 <group>
615 <title>Change node type</title>
616 <keys><key><shift/>C</key>  <action>make cusp</action></keys>
617 <keys><key><shift/>S</key>  <action>make smooth</action></keys>
618 <keys><key><shift/>Y</key>  <action>make symmetric</action></keys>
619 <mouse><key><ctrl/><left-click/></key> <action>toggle smooth/cusp/symmetric</action></mouse>
620 </group>
622 <group>
623 <title>Join/break</title>
624 <keys><key><shift/>J</key>  <action>join selected nodes</action></keys>
625 <note>This requires that exactly two end nodes within the path be selected.</note>
626 <keys><key><shift/>B</key>  <action>break selected node(s)</action></keys>
627 <note>After break, only one of each two new nodes is selected. May apply to more than one node.</note>
628 </group>
630 <group>
631 <title>Delete, create, duplicate</title>
632 <keys><key><misc-wide f="Backspace"/></key><key><misc f="Del"/></key> <action>delete selected node(s)</action></keys>
633 <mouse><key><ctrl/><alt/><left-click/></key> <action>create/delete node</action></mouse>
634 <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>
635 <mouse><key><left-click/><left-click/></key> <action>create node</action></mouse>
636 <note>Double clicking on the path between nodes creates a node in the click point.</note>
637 <keys><key><misc f="Ins"/></key> <action>insert new node(s)</action></keys>
638 <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>
639 <keys><key><shift/>D</key> <action>duplicate selected node(s)</action></keys>
640 <note>New nodes are created on the same path; they are placed exactly over the old ones and are selected.</note>
641 </group>
643 <!-- does not seem to work
644 <group>
645 <title>Active node</title>
646 <note>The active node is one under mouse or being dragged.</note>
647 <note>When you have an active node, some of the single-letter tool switch shortcuts may not work;</note> 
648 <note>move your mouse cursor so that no node is active if you want to use them.</note>
649 <keys><key>c</key>  <action>make active node cusp</action></keys> 
650 <keys><key>s</key>  <action>make active node smooth</action></keys>
651 <keys><key>y</key>  <action>make active node symmetric</action></keys>
652 <keys><key>b</key>  <action>break active node</action></keys>
653 <keys><key><misc-wide f="Backspace"/></key> <action>delete active node</action></keys>
654 </group>
655 -->
657 <group>
658 <title>Mouse select: objects</title>
659 <mouse><key><left-click/></key> <action>click a non-selected object to select</action></mouse>
660 <mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
661 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
662 <note>These work the same as in Selector. The nodes or handles of the single selected object become editable.</note>
663 </group>
665 <group>
666 <title>Mouse select: nodes</title>
667 <mouse><key><left-click/></key> <action>select a node</action></mouse> 
668 <note>Clicking on a node selects it.</note>
669 <mouse><key><left-click/></key> <action>select two adjacent nodes</action></mouse> 
670 <note>Clicking on a selected path between the nodes selects the two nodes closest to the click point.</note>
671 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
672 <note>This adds/removes a node (if clicked on node) or two nodes (if clicked on path) to/from the node selection.</note>
673 <mouse><key><left-click/></key> <action>deselect</action></mouse> 
674 <note>Clicking in an empty space deselects all selected nodes. Next click will deselect the object.</note>
675 </group>
677 <group>
678 <title>Rubberband</title>
679 <mouse><key><left-drag/></key> <action>select multiple nodes</action></mouse>
680 <note>Dragging around nodes does "rubberband" selection; previous node selection is deselected.</note>
681 <mouse><key><shift/><left-drag/></key> <action>add nodes to selection</action></mouse>
682 <note>Normally, you need to start from a point not over a path or a node to initiate a rubberband.</note> 
683 <note>However, if you press Shift before dragging, Inkscape will do rubberband selection even if you start over the path.</note>
685 </group>
687 <group>
688 <title>Node move (mouse)</title>
689 <mouse><key><left-drag/></key> <action>move selected nodes</action></mouse>
690 <mouse><key><ctrl/><left-drag/></key> <action>restrict movement to horizontal or vertical</action></mouse>
691 <mouse><key><ctrl/><alt/><left-drag/></key> <action>move along handles</action></mouse>
692 <note>This restricts movement to the directions of the node's handles, their continuations and perpendiculars (total 8 snaps).</note>
693 <note>If the node has straight lines on one or both sides, this will snap it to these lines' directions and perpendiculars instead.</note>
694 <mouse><key><shift/><left-drag/></key> <action>temporarily disable snapping</action></mouse>
695 <note>Snapping nodes is enabled in Document Preferences. By default, only bounding box of objects snaps to grid/guides.</note>
696 <mouse><key><shift/><left-drag/></key> <action>drag out handle</action></mouse>
697 <note>If a node has a retracted handle, dragging with Shift lets you drag it out of the node.</note>
698 <mouse><key><left-drag/><misc-wide f="Space"/></key> <action>drop a copy</action></mouse>
699 <note>When dragging nodes with mouse, each Space leaves a copy of the selected object.</note> 
700 <note>You can press and hold Space while dragging for a nice "trail."</note>
701 </group>
703 <group>
704 <title>Node handles</title>
705 <mouse><key><left-drag/></key> <action>move a node handle</action></mouse>
706 <mouse><key><ctrl/><left-drag/></key> <action>snap the handle to angle steps</action></mouse>
707 <note>The default angle step is 15 degrees. This also snaps to the handle's original angle, its continuation and perpendiculars.</note>
708 <mouse><key><shift/><left-drag/></key> <action>rotate both handles</action></mouse> 
709 <mouse><key><alt/><left-drag/></key> <action>lock the handle length</action></mouse>
710 <note>Ctrl, Shift, Alt can be combined when dragging handles.</note>
711 <mouse><key><ctrl/><left-click/></key> <action>retract the handle</action></mouse>
712 <note>Retracted handle is zero length; use Shift+drag to drag it back out.</note>
713 </group>
715 <group>
716 <title>Reversing</title>
717 <keys><key><shift/>r</key>  <action>reverse path direction</action></keys> 
718 </group>
720 <group>
721 <title>Editing shapes</title>
722 <note>Node tool can also drag the handles of shapes (rectangles, ellipses, stars, spirals). Click on a shape to select it.</note> 
723 <note>See the corresponding shape tools for their editing shortcuts, all of which also work in node tool.</note>
724 </group>
727 <group>
728 <title>Cancel</title>
729 <keys><key><misc f="Esc"/></key> <action>cancel rubberband or move</action></keys>
730 <note>Press Esc while mouse button is still down to cancel rubberband selection, node move, handle move, or handle move.</note>
731 </group>
733 </section>
735 </column>
736 <column>
741 *<section title="Rectangle tool" color="ebf1fd">
742 <group>
743 <title>Drawing</title>
744 <mouse><key><left-drag/></key> <action>draw a rectangle</action></mouse>
745 <mouse><key><ctrl/><left-drag/></key>   <action>make a square or integer-ratio rectangle</action></mouse>
746 <note>This restricts rectangle so its height/width ratio is a whole number.</note>
747 <mouse><key><shift/><left-drag/></key> <action>draw around the starting point</action></mouse>
748 <note>This creates a rectangle symmetric around the starting point of the mouse drag.</note>
749 </group>
750 <group>
751 <title>Editing</title>
752 <mouse><key><left-click/></key> <action>click an object to select</action></mouse>
753 <mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
754 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
755 <mouse><key><left-drag/></key> <action>drag a handle to resize or round corners</action></mouse>
756 <note>Initially, the two rounding handles are in the top right corner; two resize handles are in top left and bottom right corners.</note>
757 <mouse><key><ctrl/><left-drag/></key> <action>lock width, height, or ratio (resize handles)</action></mouse>
758 <mouse><key><ctrl/><left-drag/></key> <action>lock the corner circular (rounding handles)</action></mouse>
759 <note>Resize handles change the width and height of the rectangle in its own coordinate system, before any transforms are applied.</note>
760 <note>When rounding corners, dragging only one rounding handle (with the other at the corner) keeps the corner circular.</note>
761 <note>You can drag both handles for an elliptic rounded corner, or drag one with Ctrl to make sure the other one is synchronized.</note>
762 <keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
763 </group>
764 </section>
766 *<section title="Ellipse tool" color="ffece8">
767 <group>
768 <title>Drawing</title>
769 <mouse><key><left-drag/></key> <action>draw an ellipse</action></mouse>
770 <mouse><key><ctrl/><left-drag/></key>   <action>make circle or integer-ratio ellipse</action></mouse>
771 <note>This restricts ellipse so its height/width ratio is a whole number.</note>
772 <mouse><key><shift/><left-drag/></key> <action>draw around the starting point</action></mouse>
773 <note>This creates an ellipse symmetric around the starting point of the mouse drag.</note>
774 </group>
775 <group>
776 <title>Editing</title>
777 <mouse><key><left-click/></key> <action>click an object to select</action></mouse>
778 <mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
779 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
780 <mouse><key><left-drag/></key> <action>drag a handle to resize, make arc or segment</action></mouse>
781 <note>Initially, the two arc/segment handles are in the rightmost point; two resize handles are at the topmost and leftmost points.</note>
782 <mouse><key><ctrl/><left-drag/></key> <action>lock circle (resize handles)</action></mouse>
783 <mouse><key><ctrl/><left-drag/></key> <action>snap to angle steps (arc/segment handles)</action></mouse>
784 <note>Resize handles change the width and height of the ellipse in its own coordinate system, before any transforms are applied.</note>
785 <note>The default angle step is 15 degrees.</note>
786 <keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
787 </group>
788 </section>
790 *<section title="Star tool" color="f8f7d5">
791 <group>
792 <title>Drawing</title>
793 <mouse><key><left-drag/></key> <action>draw a star</action></mouse>
794 <mouse><key><ctrl/><left-drag/></key> <action>snap star to angle steps</action></mouse>
795 <note>The default angle step is 15 degrees.</note>
796 </group>
797 <group>
798 <title>Editing</title>
799 <mouse><key><left-click/></key> <action>click an object to select</action></mouse>
800 <mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
801 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
802 <mouse><key><left-drag/></key> <action>drag a handle to vary the star shape</action></mouse>
803 <mouse><key><ctrl/><left-drag/></key> <action>keep star rays radial (no skew)</action></mouse>
804 <mouse><key><shift/><left-drag/></key> <action>round the star</action></mouse>
805 <mouse><key><shift/><left-click/></key> <action>remove rounding</action></mouse>
806 <mouse><key><alt/><left-drag/></key> <action>randomize the star</action></mouse>
807 <mouse><key><alt/><left-click/></key> <action>remove randomization</action></mouse>
808 <keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
809 </group>
810 </section>
812 *<section title="Spiral tool" color="f3f3f3">
813 <group>
814 <title>Drawing</title>
815 <mouse><key><left-drag/></key> <action>draw a spiral</action></mouse>
816 <mouse><key><ctrl/><left-drag/></key>   <action>snap spiral to angle steps</action></mouse>
817 <note>The default angle step is 15 degrees.</note>
818 </group>
819 <group>
820 <title>Editing</title>
821 <mouse><key><left-click/></key> <action>click an object to select</action></mouse>
822 <mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
823 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
824 <mouse><key><left-drag/></key> <action>roll/unroll from inside (inner handle)</action></mouse>
825 <note>Dragging the inner handle adjusts the "inner radius" parameter.</note>
826 <mouse><key><alt/><left-drag/></key> <action>converge/diverge (inner handle)</action></mouse>
827 <mouse><key><alt/><left-click/></key> <action>reset divergence (inner handle)</action></mouse>
828 <note>Vertical Alt+drag of the inner handle adjusts the "divergence" parameter, Alt+click resets it to 1.</note>
829 <mouse><key><shift/><left-click/></key> <action>zero inner radius (inner handle)</action></mouse>
830 <note>Shift+click on inner handle makes the spiral start from the center.</note>
832 <mouse><key><left-drag/></key> <action>roll/unroll from outside (outer handle)</action></mouse>
833 <note>Dragging the outer handle adjusts the "turns" parameter. Use Shift+Alt+drag to roll/unroll without changing radius.</note>
834 <mouse><key><shift/><left-drag/></key> <action>scale/rotate (outer handle)</action></mouse>
835 <note>Use Shift+Alt to rotate only (locks the radius of the spiral).</note>
837 <mouse><key><ctrl/><left-drag/></key> <action>snap handles to angle steps</action></mouse>
838 <note>The default angle step is 15 degrees. This works for both handles.</note>
840 <keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
841 </group>
842 </section>
846 </column>
851 <column>
853 *<section title="Zoom tool" color="e7e9f3">
854 <group>
855 <mouse><key><left-click/></key> <action>zoom in</action></mouse>
856 <mouse><key><shift/><left-click/></key> <action>zoom out</action></mouse>  
857 <mouse><key><left-drag/></key> <action>zoom into the area</action></mouse>
858 </group>
859 </section>
861 *<section title="Freehand tool" color="e9efc5">
862 <group>
863 <mouse><key><left-drag/></key> <action>draw a freehand line</action></mouse>
864 <mouse><key><shift/><left-drag/></key> <action>add to selected path</action></mouse>
865 <note>If a path is selected, Shift+dragging anywhere creates a new subpath instead of a new independent path.</note>
866 <mouse><key><shift/><left-drag/></key> <action>temporarily disable snapping</action></mouse>
867 <note>Shift also temporaily disables snapping to grid or guides when you are drawing with grid or guides on.</note>
868 </group>
869 </section>
871 *<section title="Bezier (Pen) tool" color="e7f5d7">
873 <group>
874 <title>Create nodes</title>
875 <mouse><key><left-click/></key> <action>create a sharp node</action></mouse>
876 <note>If no path is being created, this starts a new path.</note>
877 <mouse><key><shift/><left-click/></key> <action>add to selected path</action></mouse>
878 <note>If a path is selected, Shift+clicking anywhere starts a new subpath instead of a new independent path.</note>
879 <mouse><key><left-drag/></key> <action>create a bezier node with two handles</action></mouse>
880 <mouse><key><shift/><left-drag/></key> <action>move only one handle</action></mouse>
881 <!-- FIXME: also disables snapping! another conflict -->
882 <note>This moves only one handle (instead of both) to create a cusp node.</note> 
883 <mouse><key><ctrl/><left-drag/></key> <action>snap the handle to angle steps</action></mouse>
884 <note>The default angle step is 15 degrees.</note>
885 </group>
887 <group>
888 <title>Create segments</title>
889 <keys><key><ctrl/></key> <action>snap the segment to angle steps</action></keys>
890 <note>This snaps the new node's angle, relative to the previous node, to angle steps (default 15 degrees).</note>
891 </group>
893 <group>
894 <title>Finish</title>
895 <keys><key><misc-wide f="Enter"/></key>  <action>finish current line</action></keys>
896 <mouse><key><right-click/></key> <action>finish current line</action></mouse>
897 <mouse><key><left-click/><left-click/></key> <action>finish current line</action></mouse>
898 <note>Enter, right click, or double left click finish the current line, discarding the last unfinished (red) segment.</note>
899 </group>
901 <group>
902 <title>Keyboard</title>
903 <keys><key><misc f="Esc"/></key>  <action>cancel current line</action></keys>
904 <keys><key><misc-wide f="Backspace"/></key><key><misc f="Del"/></key> <action>erase last segment of current line</action></keys>
905 </group>
906 </section>
908 *<section title="Calligraphy" color="e9dfef">
909 <group>
910 <mouse><key><left-drag/></key> <action>draw a calligraphic line</action></mouse>
911 <mouse><key><left-arrow/></key> <key><right-arrow/></key> <action>adjust pen width</action></mouse>
912 <mouse><key><up/></key> <key><down/></key> <action>adjust pen angle</action></mouse>
913 <note>Width and angle can be adjusted while drawing. </note>
914 <keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
915 </group>
916 </section>
918 *<section title="Gradient tool" color="e9f3e7">
919 <group>
920 <title>Creating gradients</title>
921 <mouse><key><left-drag/></key> <action>create gradient</action></mouse>
922 <note>This creates gradient on selected objects. The Controls bar lets you select linear/radial and fill/stroke for the new gradient.</note>
923 <mouse><key><left-click/><left-click/></key> <action>create default gradient</action></mouse>
924 <note>This creates default (horizontal edge-to-edge for linear, centered edge-to-edge-to-edge for radial) gradient on clicked object. </note>
925 </group>
927 <group>
928 <title>Handles</title>
929 <keys><key><misc f="Tab"/></key>  <action>select next handle</action></keys> 
930 <keys><key><shift/><misc f="Tab"/></key> <action>select previous handle</action></keys>
931 <mouse><key><arrows/></key>  <action>move selected handle by the nudge distance</action></mouse>
932 <mouse><key><shift/><arrows/></key>  <action>move selected handle by 10x nudge distance</action></mouse>
933 <note>The default nudge distance is 2 px (SVG pixel units, not screen pixels).</note>
934 <mouse><key><alt/><arrows/></key>  <action>move selected handle by 1 pixel</action></mouse>
935 <mouse><key><alt/><shift/><arrows/></key>  <action>move selected handle by 10 pixels</action></mouse>
936 <note>The actual distance for pixel movements depends on zoom level. Zoom in for finer movement.</note>
937 <keys><key><misc f="Esc"/></key> <action>deselect handle</action></keys>
938 <mouse><key><left-click/><left-click/></key> <action>open gradient editor</action></mouse>
939 <note>Double clicking a gradient handle opens the Gradient Editor with that gradient and the clicked handle chosen in the stops list.</note>
940 </group>
942 <group>
943 <title>Reversing</title>
944 <keys><key><shift/>r</key>  <action>reverse gradient definition</action></keys> 
945 <note>This mirrors the stop positions of the current gradient without moving the gradient handles.</note>
946 </group>
948 <group>
949 <title>Mouse select</title>
950 <mouse><key><left-click/></key> <action>click an object to select</action></mouse>
951 <mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
952 <mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
953 </group>
955 </section>
958 *<section title="Dropper tool" color="feeffa">
959 <group>
960 <mouse><key><left-click/></key> <action>pick fill color</action></mouse>
961 <mouse><key><shift/><left-click/></key> <action>pick stroke color</action></mouse>
962 <mouse><key><left-drag/></key> <action>average fill color</action></mouse>
963 <mouse><key><shift/><left-drag/></key> <action>average stroke color</action></mouse>
964 <note>Click applies the color under cursor to the current selection. Dragging a radius calculates the average color of a circular area.</note>
965 <note>If a gradient handle (in Gradient tool) is selected, it gets the color instead of the entire object.</note>
966 <mouse><key><alt/><left-click/></key><key><alt/><left-drag/></key> <action>pick inverse color</action></mouse>
967 <note>If Alt is pressed, picking color (with or without Shift, by click or by drag) picks the inverse of the color.</note>
968 <keys><key><ctrl/>C</key> <action>copy color</action></keys>
969 <note>This copies the color under cursor to the system clipboard, as text in RRGGBBAA format (8 hex digits).</note>
970 </group>
971 </section>
974 </column>
978 <column>
979 *<section title="Text tool" color="eefdf3">
981 <group>
982 <title>Selecting/creating</title>
983 <mouse><key><left-click/></key> <action>create/select a text object</action></mouse>
984 <!--<keys><key>letters, digits, space, ...</key> <action>type text in a text object</action></keys>-->
985 <note>Clicking in an empty space or on a non-text creates a text object; now you can type your text.</note>
986 <note>Clicking on a text object selects it; cursor is placed near the click point.</note>
987 <keys><key><misc f="Esc"/></key> <action>deselect the text object</action></keys>
988 </group>
990 <group>
991 <title>Text navigation</title>
992 <mouse><key><arrows/></key> <action>move cursor by one character</action></mouse>
993 <mouse><key><ctrl/><left-arrow/></key> <key><ctrl/><right-arrow/></key> <action>move cursor by one word</action></mouse>
994 <mouse><key><ctrl/><up-arrow/></key> <key><ctrl/><down-arrow/></key> <action>move cursor by one paragraph</action></mouse>
995 <keys><key><misc f="Home"/></key> <key><misc f="End"/></key> <action>go to beginning/end of line</action></keys>
996 <keys><key><ctrl/><misc f="Home"/></key> <key><ctrl/><misc f="End"/></key> <action>go to beginning/end of text</action></keys>
997 <note>All these commands cancel current text selection, if any.</note>
998 </group>
1000 <group>
1001 <title>Flowed text (internal frame)</title>
1002 <mouse><key><left-drag/></key> <action>create flowed text</action></mouse>
1003 <note>Clicking and dragging in an empty space or on a non-text creates a flowed text object with internal frame.</note>
1004 <mouse><key><left-drag/></key> <action>adjust frame size</action></mouse>
1005 <note>Dragging the handle in the lower right corner of the selected flowed text changes width/height of the frame.</note>
1006 <mouse><key><ctrl/><left-drag/></key> <action>lock width, height, or ratio of frame</action></mouse>
1007 <note>Dragging the corner handle with Ctrl resizes the frame preserving either width, or height, or ratio.</note>
1008 </group>
1010 <group>
1011 <title>Flowed text (external frame)</title>
1012 <keys><key><alt/>W</key>         <action>flow text into frame</action></keys> 
1013 <note>With a text object and a shape/path selected, this flows text into the shape/path.</note>
1014 <note>Both remain separate objects, but are linked; editing the shape/path causes the text to reflow.</note>
1015 <keys><key><alt/><shift/>W</key>         <action>unflow text from frame</action></keys> 
1016 <note>This cuts the flowed text's link to the shape/path, producing a single-line regular text object.</note>
1017 <keys><key><shift/>D</key>       <action>select external frame</action></keys> 
1018 <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>
1019 </group>
1021 <group>
1022 <title>Text on path</title>
1023 <keys><key><shift/>D</key>       <action>select path from text</action></keys> 
1024 <note>To find out which path this text is put on, select it and press Shift+D. The path will be selected.</note>
1025 </group>
1027 <group>
1028 <title>Editing text</title>
1029 <note>To type + and - characters, use the main keyboard; keypad + and - are reserved for zoom (unless NumLock is on).</note> 
1030 <keys><key><misc-wide f="Enter"/></key> <action>start a new line or paragraph</action></keys>
1031 <note>Enter in regular text creates new line; in flowed text it creates a new paragraph</note>
1032 <keys><key><ctrl/>U</key> <action>toggle Unicode entry</action></keys> 
1033 <note>To insert an arbitrary Unicode character, type Ctrl+U, then the hexadecimal code point, then Enter.</note>
1034 <note>For example, Ctrl+U 2 0 1 4 Enter inserts an em-dash.</note>
1035 <note>To stay in Unicode mode after inserting the character, press Space instead of Enter.</note>
1036 <note>Press Esc or another Ctrl+U to cancel Unicode mode without inserting the character.</note>
1037 <keys><key><ctrl/><misc-wide f="Space"/></key> <action>insert no-break space</action></keys>
1038 <note>A no-break space is visible even in a text object without xml:space="preserve".</note>
1039 </group>
1041 <group>
1042 <title>Selecting text</title>
1043 <mouse><key><left-drag/></key> <action>select text</action></mouse>
1044 <note>Left-dragging over a text object selects a text span.</note>
1045 <mouse><key><shift/><arrows/></key> <action>select text by character</action></mouse>
1046 <mouse><key><ctrl/><shift/><arrows/></key> <action>select text by word</action></mouse>
1047 <keys><key><shift/><misc f="Home"/></key> <key><shift/><misc f="End"/></key> <action>select to beginning/end of line</action></keys>
1048 <keys><key><ctrl/><shift/><misc f="Home"/></key> <key><ctrl/><shift/><misc f="End"/></key> <action>select to beginning/end of text</action></keys>
1049 <mouse><key><left-click/><left-click/></key> <action>select word</action></mouse>
1050 <mouse><key><left-click/><left-click/><left-click/></key> <action>select line</action></mouse>
1051 <keys><key><ctrl/>A</key>        <action>select all text</action></keys>
1052 <note>This selects the entire text of the current text object.</note>
1053 </group>
1055 <group>
1056 <title>Styling selection</title>
1057 <keys><key><ctrl/>B</key>        <action>make selection bold</action></keys>
1058 <keys><key><ctrl/>I</key>        <action>make selection italic</action></keys>
1059 <note>Also, you can use the Text&amp;Font or Fill&amp;Stroke dialogs to assign any style to text selection.</note>
1060 </group>
1062 <group>
1063 <title>Letter spacing</title>
1064 <keys><key><alt/>&gt;</key> <action>expand line/paragraph by 1 pixel</action></keys>
1065 <keys><key><shift/><alt/>&gt;</key> <action>expand line/paragraph by 10 pixels</action></keys>
1066 <keys><key><alt/>&lt;</key> <action>contract line/paragraph by 1 pixel</action></keys>
1067 <keys><key><shift/><alt/>&lt;</key> <action>contract line/paragraph by 10 pixels</action></keys>
1068 <note>These commands (only when editing text) adjust letter spacing in the current line (regular text) or paragraph (flowed text).</note>
1069 <note>The actual adjustment for pixel movements depends on zoom level. Zoom in for finer adjustment.</note>
1070 </group>
1072 <group>
1073 <title>Line spacing</title>
1074 <keys><key><ctrl/><alt/>&gt;</key> <action>make the text object taller by 1 pixel</action></keys>
1075 <keys><key><shift/><ctrl/><alt/>&gt;</key> <action>make the text object taller by 10 pixels</action></keys>
1076 <keys><key><ctrl/><alt/>&lt;</key> <action>make the text object shorter by 1 pixel</action></keys>
1077 <keys><key><shift/><ctrl/><alt/>&lt;</key> <action>make the text object shorter by 10 pixels</action></keys>
1078 <note>These commands (only when editing text) adjust line spacing in the entire text object (regular or flowed).</note>
1079 <note>The actual adjustment for pixel movements depends on zoom level. Zoom in for finer adjustment.</note>
1080 </group>
1082 <group>
1083 <title>Kerning and shifting</title>
1084 <mouse><key><alt/><arrows/></key> <action>shift characters by 1 pixel</action></mouse>
1085 <mouse><key><shift/><alt/><arrows/></key> <action>shift characters by 10 pixels</action></mouse>
1086 <note>These commands work when editing a regular text object. Kerning does not work in flowed text.</note> 
1087 <note>With no selection, they shift (horizontally or vertically) the characters after the cursor until the end of line.</note>
1088 <note>With selection, they shift the selection relative to the rest of text (by inserting opposite kerns at both ends of selection).</note>
1089 <note>The actual adjustment for pixel movements depends on zoom level. Zoom in for finer adjustment.</note>
1090 </group>
1092 <group>
1093 <title>Rotating</title>
1094 <keys><key><ctrl/>[</key> <key><ctrl/>]</key> <action>rotate character(s) by 90 degrees</action></keys>
1095 <keys><key><alt/>[</key> <key><alt/>]</key> <action>rotate character(s) by 1 pixel</action></keys>
1096 <note>These commands rotate the next character (without selection) or all characters in the selection (with selection).</note>
1097 <note>Rotation only works in regular text (not flowed text).</note>
1098 <note>The actual angle for pixel rotation depends on zoom level. Zoom in for finer movement.</note>
1099 </group>
1101 </section>
1102 </column>
1104 </root>