============================
==                        ==
==     rfVCRmerge 1.3     ==
==                        ==
============================


ABOUT
-----

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

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, 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 to a suitable location
2. Run rfVCRmerge.exe

If you get an error about the application not being installed correctly, download and install the Visual C++ 2008 runtimes.
They can be found by googling for "VC 2008 redist".



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

Delete rfVCRmerge.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)
	
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-2010 Alain Cottignies. All Rights Reserved

