Using the tRR engine to capture AVI from DEM.
=============================================

As of version 1.09-trr27, as well as various stuff specific to the QdQ
machinima production 'the Rabbit Run', this modified Quake1 engine can
capture DEM as full audio and video AVI on Win32 systems. This may be
of general use to Quake1 machinima makers, hence this brief note on use.

If you want to integrate AVI capture into your own engine, there is
an easy-to-integrate patch available at
<http://www.machinima.com/qdqfilms/tools/capture_patch.zip>


__Setting up console variables__

 Use 'host_framerate' to set a frametime in seconds. Remember that
 id misnamed the variable - use 'host_framerate 0.1' to set a frame
 time of 0.1s and hence a framerate of 10fps.

 Variable '_snd_mixahead' should be set to something greater than
 host_framerate to allow the engine to generate the audio.

 Use 'capture_codec' to specify an AVI fourcc codec.
  E.g. 'capture_codec divx'.
  The default value of "0" indicates no compression.

 I also recommend leaving the flag 'sv_force_time_sync' set as '1',
  and using a framerate that evenly divides the audio 22050Hz. 15fps, set
  with 'host_framerate 0.0666666666667', always works well for me.


__Using console commands__

 'capture_start <filename>': begins capturing to the named file.

 'capture_stop': ends capture and writes the file.

 'capturedemo <demoname>': works like 'playdemo', but captures an
  appropriately named AVI from the demo, and exits on completion.
  Uses 15fps if user has not set their own fps via 'host_framerate'.
  Designed for batch use from the command-line, along the lines of
    glquake-trr27.exe -window -width W -height H +capture_codec CCCC
	 +host_framerate HFR +capturedemo DEMONAME


 --Anthony, 2002.11.27
   <mailto:anthony@planetquake.com>
   <http://the-rabbit-run.sourceforge.net/>
   <http://planetquake.com/qdq/>
