Updated editor controls (markdown)

editor-controls.md

@@ -8,4 +8,76 @@ Note that by default you'll only be able to open the editor in mods; for vanilla
 
 [OSE only] Mods can also choose to disable normal access to the editor by setting `blockEditor="1"` in the [[Mod main XML|mod-xml]] file. This setting is ignored when developer mode is on.
 
+# Keyboard gotchas
+
+This wiki uses the [US keyboard layout](https://en.wikipedia.org/wiki/File:IBM_Model_M.png) as a reference. Remember that the US keyboard layout is not the only one in existence. 
+
+If you use e.g. a [german keyboard](https://en.wikipedia.org/wiki/File:IBM_Model_M_1391403_keyboard.jpg) you'll have to adapt in your head.
+
+### OSE version (using SDL 2)
+
+OSE uses [scancodes](https://en.wikipedia.org/wiki/Scancode) to detect key presses, that means whatever label the key has doesn't matter, only it's location on the board.
+
+### Older versions and OSE builds using SDL 1.2
+
+SDL 1.2 does not support scancodes, therefore the system's keyboard layout matters. So if you use a non-US keyboard layout then keys to use a certain function might be located in different places. Or not. It actually depends on the operating system. It's up to you to figure out the differences when using an older version.
+
 # Editor modes
+
+The editor has 3 main operating modes:
+
+* Tile edit mode (_F5_)
+* Entity edit mode (_F6_)
+* Node edit mode (_F7_)
+
+Switch between modes by pressing _F5_-_F7_ keys.
+
+# Common controls
+
+* _W_/_A_/_S_/_D_, Hold _MMB_/Mouse wheel and drag: Move the viewport aroun_
+* _P_: Place Naija on the mouse cursor
+* _F9_: Toggle obstruction overlay
+* _F10_: Open dialog to move all tiles from one layer to another layer
+  * You need to use actual [[Layer numbers|layers]] here.
+  * It's recommended not to use this (You can just zoom out a lot, select everything, and move the selection to the new layer)
+* [OSE only] _F8_: Dump map grid as TGA file
+  * This is useful to reconstruct a map template from a map XML file if the original map template was lost. The reconstruction is not perfect due to an unfixable bug. It's complicated. You will probably not need this.
+* _PgUp_/_PgDown_, Mouse wheel: Zoom
+  * OSE zooms to the cursor
+  * Older versions zoom relative to the upper left corner of the map. Very inconvenient.
+
+# Tile edit mode (_F5_)
+
+When this mode is active, tiles on the currently active layer are highlighted (border around each tile; dot in the center). The border & dot of selected tiles are bright white; unselected tiles are grey.
+
+There are two modes of selection in this mode. All operations normally affect the tile under the cursor on the currently active layer. Alternatively you can use _Alt_ to select multiple tiles, then all selected tiles will be affected. Tap _Alt_ to clear the multi-selection.
+
+Key bindings:
+
+* Press one of the [[Layer|layers]] keys to switch to that layer. Tiles on that layer will be highlighted by a white border.
+* Drag while holding _LMB_: Move tile(s) around.
+* Shift+[[Layer|layers]] key: Move tile(s) to that layer.
+* _Shift_ + _LMB_: Clone tile under cursor.
+  * Multiple tiles: Clone all selected tiles, and select the new tiles.
+* Hold _RMB_ + drag mouse to the left or right: Rotate tile under cursor
+  * Multiple tiles: rotate all tiles around the selection center.
+* Hold _Shift_+_RMB_ + drag mouse to the left or right: Uniformly scale tile under cursor
+  * Multiple tiles: scale all tiles around the selection center.
+* Hold _Ctrl_ + drag mouse to the left or right over a tile: Rotate tile in 45° increments (useful for energy temple style maps where you need a lot of right angles)
+  * Multiple tiles: Rotate all tiles around the selection center by 45° increments
+  * This is quite fiddly and there's rarely a use case for this.
+* _Shift_+_C_+_RMB_ + Drag mouse left/right: Stretch tile in X-direction
+* _Shift_+_V_+_RMB_ + Drag mouse up/down: Stretch tile in Y-direction
+* _T_: Flip tile under cursor horizontally (does not respect multi-selection)
+* _Y_: Flip tile under cursor vertically (does not respect multi-selection)
+  * It's recommended not to use this. The same orientation can be achieved by flipping horizontally and then rotating by 180°.
+* _X_: Move tile to the front in the current layer (draw over everything else)
+* _Z_: Move tile to the back in the current layer (draw under everything else)
+* Hold _Alt_ and drag the mouse to select multiple tiles. Think that this spans an invisible selection rectangle between where the cursor was when you pressed _Alt_ and where the cursor is now. All tiles inside of this rectangle are selected until you release _Alt_.
+  * Tap _Alt_ to clear the multi-selection
+
+
+# Entity edit mode (_F6_)
+
+
+# Node edit mode (_F7_)