============================
==                        ==
==     rfVCRmerge 1.5     ==
==                        ==
============================


ABOUT
-----

rfVCRmerge is a stand-alone application that allows multiple laps to be overlaid, synchronised and saved into a new replay file.

There are two separate versions of the program.  One is for rFactor replay files, the other for Game Stock Car replay files.  The title bar of the main application window indicates the version.

Please not that this software comes with no warranties or guarantees!



DISTRIBUTION
------------

rfVCRmerge can be freely distributed.  However, any distribution must include the following files in an unmodified state:
	readme.txt, rfVCRmerge.exe, rfVCRmergeGSC.exe, changelog.txt

This has been developed in my spare time, so every time you use rfVCRmerge to improve your lap time please consider donating the price of a drink (whatever that may be in your part of the world) via paypal to 'alain@rfactorlive.co.uk'.



INSTALLATION
------------

CLIENT INSTALLATION:

1. Extract rfVCRmerge.exe and/or rfVCRmergeGSC.exe to a suitable location
2. Run rfVCRmerge.exe for rFactor replays and rfVCRmergeGSC.exe for Game Stock Car replay files.

If you get an error about the application not being installed correctly, download and install the Visual C++ 2010 runtimes.
They can be found by googling for "VC 2010 redist".  Select either the x86 or x64 version for 32-bit or 64-bit Windows respectively.



UNINSTALLATION
--------------

Delete rfVCRmerge.exe and rfVCRmergeGSC.exe.
That's it. No registry data or other files are created.



TIPS
----

The order of laps in the main window when you click the Generate button will be the order that the vehicles are cycled through using the '+/-' keys inside rFactor's Replay Fridge.



KNOWN ISSUES
------------

The first lap of race sessions does not synchronise correctly. I am currently working on a fix.

The app is untested with replays saved from versions of rFactor earlier than 1.255.



COMMAND LINE OPERATION
----------------------

New for version 1.2 is the ability to run rfVCRmerge directly from the command line without using the GUI.

The functionality is currently limited to extracting single lap(s) from a replay file.

The usage is as follows:
rfVCRmerge.exe -input <input filename> -output <output filename> [-driver "<driver name>"] [-fastest] [-lap <lap number>] [-log <log filename>]

-input: This is the name of the source VCR file
-output: This is the name of the VCR file to be generated (but see also below)
-driver: Optionally give the name of a single driver to select. The name should be put inside quotation marks.
-fastest: Switch to output the fastest lap
-lap: Optionally specify the number of the lap to output
-log: Option to specify a logfile to record any errors. This option defaults to "rfVcrMerge.log". The file is appended to. Successful operation will not add anything to the file.

Rules:
1) -input and -output are non-optional parameters.
2) One of the -fastest and -lap options MUST be specified, but NOT both.
3) If the -driver option is NOT given then ALL drivers who completed a lap will be output. In this case the driver name will be appended to the output filename.
   For example:
      rfVCRmerge.exe -input r.vcr -output hotlap.vcr -fastest
   Will generate the following files:
      hotlap_John Smith.vcr
      hotlap_Joe Bloggs.vcr
      hotlap_A N Other.vcr
   Where each driver's fastest lap found in r.vcr is extracted into their own individual replay files.



DISCLAIMER
----------
This software is supplied entirely as-is with no warranties with respect of any bugs or errors in the software or to its fitness for a particular purpose.
Please inform me of any bugs you may find and I will endevour to rectify them.



CONTACT
-------
Please let me know of any issue you may find by emailing me at:
	alain@rfactorlive.co.uk
	
For further documentation please visit www.rfactorlive.co.uk.



CREDITS
-------
Design and coding:
	Alain Cottignies (Lumpy)
	
Game Stock Car support:
	Patrick Giranthon
	Renato Simioni
	
Artwork:
	Martin Steinmetz

Beta testing:
	Many kind souls at rFactor Gentlemans Racing Club (http://rfgrc.co.uk)

Making rF the ideal online racing platform:
	ISI


(c) 2008-2012 Alain Cottignies. All Rights Reserved

