=====================================
Birmingham Cross-City South BVE Route
[Redditch to Birmingham New Street]
-------------------------------------
By Anthony Bowden
(see below for additional credits)

www.railsimroutes.co.uk

Version 1.31.03 (September, 2009)

*BVETSS 1.0 Compliant*
[www.railsimroutes.co.uk/bvetss]
=====================================

Please turn on "Word Wrap" in your text editor.

------------
-=Contents=-
------------

- Important Note
- Introduction
- openBVE
- Note regarding route foldernames
- Terms of Use
- Files by other authors
- Special thanks to...

------------------
-=Important Note=-
------------------

The official version of this route is available for download ONLY from the Rail Sim Routes UK website: [www.railsimroutes.co.uk].

If you need help and support, I'm happy to help; but firstly, please download the latest, official version of the route from www.railsimroutes.co.uk and see if your issues are resolved. I only offer support for unmodified versions of the route, downloaded from my own site. If you need help, the first thing I'll ask you to do, is download the latest official version and try it. This way, I can be sure you're using the same version that I'm using. :)

Additional Note: This readme highlights terms of use, acknowledgements and basic information only, and is not the main route documentation. For route information, instructions, help and more detailed acknowledgments, please see the following file:

"<Installation Path>\Railway\Object\Bham_X-City_South\Readme - Cross-City South.htm"

----------------
-=Introduction=-
----------------

Thank you for downloading this add-on. It is hoped that you enjoy using this train with either openBVE, or BVE Trainsim:

http://openbve.trainsimcentral.co.uk
http://mackoy.cool.ne.jp

This route contains both Open Source and Copyright material, and has been built in accordance with the principles outlined by the BVE Developer Guidelines. For more information please visit:

[www.railsimroutes.co.uk/developerguidelines]

This add-on is compliant with the BVE Track Sound Standard [BVETSS], so whenever this route is used in combination with a BVETSS compliant train, the correct track sounds are guaranteed to be heard. To find out more, please visit the BVETSS site:

[http://www.railsimroutes.co.uk/bvetss]

The Cross-City South uses the BVE v4 compatible class 323 25kV AC EMU, a joint project between the Train Sim Central Team [http://www.trainsimcentral.co.uk], Simon Gathercole and myself. The class 323 for BVE v4 is available from:

[http://www.trainsimcentral.co.uk]

The BVE v2 compatible class 323 EMU is also available from Trainsimcentral:

[http://www.trainsimcentral.co.uk]

-----------
-=openBVE=-
-----------

Version 1.31 of the Cross-City South is compatible with openBVE v1.0, and includes some bug fixes to eliminate coding errors. For openBVE users, it's a temporary release until Cross-City South v1.4 is released.

Any problems encountered while using the Cross-City South with openBVE will be resolved with new route updates; please keep checking [www.railsimroutes.co.uk] for bug fixes or new releases. If you have any issues with this route in openBVE, please *contact me* about the problem (via http://www.railsimroutes.co.uk/contact.html), rather than openBVE's developer, who is busy enough as it is without being distracted by problems with this route!

openBVE performs significantly better than BVE versions 2 and 4, therefore the High Detail routes should run fine. I recommend that the routes designed for BVE 4 be used.

------------------------------------
-=Note regarding route foldernames=-
------------------------------------

For BVE v4 users:
-----------------

BVE v4 users have a choice of three detail levels: High, Medium and Low Detail. BVE v4 compatible route files / activities are found in the following folder by default:

<System Drive>:\Program Files\mackoy\BVE4\Railway\Route\Birmingham_Cross-City_South_BVE4\

For BVE v2 users:
-----------------

If you use BVE 2, then you need to install all the Cross-City files into your BVE 2 folder first, otherwise the routes won't be visible to BVE. The easiest way to do this, is simply to run the installers you downloaded again, but this time, choose to install to BVE 2's home directory rather than BVE 4's, usually:

<System Drive>:\Program Files\BVE\

BVE v2 users have a range of detail levels to choose from, depending on your system's capabilities, and the operating system you use - if you have Windows XP or 2000 then you should use the 'High Detail XP' routes, and if you use Windows 9x, you should use the 'High Detail 9x' routes. Please see the main documentation for more details about these detail levels. Once you've installed Cross-City South into your BVE v2 directory, the BVE v2 compatible route files / activities can be found in the following folder:

<System Drive>:\Program Files\BVE\Railway\Route\Bham_X-City_South\

----------------
-=Terms of Use=-
----------------

This route package contains a mixture of copyright-free/open source material, and copyright material. The copyright-free/open source files can be freely modified and re-released, without seeking my permission--please feel free to let me know if you're re-releasing any material, but you don't have to. :)

Copyright material cannot be re-released without my permission (or the permission of the copyright material's owner), usually because I required permission to use those files myself, or I had to obtain a licence to use them. For re-use of copyright material, you can contact me via the e-mail address on the Rail Sim Routes UK website [www.railsimroutes.co.uk], or in the case of files created by other authors, by using any contact details mentioned further down.

Copyright material can be found in the following, seperate folders:

"<Installation Path>\Railway\Object\Bham_X-City_South\CopyrightMaterial\"
"<Installation Path>\Railway\Sound\Bham_X-City_South\CopyrightMaterial\"

Any files within a "Bham_X-City_South\" folder, but *not* within a "CopyrightMaterial\" folder, can be considered copyright-free, or open source. If in doubt, please open any files you wish to re-use in a text editor, and read the header at the start of the file, which states whether the file can be freely redistributed or not.

If any copyright-free/open source files are re-used, then I, along with any other contributors to this add-on, would still be grateful for acknowledgement and credit, preferably by mentioning names, and providing links back to websites if applicable. This could be done in your "Readme", and perhaps on your download page.

** Existing documentation, readme's, acknowledgements and credits should be retained and included in any redistributed material **

Copyright material cannot be distributed on disk, CD, or any other medium without my prior written permission, in accordance with any restrictions or requirements I need to specify. Copyright material may not be sold at any price or for profit under any circumstances.

Finally, not all files contained within this route are my own work--some files have been used with permission from other authors. If these files are copyight material, then before re-using them, permission must be obtained from the original author(s) if their contact details are present. For details of these specific files, please see below.

*** Important--Station Announcements and Copyright ***

The Birmingham New Street station announcements in this route are used with the kind permission of the copyright owners, Ditra Systems Ltd, with special thanks also to Phil Sayer. These files must not be re-used without explicit permission from Ditra Systems Ltd.

--------------------------
-=Files by other authors=-
--------------------------

Steve Green [www.trainsimcentral.co.uk]

Files: BrSigs\*.*, CE_150*.csv/.x, CT_170*.csv/.x, CE_323*.csv/.x, Mk1rs.csv/.x (excluding RES textures)

The files in the BrSigs folder are from Steve Green's BR Signals Pack for BVE v4. The above objects and associated textures (unless otherwise stated) were originally created by Steve Green, since modified by myself with night lighting features.

----------------

Robert Glass [http://scotrailsim.co.uk]

Files: 47_VT.csv/.x (excluding Virgin Trains textures), 47rs.csv/.x, 37_EWS.csv/.x, Passengers1.csv/.x, HST*.csv/.x (cab front texture modified by myself)

The above objects and associated textures (unless otherwise stated) were originally created by Robert Glass for the Sandymill-Invermay route, since modified by myself with night lighting features.

----------------

Simon Townsend

Files: Guvrs.bmp, Mk1rs.bmp, CL47_rs4.bmp

The above RES livery textures were created by Simon Townsend, and used with permission in the Cross-City South.

----------------

Robert Glass and Simon Townsend

Files: 37*.bmp

The above EWS class 37 textures were jointly created by Robert Glass and Simon Townsend, and used with permission.

----------------

Simon Gathercole

Files in the "BVE\Railway\Object\Bham_X-City_South\Day\Winter\Common_Textures\" and "BVE\Railway\Object\Bham_X-City_South\Day\Autumn\Common_Textures\" folders:

b1.bmp, Hedgerow2.bmp, t1.bmp, Tree_Pair.bmp, TreeWall.bmp

Other files: Passengers1_xp.csv

The route includes new Autumn and Winter tree textures kindly made by Simon Gathercole, and used with his kind permission.

----------------
Phil Sayer, Ditra Systems Ltd

Files: BNS*.wav

The Birmingham New Street station announcements in this route are used with the kind permission of the copyright owners, Ditra Systems Ltd, with special thanks also to Phil Sayer. These files *must* not be re-used without the permission of Ditra Systems Ltd.

----------------
Evgeny Shatohin

Files: People02.bmp

This texture was created by Evgeny Shatohin, and is included as part of his excellent 'Easy People' tool, available from http://jvs.ru/easytool/

----------------
Andy Slater [www.brdw.co.uk]

Files: 20pass.wav

The Cross-City South contains a sound sample originally by Andy Slater, and used with his kind permission. The above file may not be used without the permission of both Andy Slater and myself.

----------------

John Owen [http://www.rwysnd.btinternet.co.uk]

Files: 66horn.wav, 66pass.wav, 323_aws_bing.wav, 323_aws_horn.wav

The route also contains sound samples originally recorded by John Owen, used with permission. The two 66 sounds may not be used without the permission of both John Owen and myself. The two AWS samples are freely available for route developers to use, so long as John Owen is credited for these sound samples. These sounds can also be found in the BVE Sounds section of Rail Sim Routes UK - [www.railsimroutes.co.uk/miscfiles/sounds/index.html]

----------------

Jason Morgan

Files: tamper_pass.wav

A further track machine sound sample originally recorded by Jason Morgan has been also used with permission. The above file may not be used without the permission of both Jason Morgan and myself.

------------------------
-=Special thanks to...=-
------------------------

Thanks in particular goes to the following people, without whom the Cross-City wouldn't have been nearly as detailed, accurate, complete or enjoyable to build:

Steve Green [www.trainsimcentral.co.uk]:

For supplying invaluable route data, offering useful feedback on the accuracy of the route, for kindly offering to build the original class 150, 170 and 323 CSV objects and textures for the Cross-City South, for his work on the new Class 323 for BVE v4, and of course for extensive route testing and expertise.

Simon Gathercole:

For drawing and supplying the wonderful new Autumn and Winter tree and hedgerow textures, as well as enhancing existing Summer and Dusk tree textures. For assisting with the development of the DirectX objects using emissive properties to create realistic night lighting. Also for his amazing work developing the plugin Dynamic Link Library, giving a host of functions to the BVE 4 class 323 EMU.

Robert Glass [http://scotrailsim.co.uk]:

For conducting extensive testing of the route on several occasions, providing extra inspiration and feedback where various aspects of the route are concerned; for giving me the idea for using CSV Cylinder commands to re-create more realistic headlight effects, for assisting with the maths involved in creating the "smooth curves", for allowing me to use and adapt his "Falling Snow" objects from his excellent Sandymill to Invermay Seasonal Special, and for allowing the use of his class 37, 47 and Merry-Go Round coal hopper wagons.

Bryan Dudley [http://railtech.topcities.com]:

For supplying some superb images of hillsides and the Birmingham city centre skyline which have been combined with my own photo-realistic skies and Birmingham suburb image backdrops, and for testing the route on more than one occasion, and offering helpful feedback.

Dave Barton:

For supplying some excellent photographs which have enabled a more photo-realistic cab interior to be created (BVE 2 class 323), and also for testing the route.

Matt Wilson:

For offering his expert feedback on the accuracy of the route, and for supplying a class 323 cab photo from which the current 323 passenger view gauges have been made.

Richard Cartmell:

For his extremely helpful and constructive feedback and advice, and for thoroughly testing the route on more than one occasion. 

Simon Townsend:

For helping with various textures used in the route, not least certain station sign bitmaps, the RES liveried textures for the Mk1 and GUV coaching stock, and for working with Robert Glass to create the EWS textures used with the Class 37 CSV object. Also for testing the route and providing feedback on more than one occasion.

Alan Lee [www.jubileeline.org.uk]:

For being very kind and writing a superb review of the "Pre-Beta" preview of the Cross-City South, and for testing the route and offering helpful and encouraging feedback.

Alex Totney:

For testing the route on numerous occasions, offering helpful feedback, suggestions and support for the Cross-City project. 

John Owen [http://centralsim.tripod.com]:

For recording the passing train sounds for the class 66, and allowing them to be used in the Cross-City South, and for supplying the digital AWS sounds used in the route

Stephen Cross [http://ozrail.cjb.net]:

For originally suggesting I add shadows under the passing trains, which led me to develop my "Alpha Enabled" angled shadow effects.
 
Rich Haywood:

For being extremely helpful during the Beta testing, and for taking the time to send thorough feedback. 

Jason Morgan:

For supplying a superb sound sample for the tamper featured in the "Midnight ECS" run

Andy Slater [www.brdw.co.uk]:

For kindly allowing one of his sound samples to be used in the Cross-City South route.

Don Clarke [http://www.gotopcs.net]:

For assisting with the route's signalling, and helping to remove signal warning messages from displaying within BVE. 

Thanks also goes to my dedicated (and extensive!) team of Alpha and Beta testers, who have ensured that nothing less than the highest standards have been maintained during the building of the route. Please see my website [www.railsimroutes.co.uk] for a complete list of those involved with the Alpha and Beta testing process.

------------------------------------------------------------
For route information, instructions and acknowledgments,
please see the main route documention contained in 
"Readme - Cross-City South.htm", which can be found in
your "<Installation Path>\Railway\Object\Bham_X-City_South\"
folder.
------------------------------------------------------------

Anthony Bowden.
September, 2009.
