Corbin: finally added CAMERA-MAN basics

2018-06-04T18:13:21Z

finally added CAMERA-MAN basics

New page

== Introduction ==
'''Camera-Man''' governs setup and handling of in-engine cameras. With Camera-Man, you can create dynamic, trigger-able (via [[Radius Trigger Script]] or [[COAL]]) cameras, using a simple-to-understand console commands.

== Loading ==
In EDGE, cameras are recorded and stored as ''.CAMDAT'' files. The current directory the Camera-Man scripts are saved to is '''../doom_ddf/cameras/MAPNAME''', where ''MAPNAME'' is either a Map in ExMx, MAPxx, or any format tied to [[GlBSP|edgeBSP]] (using the GL_ prefixes for a custom map).

<nowiki><code>'''</nowiki>You can control the default directory to save CAMDAT files to, using the console command ''camera_subdir<nowiki></code></nowiki>.''

== Basics ==

=== 2.1 Console Commands ===
Basic setup of the camera-man system is done via set of console commands, listed below:<blockquote>- 'actcam' - activates (turns on) the system, by default it is inactive; the command requires a single parameter to indicated whether to turn on or off the system (1 or 0),</blockquote><blockquote>- 'rstcam' - resets the system to its default state (erases all stored cameras and turns it off),</blockquote><blockquote>- 'addcam' - adds a new camera in player's current location and orientation; it requires two parameters - field-of-view angle, in degrees and a name for the camera (which is optional),</blockquote><blockquote>- 'remcam' - removes a camera of given idetifier (provided by 'addcam') or name; removal by name requires the first parameter to be set to -1,</blockquote><blockquote>- 'swtcam' - switches the view to the camera given by an identifier or a name; switching by name requires the first parameter to be set to -1,</blockquote><blockquote>- 'strcam' - sets the camera of given identifier or name as the first one (start) to interpolate between; setting the camera by name requires the first parameter to be set to -1,</blockquote><blockquote>- 'endcam' - sets the camera of given identifier or name as the second one (end) to interpolate between; setting the camera by name requires the first parameter to be set to -1,</blockquote><blockquote>- 'poscam' - sets position of the camera of given identifier or name to be players current position; setting the camera by name requires the first parameter to be set to -1,</blockquote><blockquote>- 'angcam' - sets angles of the camera of given identifier or name to be players current angles (vertical and horizontal); setting the camera by name requires the first parameter to be set to -1,</blockquote><blockquote>- 'fovcam' - sets field-of-view angle (in degrees) of the camera of given identifier or name to be of the given value; setting the camera by name requires the first parameter to be set to -1,</blockquote><blockquote>- 'savcam' - saves current state of the system to a file located in a sub-directory specified in 'camera_subdir' global variable (by default set to 'doom_ddf/cameras'); saved file name is the same as the name of the currently open map,</blockquote><blockquote>- 'lddcam' - loads the state of the system from a file located in a sub-directory specified in 'camera_subdir' global variable (by default set to 'doom_ddf/cameras'); loaded file name is the same as the name of the currently open map,</blockquote><blockquote>- 'prtcam' - prints debugging information about current state of the system (i.e. lists all cameras avaiable),</blockquote><blockquote>- 'tghelp' - toggles rendering of helper gizmos in the engine (e.g. gizmos showing where cameras were set up).</blockquote>

=== 2.2 COAL Interface ===
Camera-man system is also controllable via COAL scripts, see the [[CAMERA-MAN Manual]] for more information.

- [TODO]

=== 2.3 RTS Interface ===
Camera-man system is also controllable via RTS scripts, see the [[CAMERA-MAN Manual]] for more information.

CAMERA-MAN - Revision history

Corbin: finally added CAMERA-MAN basics