RW_Tools v7.0.00
---------------

This program is NOW Freeware,  it no longer requires  a license key, although donations
towards running my site are still welcomed.

Installation
------------
1.Unzip these files anywhere and run Install_RW_Tools.exe, (If using Windows 7/8.1/10 - run the
	Installer by right clicking on Install_RW_Tools.exe and selecting 'Run as administrator'
	this will install the full program and install any .ocx files which are required in your
	System32 (or Syswow64) folder.
	Once the installation is complete, Martin Wright's graphics utilities will be
	installed automatically.

2. A new copy of the Help file, RW_Tools_Help.pdf is included

3. As Train Simulator 2015/16 did not appear with the ability to view thumbnails
   in the world editor, separate downloads are available on  my site which includes 
   around 8200 thumbnails of rolling-stock and assets
   these will appear in various screens in RW_Tools when the item is selected.
   This download is optional because of the size of the download file which is
   around 25 - 30 mb. Many of the thumbnails are courtesy of Mike Hammett and Jim
   Nobbs with many thanks to both.

4. 					SERZ.EXE - TS2016 includes a new version of serz.exe which is a big improvement over the
					original. It will now allow you to use RW_Tools to open/save large .geopcdx files such
					as locomotive shapes etc, and it will allow you to open and resave very large .tgpcdx
					files including the 4096*4096 pixel ones - thus allowing users to use RW_Tools when
					reskinning these items. However, the new serz.exe also requires two new .dll files
					to be copied from the RailWorks folder, stlport_vc10.5.2.dll and zlibwapi.dll -
					RW_Tools will attempt to do this for you as well as copying the new serz.exe - however
					if you get any messages that serz.exe has not worked, you can copy these files manually.

5. A desktop icon for RW_Tools should appear on your desktop, otherwise click
	on the .exe to run it. THEN READ THE HELP FILE.......

6. Make sure you go to the Options menu and set up Paths to a picture viewer, graphics editor
	 Acrobat reader and of course for TS2016.

Note 1: 	You use this program entirely at your own risk. It is a powerful tool capable
				of making large changes to your RW setup. However backups are made of most
				files you change, so it should be safe to use by experienced users.


Note2. RW_Tools like all utility programs which make alterations to files in the Program
files folders under Vista or Windows 7/8/10 MUST be run with administrator permissions. (Right-click
on the RW_Tools.exe file and select Properties/Compatability and tick the box at the bottom
'Always run as administrator'.)

Note3. Many of the larger screens in this version are capable of being resized to fit any
monitor. To resize the windows, use the mouse to grab the bottom right corner of the window
and drag it down and towards the left.

Please advise of any changes required/bugs etc.

Updates can always be found on my site as under, after installing this full version, you only
need to download future Update/Patch versions and copy or drag the contents into the RW_Tools folder.
Do not uninstall RW_Tools to update it, the patches only contain a sub-set of the required files.


READ THE FILE - RW_Tools_Help.pdf

==========================================================================================================================================
NOTE:			It has been found that an 'Error 6 - Overflow' will occur if some screens are maximised on very
					large monitors. This is because some of the 3rd party controls I use were designed long before
					such monitors were built and it is outside of my control. I can only suggest that if you use
					monitor resolutions like 2560*1440 then you don't maximise the screen.
					
WARNING:	IF YOU ARE USING WINDOWS 10, YOU MAY FIND THAT YOU HAVE TO RUN RW_TOOLS BOTH AS ADMINISTRATOR AND
					IN WINDOWS 7 COMPATABILITY MODE TO AVOID GETTING SOME 'ERROR 75' MESSAGES. (This should not be
					necessary and I have never seen the need for it, but some users have described this problem).


============================================================================================================================================

History:- Latest version first.

v6.0.92 - Changed the File Date column in the 'Find all .ap files' routine to display as Year Month Day
					e.g. 20160615 - this means that when the sheet is sorted via the menu using the 'Date' option
					that the most recently downloaded .ap files appear at the top of the list, thus enabling users
					to ascertain what has been downloaded recently.
v6.0.91 - Fixed a bug in the Scenario Editor 'Swap' routines. All of these routines could possibly give
					an 'Error #5' response depending on what was being swapped. The swap was usually made but the
					error messages were off-putting to users. Hopefully this is all fixed now, sorry it took a while
					to find this one.
v6.0.90 - Altered the option to convert .TgPcDx to .dds so that it correctly indicates when the original
					.TgPcDx image was in DXT5 format rather than DXT3, thus allowing the re-skinner to save their
					modified image in .dds with the correct DXT5 format (thus saving the Alpha channel correctly)
v6.0.86 - Fixed bug in Scenario Editor where the option to change the driven locomotive using the 'Drive It'
					button caused an error 5 message to occur. 
v6.0.85 -	Discovered that some rolling-stock names which included the character " ' " was appearing in the
					.xml file as &apos; and in some as &quot; - that is apostrophe or quote. This meant that RW_Tools
					sometimes could not find some wagons when swapping items, especially in the JT Western Mainline
					route. Hopefully it works correctly now.
v6.0.84 - Added a number of new messages to advise user of incorrect/missing input.
					Added improved error handling in Scenario Editor.
v6.0.83 - Added new menu option to the AP files manager - 'Extract Files/Extract Selected to same folder as .ap'
v6.0.81 - Fixed the Edit Assets screen to work correctly in non-English language versions of the program because
					Assets did not appear in the Asset list if they did not have a 'Name' entry in the selected language of the
					description of the item. 
v6.0.80 - Fixed 'Show location of all assets' to show the 'Waiting' icon after closing the 'Missing Items' screen
					to indicate that the program was still working and calculating the position of all items.
					IMPORTANT UPDATE - In the option 'Find all .ap files' - I discovered that this would fail if over
					a certain number of .ap files existed. This is now fixed so this update is necessary for anyone
					with a large number of downloads.
					Added option in the 'Find all .ap files' screen - 'Extract rolling-stock .bin files from selected
					.ap files' - This allows users to view the available rolling stock and edit scenarios without
					having to extract the complete Assets folders. Ensure you make sure you copy the Templates folder
					from this zip into your RW_Tools folder.
v6.0.78 - IMPORTANT UPDATE - It has been shown that if you use RW_Tools Edit Assets/Find Zero Byte files
					to remove empty files from your system, that the program will also remove files which are over
					2 gigabytes in size - So far only 3 '.ap' files of this size have been seen 'ExeterKingswearAssets.ap'
					Michael Whiteley's EEType3BAssets.ap and a U.S. BNSF file. This version of RW_Tools ignores .ap files
					in its checking of file sizes.
v6.0.74 - Cleaned up the 'Edit Providers' screen and fixed problem with unusual characters in route names.
					Various batch files in the Templates folder beginning 'APBatch' have been updated to work with
					.ap files with spaces in the folder/file names.
v6.0.73 - Fixed bug in Edit selected scenario in which Error #9 would appear in the case of very large scenarios
					with over 500 rolling stock items involved.
v6.0.72 - Fixed a bug when replacing missing items in a route the procedure was case sensitive, so sometimes
					it had to be run twice to ensure all items were replaced. (This would only have happened if the 
					names of Assets folders had been manually altered by the user).
					Fixed a bug in 'Check Route' where after checking one route the 'Check Route' button was greyed
					out under some circumstances and thus the user had to exit/rerun the option before a second route
					could be checked.
v6.0.70 - Fixed bug in the Scenario Editor whereby the option to 'Delete Selected Scenario(s)' only
					deleted the first one selected. It now works correctly.
v6.0.69 - Fixed bug in the option to substitute scenery items for missing items.
					Fixed bug in the option under Check Routes/List Items used by scenarios/Check selected stock for 
					missing files - This reported files missing if they contained non-alphanumeric characters such as
					'&' or some European language letters.
					
					A new pack of Thumbnails named Thumbnails7.zip is on my site now which covers most railcars by
					GreatNorthern - just copy all the .jpg files in this archive into your RW_Tools\Thumbnails folder.
					Thanks once again to Ron Smith for all his work producing these pictures.
					
v6.0.67 - Added new option to the Scenario Editor screen 'Make Selected Career Scenarios Standard'
					so you just need to select all the RED scenarios in a route and click this button to make them all 'Standard' if
					that is how you like to play the game. It is probably best to do this on a cloned version of the route.
					Adding this option means that the 'Saved Copies of Selected Scenario' box is no longer filled automatically
					when you select a scenario, a new button has been added to populate this box if required.
v6.0.64 - While looking at the code in the 'Swap rolling stock' area in RW_Tools I discovered that when a 
					loco is swapped with one in a RSC or DTG scenario, they have stopped using the earlier 
					<RBlueprintSetPreload option and now use a new <RequiredSet option which just points to the 
					assets package for the route. So when adding new locos to a route with RW_Tools it no longer ticks 
					the green boxes for Provider/Product in the Scenario automatically. I have changed the code to fix 
					this and add the ticks as before.
v6.0.60 - Fixed problem in the 'Work Order' screen which would fail if the words 'Free Roam' appeared in
					the ScenarioProperties.xml file, even if it was not a Free Roam scenario. Changed all references
					from TS2015 to TS2016 - You must copy over the new language files for this to work.
v6.0.59 - Changed the report page on 'List Stock used by all scenarios' so that the option 'Check selected
					stock for missing files' only lists stock where files are actually missing, rather than listing
					every stock item as being 'Checked' when there is nothing wrong with it. A number of other small
					bugs have been fixed.
v6.0.56 - Fixed a bug in the Route Building Tools/Clone Route which could fail if the original route name
					was much longer than the new name. Also please note that this option can't clone routes where
					the route name starts with a 'space' character.
v6.0.54 - In the Edit Assets screen, editing the sounds now deletes the Blueprints.pak file after changes
					are made. Also warns you to check that Kuju is ticked as some sound changes can add Kuju as
					Provider/Product to some locos.
v6.0.53 - New French language file from Vincent Meeur - received with many thanks.
					Fixed a bug in the Scenario Editor which would claim file path's including apostrophes were
					invalid if you scrolled through the consist list using the up/down keys.
v6.0.52 - Changed the options to list rolling stock in selected scenarios and in all scenarios to indicate
					either the scenario name or the route name in printed output.
					Fixed the consist list in the Scenario Editor which was not always displaying full lines of text.
					Fixed bug in Scenario Editor whereby if you selected a loco from the 'Index File', it was placed
					in the scenario with a .bin suffix instead of .xml, causing the Scenario to fail.
v6.0.49 - Added an option to the Consist Builder - Files/Select Index File - this allows users to set up
					a short index file of stock used in their route, rather than setting up a giant index of all
					installed stock. Just select the stock in the Edit Assets screen and save to a .csv file with
					an appropriate name.
v6.0.48 - Fixed bug in the QD Consist builder whereby the first item in the bottom list did not appear
					in the top window when double-clicked, making it impossible to select for use.
v6.0.46 - When editing consists, the option to 'Delete Consist' will only delete one consist correctly, you are
					now advised that you have already deleted one consist, and must save the scenario before editing it
					again to delete a second consist. Sorry but to get around this, a considerable rewrite of the whole
					option would be necessary and could possibly cause more bugs.
					In the various list screens, such as lists of missing assets/rolling-stock etc, it is now possible
					to right click on any item in the first column to send it to the clipboard. Useful if you wish to do
					a search for a missing loco on Google etc. Only one item can be saved to the clipboard at a time
					as each one will overwrite the previous one.
v6.0.45 - It has been pointed out to me that when running the 'Check Route' option, if a list of missing items
					appears, the user must click the 'Remove Duplicates' button before items can be substituted or removed
					otherwise they receive an error message. I have changed the program so that if 'Remove Duplicates' has
					not been pressed, a message appears telling you that you must do so.
v6.0.44 - RW_Tools has always defaulted to 'Don't change numbers when swapping stock', however this does not
					suit everyone, so I have added an option to the Options menu which allows users to select either
					'Don't change numbers when swapping stock' or 'Change numbers when swapping stock' as their Default
					setting. When you first install the program it will be set to 'Don't change numbers when swapping stock'
					and if you are happy with that setting, do nothing. If you change it, then it will default to your new
					setting. You can still change it on a case by case basis as required.
v6.0.41 - Fixed following bugs:-
					Check QD Consists - Was looking for 'PreLoad' and did not find 'Preload' :-(
					Consist Editor - Listed files missing if there were '&' or accented letters in the filename.
					Some improvements to the option to list all QD Consists and new QDConsistEditor.pdf file included.
v6.0.40 - The above QD Consist Editor could not handle consists without a Valid Routes entry and which
					used the empty tag <ValidBuildAndDriveRoutes/> - This has been fixed.
					A new option has been added to the Check QD Consists and Fragments screen - 'List All QD Consists'
					just click this button to see a complete list of all your QD Consists in a spreadsheet like format
					with full details of every consist. It can be sorted on any column by clicking the column header.
					This list can be saved in either .xls or .csv format for import into Excel or other similar spreadsheets.
v6.0.38 - Fixed a bug in the above QD Consist Editor whereby an error message appeared whether you had set
					Consist is Drivable to eTrue or eFalse.
					A bug in the Scenarios/Build QD Consists or Fragments option has been fixed.
v6.0.37 - Quite a lot of changes this time:-
					1. Changed the option to Fix Provider/Product folders so that it displays a list of sub-folders which
					are not in the user's Assets folder, rather than showing a separate message for each missing folder.
					2. It has been pointed out that the various options which display thumbnails of locos default to
					the thumbnail in 'LocoInformation\image.png' if it exists, and if not looks in the RW_Tools\Thumbnails
					folder. This is normally OK, however a number of loco authors have placed several loco models in a
					single 'Engine' folder and in this case there is only one 'image.png' file to cover them all. I have
					therefore reversed this process so that RW_Tools looks initially in the Thumbnails folder for a suitable
					picture before reverting to image.png. Ron Smith in Canada is working on producing some more loco
					thumbnails.
					3. Fixes have been made to the option to save the size of the editor form which was often being
					maximised when a .bin file was viewed.
					4. Changes have been made to the option to Check QD Consists and Fragments which now allows users to
					edit existing QD Consists (e.g. to add additional routes which AI consists can run on etc) - See the
					enclosed 'QDConsistEditor.pdf' file.
v6.0.34 - Fixed bug in Route Building Tools/Duplicate Selected Scenario(s), this option would only delete
					a single scenario despite how many you selected. Now fixed it to delete all selected scenarios.
v6.0.33 - Fixed another bug in the Scenario Editor which gave invalid error messages in some cases.
v6.0.32 - Fixed a bug in the Scenario Editor which closed incorrectly if you closed the window by clicking
					the window close button 'x' in the top right of the screen.
v6.0.30 - I have recoded the option Edit Assets/Clone Scenery for Re-Skinning - I have also rewritten the
					tutorial on my site for Re-Skinning Scenery objects. There were bugs in the original code and the
					tutorial was no longer valid.
					On the Edit Scenarios screen, the box where you select assets in the bottom right hand corner now
					defaults to Railworks\Assets rather than Railworks\Assets\Kuju as the bulk of rolling-stock is no
					longer in the Kuju folder.
v6.0.28 - Added a couple of new options:-
					a. A new option on the 'Check Routes and Scenarios' screen - "List Routes with Scenario Types'
					which produces a list as under giving the route name and the number of QD, Career, Standard and
					Free Roam scenarios for each route.
					Bristol to Exeter                                    2		   0		   8		   2
					Cajon Pass                                           2		  10		  38		  14
					Canadian Mountain Passes                             2		   9		   1		   5
					etc.
					b. The reason it took so long to build an Index.csv list of rolling stock was that a few
					rolling-stock builders did NOT use the file format as originally suggested when RailSimulator
					came out. i.e. that ALL rolling stock items should be in a folder named 'RailVehicles'.

					As a few builders did not use this name, and Continental builders used foreign folder names,
					I had to program RW_Tools to search EVERY folder for stock rather than just those folders with
					the name 'RailVehicles' somewhere in the folder name. I have now added a new tick box which
					appears when you select 'Rolling Stock Only' named 'Default folders' - if you select this box,
					then RW_Tools will only search for rolling stock in the standard named folders. In my case, it
					found 7510 items without this box ticked and 7494 with it ticked, but completed in 25 mins rather
					than many hours for only 16 items to be missed. So if you can put up with a few items being missed,
					this is much faster.
v6.0.27 - Fixed a couple of cosmetic items - Buttons on the 'Find all .ap files' should no longer overlap
					but this does depend upon your screen resolution.
					Added headings to the Report screen for the above options to check QD Consists/Fragments indicating
					that this report lists all Consists/Fragments with some sort of error in them, this might just
					be a missing loco, a bad bit of editing, or a missing path line. It is up to the user to see
					what the problem is and to ascertain if it is worth their while fixing it.
v6.0.25 - Fixed bug in the Scenario Editor whereby if the weather used by the route was in an .ap file
					and unreadable, it was not possible to carry out edits to the scenario. Now the weather box
					will appear as empty, but when the scenario is saved the original weather setting is retained.
					Added a completely new option under Check Routes and Scenarios, there is now a new option to
					Check QD consists and fragments. This was brought about after someone on uktrainsim noticed
					that some QD scenarios were failing due to invalid consists. On checking it turned out the
					QD consists included 3rd party locomotives he did not have. The new option brings up a screen
					with buttons to Check QD Consists and one to Check QD Fragments. Running the first one will
					bring up a list of QD Consists you have, and after it runs a report of all missing rolling stock
					and QD Fragments is shown. (Note QD fragments are sets of stock, like rakes of carriages which
					can be combined with a loco to form a full QD Consist - many QD Consists do not list any
					rolling stock at all, just a number of fragments). Similarly, running the Check QD Fragments
					will bring up a list of fragments you have then a report of missing rolling stock used by
					them. You can save the list in various formats including as an Excel file.
v6.0.24 - Added new button to the list of assets used by a route when running 'Check Route' - new button
					is 'Remove selected Loft items' - this is needed on some routes if you are removing overhead
					wires produced using the Gantry Tool.
v6.0.23 - Updated the above option to advise you of the current Start Trigger Distance before you change
					it to your new distance.
v6.0.22 - New feature in the Scenario Editor - 'Trigger distance of selected AI from Player consist in m.'
					This takes advantage of a new option in TS2015 which allows scenario builders to start an AI
					consist moving once the Player train is within a given distance of it, rather than starting it
					at a specified time. A distance of around 1000m is probably about right. Note that this option
					only works on Scenarios which have been written using TS2015 or have been updated to TS2015
					standard. You will be advised if this happens.
v6.0.21 - Fixed a bug in the option 'Edit Providers/Update Providers' which failed if there was an
					entry in the RouteProperties.xml which was empty, i.e. both Provider and Product were empty.
					Changed the 'Remove Duplicates' option in the various 'List' forms to once again display
					the type of file in the 2nd column, e.g. Scenery item, Loft item etc which is needed for some
					options such as swapping one item for another.
v6.0.20 - Fixed the QD Consist builder screen to automatically set column widths, making it easier to
					use this option - See new tutorial on building QD consists at
					http://www.rstools.info/tutorials/RW_QD_Setup.pdf
v6.0.19 - Fixed the Abort button on Check Route to allow you to check another route after aborting the
					first check.
v6.0.18 - Fixed a bug in Check Route whereby if you had a route without a 'Route Template', you could
					no longer check it at all.
v6.0.17 - Fixed the above indication for newer version.
					Fixed a bug in the option to display a work order - did not work for some Workshop scenarios.
v6.0.16 - Changed the position of the default 'Unpack selected files with 7zip' on the Find all .ap files
					screen to the first button in line, and changed the print to bold so that new users would not be
					confused as to which button to use.
					I have recoded the 'Remove Duplicates' button which appears on several list pages to operate
					much faster than in previous versions.
					If a 'Check Route' is cancelled, the button now becomes available for use again without having
					to exit the screen.
					An indication that a newer version is available on my site now appears when the program is
					started (However, you may disable this option from the Options menu).
					(Thanks to Ian Trackman for suggesting some of the above improvements.) 
v6.0.15 - Restored the 'Add Route Thumbnail' button, but only for those who have modified TS2015 to run
					with the original TS2014 menus. This does nothing for a standard version of TS2015.
					Fixed a bug in the 'Check routes and scenarios' screen whereby if you checked a route for
					missing items, then immediately started to check scenarios for used items, you could get an
					error message.
v6.0.12 - Changed the 'Check routes and scenarios' screen:-
					1. Removed the 'Add Route Thumbnail' button as the location of route thumbnails which show up in the
					TS2015 menu has now changed as described in the paragraph above re v6.0.10
					2. Added new button 'Check Route Template' - To explain this, the sorting of routes in the Drive
					menu where you can select items like 'Europe', 'Heritage' etc is picked up from the route's template
					file which in turn is pointed to by the RouteProperties.xml file. This new option allows you to
					select a route and check if the Route Template includes a <BrowseFilter> key and if not allows you
					to add one and select the location of the route and its period. There are also options to select
					if the route is in the Countryside, Mountains etc, however TS2015 does not appear at this time to
					use these settings.
					3. The above 'Check Route Template' button also checks if there is a 'RouteInformation' folder in
					your Routes\HexNumber folder and it now allows you to add an empty folder. This is useful for
					saving an image.png thumbnail for the route if you need to.
v6.0.11 - In the Check routes and scenarios screen, the item 'List items used by selected scenario' has been
					changed to 'Scenarios' and you can now select multiple scenarios (by Ctrl-Left click) and each list
					will be presented in turn.
v6.0.10 - Fortunately this year I was given access to an early copy of TS2015 thanks to DTG, and have found
					that virtually all of the functions in RW_Tools v5 work fine in TS2015.

					I have however been cleaning up the program somewhat, removing several menu items which were no
					longer required, or for which there were better alternatives, to this end the following are
					no longer in the menu:-
					Files/Backup TS2014
					Files/Incremental Backup
					Route Building Tools/Blueprints/Route Template
					Route Building Tools/Markers/Set DCSV Precision
					Route Building Tools/Set up sub folders (now incorporated in a single 'Set up Developer folders' option
					Other changes:-
					Assets Editor - the Physics Editor screens have been reintroduced by request of a user.
					Graphics Tools/TgPcDx-DDS Viewer has been enhanced to allow users to view .jpg and .png files as well
					as .TgPcDx and .dds files, and also to allow these files to be saved as .png files. This is useful as
					it allows .tgpcdx files in a route's PreLoad folder to be converted/renamed image.png and placed in
					the Content\Routes\HexName\RouteInformation folder and thus viewed in TS2015 in cases where the route
					icons only show as a blank containing a circle with diagonal cross line in them.
					Route Building Tools/Direct Route Setup now includes boxes to check for Route Location/Era/Terrain as
					well as the previous boxes for Weather etc, this was necessitated by changes to the Route Template files
					in TS2015.



Mike Simpson
Email: rwtools@optusnet.com.au
http://www.rstools.info
15 Jul 2016
