CoDTV MovieMaking Tools v1.1 README file
ScareD&SLI
Vision mod by iCore
13th June 2012

1) Introduction
CoDTV MM Tools is a part of promod-based bunch of software and mod, made specially for CoD4 moviemakers.
It does not requires any special skills or installed software to be used, the only thing required is your brain.
It's still not in the final versions, so there may be some bugs or crashes (check the KNOWN ISSUES part) while using it.
Please, be patient and polite anyway.
-----------------------------------------------------------------
2) Features
At the current stage CoDTV MM tools supports these features:

-Making the camera flight (LCE-like) with unlocked Z axis
-Building some extra destroyable objects on maps (barrels, cars, etc.)
-Adding "death" effects to those objects (like explosion, etc.)
-Adding "spawn" effects to those objects (like fire, etc.)
-Placing some extra effects anywhere to the map (infinite effect are supported too)
-Creating movie cfg's, simple cfg's and mapper cfg's (with easy filmtweak setting on-the-fly) - Vision tool by iCore

Last two listed features are still in the testing stage, so if you found any issues, please, contact us @ forum (http://codtv.org/?post_type=forum)
-----------------------------------------------------------------
3) Instructions
This mod requires a listen server, set by someone who have a good-performance PC.
Once you started a server, you became a so-called cameraman: a man, who controls checkpoints for the camera flight.
There are some console commands avaliable, let's check them:
 movie_speed INTEGER               this command defines how fast will the camera move
 movie_wait INTEGER                a time will pass after you pressed the start flight button till the flight will start
 movie_cameraman STRING            //TEMP. NOT SUPPORTED

4) Building objects
Also you can build some objects on the map.
Unfortunately, at the current stage mod supports only default map objects and effects (already precached while loading your map) like cars, 
barrels,etc.
To use this feature you need to manually choose supported models (chick this link for lists:http://codtv.org/MM/codmaps.html  ) and precache them 
in the cusom_objects.gsc file.
Open an custom_objects.iwd archive and check it inside, there is a how-to-use precache instruction.
***You can use the CoDTVMMupdater.exe to easily edit custom_objects.gsc, without opening an archive etc. check it out!***
Also you can set there some parameters like effects, explosion power, and caused damage for each object.


Now, when you have set it up, we can start the game. Run a server and open console.
You'll see two commands there:
 movie_objModel STRING            specify your precached model name here
 movie_objHealth INTEGER          sets the number of shots needed to explode (or simply destroy) your object.
 movie_fxLoopDelay INTEGER        sets the delay of an object spawn fx loop. Must be set before creating an object and could be set different for each object

!!! Set movie_objHealth BEFORE building an object, because it is being used on the building stage, not after. After you've built an object 
you can't change it's health using this string.

Now simply open quickmessages menu, pass to the Object Creator submenu and press "1". To put an object on the ground press MOUSEBUTTON1. To pick it up come 
to it and press F. When an object is in your hands press frag grenade button to destroy it without any effects. Very simple.
-----------------------------------------------------------------
5) Building effects
Since the v1.1, you can add custom effects on the map without adding an object.
Use the CoDTVMMupdater.exe to precache needed FXs.
In the game you need to 
-set the "movie_fxName" variable to the chosen model
-set the movie_fxLoopDelay variable to set the loop delay for this FX (it will be replayed constantly with the delay in set seconds). 0 is once-played effect.
Try combinating different effect and looptypes - it may look very nice!
-----------------------------------------------------------------
6) Other Obj Creator menu functions
Using this menu you can also:
-clear map (destroy all planted objects without any effects).
-swith plant object type - when it's set to the "Ground" all objects will be planted on the ground. When "noclip" - you'll be able to spawn objects in air.
-switch visible object types - you can hide stock objects (cars and barrels), your custom objects, or both of them. Good for overriding effect in moviemaking.
-also you can print your current coordinates to the screen
-----------------------------------------------------------------
7)Flight camera features
You can use CoDTVMMTools mod to create awesome hard cameras in 10 clicks!
The only thing you need is to:
-Add position using the "CoDTV Movie menu" (b-5 combination) or your binds (to bind buttons, use the multiplayer controls menu)
-Start the flight using the same menu or your bind.
Once you've added a checkpoint, a big black ball will appear there. Don't be afraid. This ball is very useful. Put your look at it, and you'll be able to:
-Load this position pressing {+activate} button;
-Replace checkpoint holding {+accatck} button. Then change your position to a needed one and release the {+attack} button;
-Remove this checkpoint pressing {+frag} button. This won't affect on other made positions.
Also use your binds or MoveMaking menu to rotate your camera in Z axis, clear positions or stop flight.
Don't forget that you can change camera flight speed using the "movie_speed" var and startup timer using the "movie_wait" var.

*WARNING* You can't add more then 13 cameras. This caused by an algorythm which is used to build the path, so we can't change it ATM
*WARNING* Camera will reach only the first and the last checkpoints. Check this pic., and you'll understand (we hope) why:
http://upload.wikimedia.org/wikipedia/en/thumb/0/0b/BezierCurve.gif/240px-BezierCurve.gif
So try to predict the path and fix it before you understand that it's wrong.

*WARNING* sv_fps is set to 100 by default, but we strongly recommend you to use a 500 value to make your cameras smoother
!!!!!!!!! note, that you have to multiply any timers with a sv_fps/100 integer. Like if you use sv_fps 500 and you want to have a 10-second  movie_wait,
!!!!!!!!! you need to set movie_wait to 50.
-----------------------------------------------------------------
8) Cameraman
***TEMPORARY UNSUPPORTED***
-----------------------------------------------------------------
9) The Visual mod by iCore
(More info here: http://modbase.hu/projects/93-Visual)
Once you have joined the server, you can swith the gamemode to Visual mod.
This mod is made to help you to generate configs without any special efforts.
To switch the gamemode, open menu and press "Switch to Visual" button.
***NOTE, CoDTV MM features won't work in Visual gamemode, and Visual features won't work in the CoDTV MM gamemode***
Then select your class, and open menu again. You'll see two items: Config, and Vision.
There are no differences between them, Vision just has less options (only needed for MAPMAKING).
Config menu has a various of options such as Glow options, easy flimTweak setup, sunlight, DOF options.
Also you can change team colors here, and make sun anim, but the sun anim (vstr-script builder) is not working properly. It will be improved and fixed
in the next version.
-----------------------------------------------------------------
10) Known Issues
*Some Z axis rotations may be incorrect (using the "longest way"). Add more in-between points to avoid this
*Camera will rotate very fast if you've changed angles, but did not changed camera origin. So, try to move at least for 1 pixel before adding a spot
*Camera may shake while watching demo. Temporary workaround (v1.11):
 1) Add all spots you need, check if the flight is correct
 2) Set movie_speed dvar to 1 (default is 10) or less
 3) record the demo (it will take much more time, but it works, checked ~ 50 times)
 4) Open the demo using CoDTVMM mod (/demo DEMONAME) in console, and quickly set timescale dvar from 1 to 10. So the flight will be the sam as if
 you recordered it using movie_speed 10 and timescale from 0.1 to 1.
*Some text notifications and advices may not be destroyed correctly. fast_restart should help to clear them
*Some objects and FXs may not load correctly. If you found one,please report us at forum.
*Sometimes server may crash if you've placed too many effects and models. Don't be so greed to fix it.

If you found any unpresent issue, please contact us @ codtv.org. Let's make this mod better!
-----------------------------------------------------------------
11) Special thanks
We would like to credit to
iCore for his great Visual mod
Ingram, Trivve - CoD4 promod developers for the source codes and advices
Or1on - CoD4 moviemaker for testing and advices
Slinger aka Gagarin - for his tech. support and ideas.
-----------------------------------------------------------------
-----------------------------------------------------------------
-----------------------------------------------------------------
ScareD&SLI, CoDTV dev. team.
http://codtv.org
http://twitter.com/#!/CoDTVEurope
http://www.facebook.com/CoDTVEurope
http://www.youtube.com/user/codtvs
http://vk.com/codtveurope