===========================================================================================
OMSI Crossing Editor Tools v0.1.0 by sjain/shanie/shanieboop (https://github.com/sjain882)
for OMSI Crossing Editor v1.0.0.0
===========================================================================================
NB: Enable "Word Wrap" in Notepad for easier reading


WHY
====
For years, map developers have been forced to use the basic OMSI Crossing Editor (OMSI 2\SDK\OmsiObjEditP.exe) in order to add pathways to their maps.

In this tool, the only way to control the zoom level of the camera is to click a separate menu and drag a slider with your mouse! This is very painful to use.

On top of this, the default camera FoV (Field-of View) value is locked at 30°, compared to 45° inside OMSI 2's main game, which is slightly disorienting.


FEATURES
=========
Not to worry - with OMSI Crossing Editor tools, you now have full control over the Zoom & FOV inside the OMSI Crossing Editor! With my tool, you can:

- Set default values for the camera zoom & FoV
- Set minimum and maximum limits for the camera zoom & FoV
- Easily adjust the Zoom & FoV with your mouse's scroll wheel (including holding the SHIFT key to increase/decrease speed)
--- The scrolling speed can be fine tuned via configuration files

+--------------------------------------------------+---------------------------------------+
|                     Control                      |                Effect                 |
+--------------------------------------------------+---------------------------------------+
| Scroll Mouse Wheel Up/Down                       | Increase/Decrease Zoom                |
| Hold down SHIFT key + Scroll Mouse Wheel Up/Down | Increase/Decrease Zoom (fast)         |
| Hold down CTRL key + Scroll Mouse Wheel Up/Down  | Increase/Decrease FoV (Field-Of-View) |
+--------------------------------------------------+---------------------------------------+

There is also multilingual support for English, French, German, Polish and Finnish.
‎‎‎
Please note: Additional functionality such as customization of modifier keys is reserved for potential future updates.


INSTALLATION & USAGE (!)
=========================

---> NOTE - These are not what you expect! It is critical that you follow all the below steps and in the exact order given! <--- ‎
‎‎
Please note that this tool requires .NET Framework 4.7.2 to be installed.
If you are using Windows 7 or a version of Windows 10 released before April 2018, you must install it manually from here ("Runtime").
...... https://dotnet.microsoft.com/en-us/download/dotnet-framework/net472
Otherwise, no action is required.

Please note that the OMSI Crossing Editor has a bug where, after an unspecified amount of time, the main view will freeze randomly.
This bug is not caused by OMSI Crossing Editor Tools.
If this happens, simply save your work, close and re-open the application, then disable and re-enable OMSI Crossing Editor Tools.


1) Ensure you have OMSI Crossing Editor downloaded correctly:
--- The file name must be OmsiObjEditP - the tool will not work if you have renamed it!
--- The file must be located in the SDK folder of your OMSI 2 installation folder, so OMSI Crossing Editor can work correctly.
--- e.g., C:\Program Files (x86)\Steam\steamapps\common\OMSI 2\SDK\OmsiObjEditP.exe
--- You can download the OMSI Crossing Editor from here (extract to the OMSI 2\SDK folder)

2) Download the OMSI Crossing Editor Tools .zip archive, open it, and extract the contents of the "Tool" folder to any folder on your PC. ‎

3) Exclude this folder from all anti-virus programs on your PC - or you may experience problems. ‎

4) If you have any games open that use anti-cheat software, please close them!
You must do this step each time you launch the tool. ‎

These steps are necessary due to the nature of the tool.
Don't worry - the source code of this tool will be made available at a later date. ‎

5) Right click on the OMSICrossingEditorTools .exe / Application file and click "Run as administrator".
Click "Yes" if prompted by User Account Control.
A small 🚦 traffic light icon should appear in your notification tray (bottom right of your taskbar)
It is critical that you do this step before continuing onto the next one (due to a bug in OMSI Crossing Editor) ‎

6) Now, open your copy of the OMSI Crossing Editor. ‎

7) In the top-left, click Object > Load... and open your desired .sco file from OMSI 2\Sceneryobjects.
It is critical that you have an object/crossing loaded at this stage. ‎
‎
8) Right click on the previously mentioned 🚦 traffic light icon in your tray, and click "Enable tool" .
‎
9) Click on the OMSI Crossing Editor so it is the focused window.
The tool will not work unless you have the OMSI Crossing Editor focused. ‎
‎
10) Use the controls listed in the the table under the "Features" section above.
‎
If you are opening a new object in the Crossing Editor, please disable the tool before doing so, and re-enable it after it is loaded.
‎‎
11) If you wish, you can change some settings by right clicking on the 🚦 traffic light icon in your tray, then "Edit settings..."
- a text file with descriptions for each setting in your language will open. You can adjust various parameters here.
Once you have finished, save and close the file, then right click on the 🚦 traffic light icon in your tray, then "Reload settings".
‎‎
12) Once you have finished using OMSI Crossing Editor for the day, it's a good idea to right click on the 🚦 traffic light icon in your tray, and click "Exit".


CREDITS
========
sjain / shanie / shanieboop - Reverse engineering of OMSI Crossing Editor, creating this tool

Nano - Testing & suggestions

BowsyCh16, Sobol, volvorider - Testing & translation

Erilambus, HalberCode - Translation

Various C#.NET libraries - ini-parser, WInputManager, Memory.dll.x86


CODE SIGNED DIGITAL CERTICIATE
==============================

All *.dll binary files of this project compiled by me are digitally self-signed. The attached certificate should carry this serial number:

18f6cc78c0fa778b4545c6d9d135cb52

If the serial number on your copy does not match this, or the digital certificate is missing the file has potentially been tampered with and should be deleted immediately.

You can check this by right clicking on the OMSI Crossing Editor Tools .exe / Application file > Properties > Digital Signatures > Select the one named "sjain882" > Details > View Certificate > Details > Serial Number.

‎
COPYRIGHT & LICENSING
======================
Copyright © 2022 sjain882. All rights reserved.
For use with MR-Software GbR's OMSI 2 - Der Omnibus Simulator OMSI Crossing Editor Tools only.
All images and logos remain property of their respective owners.

You may not re-distribute this software unless given permission by the author.

Contact author: https://reboot.omsi-webdisk.de/community/conversation-add/?userID=10383

If you cannot agree to the above terms and conditions, please delete this software immediately. Ignorance of these terms and conditions is not an excuse for breach!

