VaM Camera Director
By Somnus | Plugin 0.17.0

INSTALL
1. Put Somnus.VaMCameraDirector.1.var into your VaM/AddonPackages folder. Do not extract or rename it.
2. Restart VaM, or rescan packages if VaM is already open.
3. Add an Empty atom to your scene. Open its Plugins tab and select a plugin file.
4. Find the VaMCameraDirector package and select VaMCameraDirector.cslist.
5. Allow the plugin to run when VaM asks. Open its controls.
6. Expand Camera and atom selection. Select an actor under Focus atom, then enable
   Include atom in focus. Repeat for more actors, or use Select all actors.
7. Leave Drive player view enabled, press Start Director, and close the menu.
   Pause while menu is open is on by default.

SHORTCUTS
Numpad - : Start / stop Director. Stop restores the camera position and rotation
           captured immediately before the most recent Start.
Numpad 0 : Toggle controlled shots while Director is running.
Numpad 1 : Request a head/face shot in controlled mode.
Numpad 2 : Request a glutes shot in controlled mode.
Body-shot and controlled-mode bindings can be changed in Controlled camera shots.
Numpad minus is reserved for Start/Stop. Use Num Lock; shortcuts ignore text entry,
held modifiers and an unfocused game.

TIPS
- All menu sections start collapsed. Expand only the controls you want to adjust.
- Vertical shot variation is in Shot settings; it also affects controlled shots.
- Select VaMCameraDirector.cslist, not an individual C# source file.
- Effects have separate switches: loading the plugin does not enable every effect.
- Flare and dirt respond to visible bright pixels. Lower Light activation threshold
  if needed. An invisible Light atom does not itself produce a visible streak.
- Use one Director per player view. Stop another camera-driving plugin first.
- In desktop mode, WindowCamera is optional. For preview output, disable Drive
  player view and select a WindowCamera.
- VR headset takeover is not supported. The viewfinder REC indicator is decorative;
  this plugin does not record videos.
- Shaders and dirt textures are inside this package. No other plugin is required.

UPDATING
Avoid loading the loose-file version and this packaged version on the same view.
For an existing development scene, save your plugin settings/preset before replacing
its plugin entry. Choose the cslist inside this package, restore settings, then save.
