Updated editor controls (markdown)

editor-controls.md

@@ -22,6 +22,8 @@ If you use e.g. the [german keyboard layout](https://en.wikipedia.org/wiki/File:
 
 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.
 
+This is usually what you want for editing purposes, as the keys are somewhat laid out to make sense. On a US-keyboard, that is.
+
 ### 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.
@@ -38,6 +40,10 @@ Switch between modes by pressing _F5_-_F7_ keys.
 
 # Common controls
 
+* _F1_: Reload the map
+* _Shift_ + _F1_: Load map, ask user for the name
+* _F2_: Save map
+
 * _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
@@ -53,6 +59,8 @@ Switch between modes by pressing _F5_-_F7_ keys.
 
 # Tile edit mode (_F5_)
 
+![Tile edit mode](http://fg.wzff.de/pub/aquaria/wikidata/editmode-tiles.jpg)
+
 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.
@@ -72,6 +80,8 @@ Key bindings:
   * Works the same way as _E_/_R_ except with a lot less keyboard hammering involved.
 * Drag while holding _LMB_: Move tile(s) around
 * _Shift_+[[Layer|layers]] key: Move tile(s) to that layer
+* _Alt_+[[Layer|layers]] key: Show/Hide layer.
+  * Particularly useful for the [[Dark layer|layers]] (_Alt_+_J_).
 * _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
@@ -92,6 +102,8 @@ Key bindings:
   * 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)
+* _C_/_V_ : Align tile(s) to grid boundary
+  * Not sure why this function exists, seems redundant and fiddly
 * 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
 * _Home_: Set ghost tile to [[Tile 0|tilesets]]
@@ -108,5 +120,49 @@ Key bindings:
 
 # Entity edit mode (_F6_)
 
+![Entity edit mode](http://fg.wzff.de/pub/aquaria/wikidata/editmode-entities.jpg)
+
+There is no multi-selection in entity edit mode. Also not all entities have a selection rectangle. (It depends on whether an entity is simply a tile graphic or has a skeletal model. If there's a skeleton, the tile graphic is invisible, and so is the border.)
+
+About entity placement: Most entities you can spawn move around in some way. This means that once you save the map, some entities might not be anymore where you placed them. **Fear Not!** Entities retain their initial placement point; that's what's saved in the map.
+
+The initial placement point gets updated when you grab an entity and move it somewhere manually.
+If in doubt, reload the map and immediately afterwards enter the editor, then all entities are probably close to where they are originally placed.
+
+
+Key bindings:
+
+* _Ctrl_ + _E_: Open entity selection screen. For some reason this does not work when the cursor is hovering over an entity.
+  * Click an entity to select
+  * Alternatively, press _Space_ while hovering an entity. This will select it and close the selection screen.
+  * Press _E_/_R_ to cycle through [[entity groups|entity-groups]]
+  * Press _Esc_ to close
+  * [Windows only] _Double click left_: There used to be a function to open the entity script file in the associated text editor, but it's broken for mods.
+* _Space_: Place entity
+* _Backspace_/_Delete_: Delete entity
+  * If you're using a pre-OSE version and the entity is not from the vanilla game, this will crash.
+* _Ctrl_ temporarily rotates an entity to 45° increments but it doesn't seem to be permanent.
+
+
+# Node edit mode (_F7_)
+
+![Node edit mode](http://fg.wzff.de/pub/aquaria/wikidata/editmode-nodes.jpg)
+
+
+# Reloading a map
+
+On map (re)load via the editor, the OSE version additionally reloads the following:
+
+* [[Particle data|particles]]
+* [[Shot data|shots]]
+* [[Entity groups|entity-groups]]
+* [[Tile effects|tile-effects]]
+* [[Song data|songs]]
+* [[Game strings|stringbank]]
+
+So in any case, if you changed some data or the editor spazzed out, in most cases you can just save & reload the map and carry on.
+
+Previous versions need to reload data manually via the [[Debug menu|debug-menu]], but this will not reload everything of the above list.
+
+Particle data can also be reloaded in the [[Particle viewer|particle-viewer]].
 
-# Node edit mode (_F7_)