LavaCam Dynamic Camera Allocation (DCA) Instructions
----------------------------------------------------

Contents
--------
   What is DCA?
   How to use DCA
   Commands
      editcam
      storecam
      updatecam
      deletecam
      listcam
      namecam


What is DCA?
------------

Dynamic Camera Allocation allows camera positions to be defined
anywhere in any map, with the aid of the cam console commands.

DCA files are stored within the DCA directory in the LavaCam directory.
When a Quake2 map begins LavaCam looks for a corresponding .DCA file,
if found it is loaded and the camera definitions are used to Track the
Action!

With DCA, *any* map can have up to 32 camera positions without
modifying the map.

.DCA files are just text files and can be viewed and edited. Although
editing the positional information (x, z, y, pitch, yaw and roll)
could move the camera into an undesirable position, or even outside
the map!

                       ----===============----

An example of how to use DCA
----------------------------

1. Start Quake2 with the following command line switch 
	+set game lavacam +set cheats 1 +menu_main
   (Cheats needs to be on to allow NOCLIP to be turned on)

2. Make sure the player name is *NOT* LavaCam
   (Cameras can't be defined while in LavaCam mode)

3. Start a network server and load the map you wish to work on.

4. Bring the console down and type exec dca.cfg.
   This will execute the DCA config file. This binds the DCA commands
   to convenient keys and binds NOCLIP to the n key.
     (You can edit the dca.cfg to change or add any keys as required)

5. Press the key bound to NOCLIP, normally n, to turn on NOCLIP mode.
   With NOCLIP on you'll be able to fly anywhere in the map,
   which is essential to choose the camera positions.

6. Press the key bound to 'editcam', normally e, to activate
   the DCA Editmode, your current position info will be displayed
   on screen.

7. Fly around the map and choose the view you want to store as a
   camera position. Press the key bound to 'storecam', normally s,
   to store the camera information and move onto the next camera.

8. At anytime the console command 'namecam' can be used to name the
   current camera.
  (Note : The maximum length for a camera name is 31 characters)

9. After storing a few camera definitions press the key bound to
  'listcam', normally l, to turn on the list mode. Use the next and
   previous keys, normally [ and ], to step through the lists if more
   than 10 cameras have been defined. Press the 'listcam' key again
   to return to normal edit mode.

10.At anytime use the next and previous keys, normally [ and ], to
   step through the cameras. Camera postions can then be altered and
   saved using 'updatecam' or deleted using 'deletecam'.

11.When editing is complete, press the key bound to 'editcam',
   normally e, to de-activate the DCA Editmode and return to the
   normal game.
 
                       ----===============----
 
DCA Commands
------------

editcam   -  default key bind e
-------------------------------
toggles the edit mode


storecam  -  default key bind s
-------------------------------
Saves camera data and creates a new camera position.


updatecam -  default key bind u
-------------------------------
updates the current position data to the current camera in the DCA
file.


deletecam -  default key bind d
-------------------------------
deletes the current camera from the DCA file.


listcam   -  default key bind l
-------------------------------
toggles list mode. The camera details are listed in 10's on screen.
Use the next/previous keys, normally [ and ], to navigate between
the lists if more than 10 cameras have been defined.


namecam   -  a console command only
-----------------------------------
while editing a camera, bring up the console and type

	namecam <camname>

then return to Quake2, and the current camera details will show the
new camera name.

                       ----===============----
