This upgrade patch will only work with Route_Riter v6.4.76
or later which will be upgraded to v7.0.80

Note: You will also need to download the files
	which are available from my site in the 'EXTRA FILES PACK'
	along with a new Route_Riter Help file.

INSTALLATION
------------
1. Unzip this archive into a temporary folder and READ this file.

2. Copy the files in this package and in the Extra files pack
	into your existing Route_Riter folder, overwriting
	any existing files with the same name.

3. Run the KillTokens.bat file to remove the Tokens from your
	registry which were required by previous versions of Route-Riter
	(Not necessary if you have already done this when installing
	the Vista version).


CHANGES
-------
This version of Route_Riter uses Carl-Heinz Rave's TsUtils Java
functions to compress/uncompress .s/.t and .w files wherever this
is necessary in the program. This change has been necessitated by
previous compress/uncompress utilities not working under Vista, and
it was becoming very difficult to maintain two sets of code for the
two different operating systems. This version is an attempt to make
a single version of RR which will run on both OS.

Because of these changes, there is no longer any requirement for
Microsoft .Net Framework to be installed for RR to run, only a recent
version of Java is necessary.
----------------------------

I have taken this opportunity to move several options around within
the program to place them in more logical settings. e.g. The make AI
and Unpowered Locos are now on the Activities/Stock tab.

The main improvement in this version is the inclusion of a full
set of TsUtils v3.3.06 along with a Windows interface which allows
users full access to ALL of the TsUtils options and all of the settings
for each option. A new Help file is available which outlines these new
settings.

Changes in v7.0.17
------------------
Several bugs were found in the original v7 Beta, thanks to all who
responded. The following fixes have been made:-
1. RR checks for the Route_Riter\TempFiles folder on startup and if missing
	 makes a new folder.
2. Extra debugging code has been included on startup to improve the Startup.log
	 file which is placed in the Reports folder each time the program is run.
3. The following fixes all refer to the Manual TsUtils options:-
	a. Global 'Suppress messages' now allows for up to 10 entries, all multi
		 input items are now separated with spaces rather than commas, e.g.
		 'getTDF82 getTDF83 getTDF84' would suppress all entries with these msg numbers.
		 (The message numbers can be found in the file TsUtil\TSErrMsg.properties)
	b. Multi options can now be included with 'ichk' and 'cvrt' where Hidewire is used.
	c. The list of available routes now suppresses those hidden by programs such as
		 TrainStore, RoutesOnOff and Route-Riter itself.

v7.0.18
Fixed a couple of small bugs.
1. Added new button on List of Filtered Files screen which allows you to change the
	value of ESD_Alternative_Texture on all selected .sd files.
2. To use this, proceed as follows:-
a. Run RR and navigate to the Shapes folder of the route you wish to modify
b. Double-Click on Shapes to get a list of the contents of the folder, then
	 enter *.sd in the filter box above the file list, this will limit the box to .sd
	 files
c. Click the List Filtered files button. This brings up a list of all filtered files
d. Highlight all those you wish to change and click the Change ESD val in all
	 selected .sd files button.
e. Enter the ESD value you wish to use and click OK
Thats it, all the .sd files will now bear the value you required.

v7.0.20
Fixed a few more bugs.
Check Route and Compact Route now recognise track objects which are aliased to
shapes in the Route's Shapes folder and handle them correctly. (Especially useful
for Dynatrax users)
Check Selected Activity now works on multiple selected activities.

v7.0.21
There was a serious error in v7.0.20 whereby when compacting a route, no Terrtex
tiles were found, therefore the program deleted or moved them all. Luckily this
was quickly reported.

v7.0.22
Fixed a bug in the Check Rolling-Stock option where textures for FreightAnim items
were erroneously reported as missing.

v7.0.23
It has been found that if the Compact Route option is run, and Java is not properly
installed on the users PC, then files could be accidentally deleted. To overcome
this, I have changed the Startup routines in Route_Riter so that if Java is not
working then Route_Riter will not run at all. Furthermore, I have removed the DELETE
option for removing unrequired files in the Compact option, now all files are moved
to the RRBackups folder within the Route, and it is up to the user to delete this
folder once they know that everything has worked OK.

v7.0.25
Compress .s/.w/.t was compressing file in situ rather than sending compressed version
to the Target window.
Route_Riter would lock up if Shapes in a .w file was enclosed in double sets of quotation
marks, e.g. FileName ( ""myshape.s"" )
Compact Route removed Snow textures for Transfers to the RRBackups folder.

v7.0.27
Fixed a bug where Check Route failed if there were over 500 transfers used in the route.
Added a new option to the .Ref File Editor where it checks the Shapes folder and adds
any shapes which do not have .ref file entries to the Route's .ref file.

v7.0.31
Includes new button in the Engine/Wagon File Editor - 'Remove certain files from list'
This button allows you to input a string of characters which if found in filenames will
cause such filenames to be removed from the list, e.g. entering Brake will cause all Brakevans
to be removed from the list etc. This option may be used multiple times, so if you have
sensible rolling stock names, you should be able to remove those you do not wish to modify.

Also fixes a couple of bugs mainly in checking routes where the Hidewire program has been
used.

v7.0.34
The following new items have been added following suggestions received from train-sim.com and
uktrainsim.com last week:-
1. Run Check Activities then Check Consists and you can right click on any .eng/.wag to change it - A new checkbox has been added to the Substitute Rolling Stock screen which allows users to substitute a new .eng or .wag file in ALL Consist and Activity files.
2. A new button allowing you to just check the Activities in a selected route has been added.
3. In the REF file editor, the 'Add Unreferenced Shapes' function had a bug in the description line, this is fixed
4. An option button has been added to the Check Rolling Stock page which allows you to select Locomotive .sms files and do a bulk change from 'couple_auto' to 'couple_chain' - Ian pointed out that many UK Steam/Electric/Diesel locos have chain couplings but the sound files mainly use Automatic coupling sounds, this changes it to Chain.
5. It has been pointed out that I was using the incorrect parameters for MSTS mapping in the option to convert Google .kml files to MSTS .mkr files - This has been corrected.

v7.0.36
It has been pointed out that in v7 of RR the option to set up Common Files no longer works. To
fix this, I have had to make a small change to the program and also include a new batch file EZstuff3.bat
which should be placed in the StuffitPack folder.

v7.0.37
Thanks to Otto who has pointed out that since using TsUtils to compress/uncompress files in Route_Riter
hundreds of temporary files with the format TsUtilxxxx.tmp have appeared in the System's temporary folder.
This version of Route_Riter cleans out all those temporary files each time it is shut down. If you have
been using Route_Riter v7 for some time, this may take some time to work the first time you use it, I had
over 15,000 .tmp files on my system :-(
It has also been noticed that if you use the Move, Adjust and a few other options in TsUtils that RR
removed empty Traffic/Paths/Services/Activities folders. These are now checked and replaced even if empty.
A new version of TsUtils is included in the 'Extra Files' package today.

v7.0.38
Check Route and Merge now add missing folders such as Traffic and Lo_Tiles as these empty folders
are needed by some utilities.

v7.0.42
Fixed bug in the REF file Editor and a bug in the option to change the Error Bias
of a route.

v7.0.48
A large rewrite of the Check Consists option which fixes the ability to replace missing
items in all consists.
Fixed 'Compact Route' when there are .s files which are not compressed in the normal
'compressed binary' format. Because RR could not read these files, it did not notice that
they pointed to .ace files and thus the .ace files were removed during a 'Compact Route'
operation. Thanks to OldieDaddy for feedback and testing of this option.

v7.0.59
Changed the 'Quick Consist Check' and the 'Consist Check' so that if an Engine or Wagon
is not in the folder pointed to by the .con file, but is available in another folder you
then get the choice to automatically change the .con file to point to the correct folder.
Added a Search box for rolling stock on the Rolling Stock grid.
Have added two buttons to the MSTS File Utils screen which allow you to
1. Search for 'stuck' points(switches) in a route.
2. The second button only available in the licenced version will fix the .w files for you
   (otherwise you can do it by hand following Otto's instructions on train-sim.com).

v7.0.62
The Stuck Points options have been altered to cover more types of points/switches.
Program also ignores Shapes with PNT in the filename but which are not points.

v7.0.65
1. Under Check Route, if there is no .trk file, but there is a .off file, then it
renames the routename.off file to routename.trk so that it can continue to check
the route.

2. Added the ability to convert .gpx files produced by Google Maps to MSTS marker
files. I have changed the button 'Convert Google .kml files to MSTS .mkr' to
'Convert Google .kml or .gpx files to .mkr'. The .gpx files have no placenames so RR
will add places of Mark1, Mark2 etc to enable the user to jump to whichever one he
chooses.

See David Coverdale's new tutorial at
http://steam4me.railpage.org.au/trainsim/tutorials/mkr_googlemaps.html
for examples of how to use this for route building.

v7.0.66
Added button under TsUtils tab to 'Remove .t tile where no .w tile exists' this
is as it says. All of the Tiles folder is copied to the Routename\RRbackups\Tiles
folder, so nothing is lost. All .t tiles (and their _*.raw equivalents) are
removed from the Tiles folder, reducing the route size. Do not use where there are
large empty spaces, e.g. seascapes or deserts, in your route.
Note: This is not a TsUtils function, but is associated with the TsUtils 'Filter'
function which is used to remove unused tiles from the Route's Geometry.

v7.0.68
The option to convert Google Earth and Maps files to MSTS .mkr files was not
placing a blank line after the header, resulting in the first marker not appearing
in the Route Editor, this is now fixed.

v7.0.69
Fixed a bug in the Uncompress .s/.t/.w option. Also fixed the program so that
it correctly uncompresses files with umlauts in the filename.

v7.0.73
Fixed the Error 76 when exiting Route_Riter (on some systems).
Added new option on the 'List of Filtered Files' screen 'Fix AI wheel radius
for MSTSbin' - Historically, AI locos required an adjustment to the wheel
radius to make them turn at the correct speed in MSTS, now that many users
have MSTSbin, this adjustment is no longer required. This option causes your
AI locos to revert to the same WheelRadius settings in the .eng file as the
player loco has.
To use this option, select your TrainSim folder (right click on the CON button
top left of the main screen), and enter #*.eng in the filters box (assuming you
have used RR to produce your AI locos), you may also enter AI*.eng, AI_*.eng
or AI-*.eng to cover other AI locos. Then press the 'List Filtered Files' button.
This will eventually bring up the List of Filtered Files with a list of all your
AI locos, select those you wish to convert and click the FIX AI ... button, bottom
left and they will all revert to the same settings as the equivalent normal Loco.

v7.0.75
Fixed an error in 'Write.bat' whereby mutilple instances of Terrtex files could
appear in the InstallMe.bat file.
Fixed an error whereby Route_Riter did not appear on screen at startup if it was
closed from the Toolbar while minimized.
Changed the UHARC button so that it was disabled if Uharc.exe was not in the Route_
Riter folder (necessitated by AVG wrongly reporting this file as virus infected
and removing it).

v7.0.78
Fixed an Error 9 bug if you ran 'Check all Activities' then ran 'Check
Rolling Stock' one after the other.

v7.0.80
Inclues new file SetupFiles\Points.txt make sure this ends up in your folder
Route_Riter\SetupFiles\ - This is used with the Fix Stuck Points option in the
Licenced version of Route_Riter, and lists the track sections which are searched
for points with missing JNode entries. Users may edit this file to add extra bad
track types, you must increment the number on the first line to indicate the total
number of track types.

Fixed a bug in a Move/Delete area whereby if you selected Move, you were told the
files were Deleted. (they were in fact Moved, but it could cause users to worry)...

Many thanks to those who have sent comments, and especially to:-
Carl-Heinz Rave for testing of the TsUtils interface and for his permission to use
his code within Route_Riter.
Yuri Sos for hosting Route_Riter on the steam4me site
Derek Morton for intensive testing of a 'hard to find' bug in RR.



Mike Simpson - 15th Oct 2007
virtualtrains@optushome.com.au
http://members.optusnet.com.au/virtualtrains

