REMINDER ABOUT COPYRIGHT

The Open Rails source code and executables are copyrighted 2007-2014 by the Open Rails team.    The program is distributed under the terms of the GNU General Public License V3 .

OPEN RAILS SVN SERVER

The Open Rails source code is managed on our svn server at:

http://svn.uktrainsim.com/svn/openrails/trunk

Read only access is provided with guest login:

        User Name = orpublic

        Password = orpublic

You can use an SVN client such as TortoiseSVN  to access the files,

or simply view the repository with most web browsers at the above link.

ACCESSING THE CODE WITH TORTOISESVN:

PLEASE TAKE A LOOK AT THE TORTOISE SVN HELP IF YOU ARE NOT FAMILIAR WITH SVN.

DOWNLOADING THE CODE

On your desktop

1. Right click, select SVN Checkout ...

In the Checkout Dialog Box

2. Enter URL of repository: " http://svn.uktrainsim.com/svn/openrails/trunk "

User Name = orpublic

        Password = orpublic

3. Checkout Directory indicates where the files will go ie: C:\Users\Wayne\Desktop\openrails

4. Click OK

Note: ensure you retain the directory structure of the trunk.

The main folders in the repository are:

  1. Program - pre-compiled executables for inclusion in the installation package
  2. Source - the principle source code files
  3. Addons - accessory files to be shipped with the installation package
  4. Documentation - instruction manuals and other miscellaneous documentation
  5. Architecture - an incomplete experiment in restructuring the program
  6. Archive - abandoned code
  7. SVNTesting - sandbox for training new users on SVN

COMPILING OPEN RAILS

Here's some info to get you started with compiling and debugging the Open Rails source code.

Ensure you have the following installed:

- Visual C# 2010/2012/2013 Express (free or pro ) Edition ( Must be installed first! )

- XNA Game Studio 3.1 ( Developer Tools )

After you have downloaded the code:

1. Open folder Source

2. Double click on ORTS.sln to open Visual Studio

On the Visual Studio menu bar

3. Select Build, then Rebuild Solution

4. On the status bar ( lower left ) observe 'Rebuild All succeeded'

RUNNING THE RUNACTIVITY.EXE CODE IN DEBUG MODE

Note: debugging involves bypassing the normal startup menus and specifying a specific activity on the command line

On the Visual Studio menu bar

5. Select View, then Solution Explorer

In the Solution Explorer box ( on the right )

6. Right click on RunActivity, then select Properties

7. Find the debug tab on the left

On the debug tab

8. Enter in quotes, the path of the activity that you want to run ie "c:\personal\msts\routes\lps\activities\ls1.act"

In the Solution Explorer box

9. Right click on RunActivity, then select Debug, then 'Start New Instance' ( or press F5)

PS - thanks to www.uktrainsim.com for donating the SVN server space and admin services.