-----------------------------------------------------------
--
--               SCRIPT EDITOR
--
-- This powerful tool can be used to edit the
-- script objects positions by mouse or keyboard.
--
-----------------------------------------------------------
--
-- READ THIS GUIDE BEFORE USING THE SCRIPT EDITOR
--
-- IF YOU ENCOUNTER PROBLEMS, YOU SHOULD READ THIS
-- GUIDE BEFORE REPORTING ANY PROBLEMS!
--
-----------------------------------------------------------
--
-- Script editor keys:
--
--     Right click = Select object.
--
--     Right click + drag = Select multiple objects. 
--     (Note: press shift to preserve lower than 0.1 precision 
--      for those selected objects positions!).
--
--     Shift + select object = add into current selection.
--
--     Left click = Move selected objects.
--
--     Q, E = Rotate object (Note: all objects doesnt support rotation!)
--     1, 2 = Move object in z-axis. (Alternatives: PageUp/PageDown) 
--     R = Reset object angle to zero.
--     B = Get object 2d position (drop down from sky).
--
--     Arrow keys = Move object in X/Y axises.
--
-- Every movement/rotation keys and mouse object movement
-- can be combined with:
--
--     + SHIFT = High precision movement/rotation.
--     + CTRL = Low precision movement/rotation.
--
-- Example: SHIFT + Q = Rotate with 1 angle precision to left.
-- Example: CTRL + move object = Move object with 0.5 block precision.
--
-- Rotation precisions: SHIFT = 1 degree, Default = 5 degree, CTRL = 45 degree
-- Movement precisions: SHIFT = 0.01, Default = 0.1, CTRL = 0.5
--
-- Other keys:
--
--     Numpad7 = Show/hide invisible objects.
--     Numpad8 = Show/hide while-loop objects.
--     Numpad4 = Show/hide all objects.
--     Numpad1 = Enable/disable script editor.
--     Numpad0 = Switch to 2d/3d script editing mode. (useful for placing objects!)
--
--
-- While editing the script, you can see currently selected object code line.
-- This feature also allows you to browse the code by mousewheel, 
-- and click any code line from the script to go to that position 
-- of the object you clicked. It does not select the object,
-- which becomes useful when you want to move another object to the place
-- you selected from the script, while still holding the object with mouse.
-- The advantages of left/right click also appears when you want to move
-- object at some position in the minimap: when moving the object while 
-- holding left click, you can still right click at the minimap: the object can now
-- be placed at that area once you release the left mouse button.
-- This also works with the big minimap (which can be toggled by holding TAB).
--
--
-- By default all possible objects are displayed in the script editor.
-- You can display only the objects visible in GTA2 by selecting
-- from menu: "Options -> Script objects -> Default layout".
-- Also it is preferred to use that layout when taking screenshots
-- from your maps, or when saving Map image (from "File->Save image" menu).
--
--
-- When you save the script, all supported commands
-- by the editor will be reformatted into cleaner format.
-- Comments are also reformatted to start instantly after the code.
-- All white space before the line will be remained intact.
--
-- Example of output:
-- "        CONVEYOR name = (1.2, 1.3, 1.4) (1.5, 1.6) 1 1 // comment"
-- (no quotes added in the script, only showing the code line edges here)
--
--
-- Note that the selected object will always be placed at the middle of the mouse position.
-- If you want to move object in x/y axises, use arrow keys.
--
-- Note that the selected/focused objects selection rectangles are visible through
-- everything, this is because you can also select objects that way, so it
-- prevents confusion, but it also is useful to see how far some long object
-- goes underground.
--
-- Note that the 2d position picker does not work perfectly same as in GTA2! i recommend
-- avoiding object placement at the exact edges of blocks when there is empty space under
-- or above them at the next block. Although, slope type zero should work perfectly the
-- same as in GTA2.
--
-- There is not currently object add feature, if you want to quickly add objects
-- at your mouse position, right click on the map to copy the x,y,z coordinates at that
-- location, then paste those coordinates in the .mis file at some object coordinates place.
-- Then you can copypaste those objects for example 20 times. Then reload the script file
-- in the map editor, and just move the objects with mouse. Right click+drag, will select
-- multiple objects at once. Then you can save the script, and you are done!
--
-----------------------------------------------------------