|
| 1 | +# Keyboard Shortcuts |
| 2 | + |
| 3 | +You can customize the keyboard shortcuts or the combination of keys + |
| 4 | +[mouse wheel](mouse-wheel.md) (or [mouse movement](drag-value.md)) |
| 5 | +from *Edit > [Keyboard Shortcuts](keyboard-shortcuts.md)* |
| 6 | +menu option or <kbd>Ctrl+Alt+Shift+K</kbd> key (or <kbd>⌥⇧⌘K</kbd> on macOS). |
| 7 | + |
| 8 | +There is a general overview of the default keyboard shortcuts in the [Quick Reference](/quickref/) page. |
| 9 | + |
| 10 | +## Menus & Commands |
| 11 | + |
| 12 | +In these sections you will find a way to assign a key to every |
| 13 | +action/command in Aseprite that is accessible from the [menu bar](menu-bar.md) |
| 14 | +and other commands that are not part of the main menu but are still |
| 15 | +accessible for advanced users (e.g. "Set Ink Type" |
| 16 | +is not associated to any menu or has default keyboard shortcut, but |
| 17 | +you can assign a key from the "Commands" section). |
| 18 | + |
| 19 | +Remember to use the search field in this dialog to filter and find a |
| 20 | +specific command. |
| 21 | + |
| 22 | +## Tools |
| 23 | + |
| 24 | +In the Tools section you will find a way to see and change the keys |
| 25 | +associated with each tool from the [Tool Bar](tool-bar.md). There are |
| 26 | +two main considerations: |
| 27 | + |
| 28 | +1. Two or more tools can share the same key. In this case pressing the |
| 29 | + key multiple times will switch/go through all the tools that have |
| 30 | + the same key assigned. E.g. <kbd>U</kbd> key is assigned to the |
| 31 | +  Rectangle and |
| 32 | +  Filled Rectangle |
| 33 | + by default, so pressing one time |
| 34 | + will select the Rectangle tool, and pressing it a second time will |
| 35 | + switch to the Filled Rectangle. |
| 36 | +2. There are two ways to select a tool: |
| 37 | + * A regular way to change the |
| 38 | + active tool, it's when you press a key and the active tool changes so |
| 39 | + all the following mouse buttons will interact with that tool. |
| 40 | + E.g. pressing the <kbd>P</kbd> key switches to the  Pencil |
| 41 | + tool, or the <kbd>H</kbd> key selects the  Hand |
| 42 | + tool as the active one, so then you can pan the [sprite editor](sprite-editor.md) |
| 43 | + just dragging it with the left mouse button + moving the mouse |
| 44 | + without pressing any other key. |
| 45 | + * An alternative quick way (identified as "(quick)" in the *Keyboard Shortcuts* dialog) |
| 46 | + where the tool is active while you keep the key pressed (and then Aseprite |
| 47 | + returns to the previously selected tool when you release the key). |
| 48 | + This happens with the <kbd>Alt</kbd> key to select the  Eyedropper tool |
| 49 | + or the <kbd>Space bar</kbd> key to select the  Hand tool temporarily. |
| 50 | + Here an example of how the  Hand tool |
| 51 | + looks in the configuration: |
| 52 | + |
| 53 | +  |
| 54 | + |
| 55 | +## Action Modifiers |
| 56 | + |
| 57 | +These actions depend on a specific context in Aseprite, for example |
| 58 | +when you have a selection tool, or you are scaling a selection, etc. |
| 59 | +The given keys are the default options. |
| 60 | + |
| 61 | +The following is the list of contexts and the possible actions inside |
| 62 | +that context: |
| 63 | + |
| 64 | +* **Freehand Tool**: When the  Pencil tool |
| 65 | + is active. |
| 66 | + * **Straight Line from Last Point**: Use the <kbd>Shift</kbd> key |
| 67 | + to create a straight line from the last painted pixel with the brush. |
| 68 | + * **Angle Snap from Last Point**: Add the <kbd>Ctrl</kbd> key |
| 69 | + to snap the angle of that straight line. |
| 70 | + |
| 71 | +* **Move Tool**: When you are using the  Move tool. |
| 72 | + * **Auto Select Layer**: If you press the <kbd>Ctrl</kbd> (or <kbd>⌘</kbd> on macOS) |
| 73 | + you'll select the layer that is above the cursor with a single click. |
| 74 | +* **Shape Tool**: These keys can be used while you are drawing (after pressing & before releasing the mouse button) |
| 75 | + with a rectangular or elliptical-like tool (e.g.  Rectangle, |
| 76 | +  Ellipse, |
| 77 | +  Rectangular Marquee, etc.). |
| 78 | + * **Square Aspect**: You can use the <kbd>Shift</kbd> key to create a square or a circle. |
| 79 | + * **Draw From Center**: You can use the point where the mouse was |
| 80 | + pressed as the center of the shape when pressing the <kbd>Ctrl</kbd> key, e.g. to create an ellipse specifying the center (instead of both corners). |
| 81 | + * **Rotate Shape**: Pressing the <kbd>Alt</kbd> you start rotating the shape. |
| 82 | + * **Move Origin**: You can press the <kbd>Space</kbd> key to move the |
| 83 | + whole shape to a new position before releasing the mouse button, just in case |
| 84 | + the origin was not specified correctly. |
| 85 | +* **Selection**: When we have any selection tool we can use some keys to |
| 86 | + change what to do with the selected area. |
| 87 | + * **Add/Subtract/Intersect Selection**: These options |
| 88 | + are explained in the [Selecting](selecting.md#add/subtract/intersect) section. |
| 89 | +* **Translating Selection**: When you're moving the selection. |
| 90 | + * **Snap To Grid**: Pressing <kbd>Alt</kbd> the selection will snap to grid. |
| 91 | + * **Lock Axis**: You can use <kbd>Shift</kbd> to lock the movement in the X or Y axis only. |
| 92 | + * **Copy Selection**: With <kbd>Ctrl</kbd> key you can copy the |
| 93 | + selection if you press it *before* you start moving the |
| 94 | + selection. |
| 95 | + * **Fine Translating**: When you are moving the selection, pressing |
| 96 | + the <kbd>Ctrl</kbd> will start a fine-tuning movement (not only |
| 97 | + pixel by pixel, but by subpixels). |
| 98 | +* **Scaling Selection**: When you're scaling the selection. |
| 99 | + * **Maintain Aspect Ratio**: Press <kbd>Shift</kbd> key to keep the |
| 100 | + ratio between width/height intact. |
| 101 | + * **Scale From Center**: Scale from the center (or current pivot |
| 102 | + position) using the <kbd>Alt</kbd> key. |
| 103 | + * **Fine Scaling**: When you are scaling the selection, pressing |
| 104 | + the <kbd>Ctrl</kbd> will start a fine-tuning scaling (not only |
| 105 | + pixel by pixel, but by subpixels). |
| 106 | +* **Rotating Selection**: When you're rotating the selection. |
| 107 | + * **Angle Snap**: You can use the <kbd>Shift</kbd> key to snap the |
| 108 | + angle to angles of 26.6°, 45°, 90°, etc. |
| 109 | + |
| 110 | +* **Trigger Left/Right Mouse Button**: You can configure a specific |
| 111 | + key to simulate the left/right mouse buttons inside the [sprite |
| 112 | + editor](sprite-editor.md). |
| 113 | + |
| 114 | +## Keyboard + Mouse |
| 115 | + |
| 116 | +You can configure to trigger some special actions when a key is |
| 117 | +pressed and the mouse wheel is moved (or the mouse itself is moved in |
| 118 | +a specific axis): |
| 119 | + |
| 120 | +* [Mouse Wheel](mouse-wheel.md) |
| 121 | +* [Drag Value](drag-value.md) |
| 122 | + |
| 123 | +--- |
| 124 | + |
| 125 | +**SEE ALSO** |
| 126 | + |
| 127 | +[Preferences](preferences.md) | |
| 128 | +[Customization](customization.md) |
0 commit comments