CONTENTS
-----------------
Sample features:

0. Loading and saving sets
1. Controls during playback
2. Recording a performance
3. Capturing an external window
4. Multitrack window
5. Jack transport control
6. Planned features


-----------------------------------------------------------------------
0. Sets (groups of clips) can be loaded and saved via the menu options
VJ/save VJ set and VJ/load VJ set.


-----------------------------------------------------------------------


1. Controls during playback
------------------------
See the menu option VJ | Show VJ keys

Real time effects can be reassigned via the realtime effects window
(ctrl-v).


-------------------------------------------------------------------------




2. Recording a Performance

If you are having fun skipping around a video using ctrl and cursor
keys, changing the playback speed, switching clips, and applying
realtime effects, you will be happy to know you can 
record yourself doing this.

To record, with video and audio loaded, simply press 'r' before playing a whole clip or a selection. Any changes you 
make using the keys listed above, will be recorded.

If you play the whole video, it will automatically loop to fit the audio. If you play a selection, the recording length 
depends on whether you have 'loop video to fit audio' on or off.

After recording you can play back and review your changes. You can reorder the frames to match your performance
 by clicking on Tools-->Reorder Frames. It is a good idea to do this before applying any futher effects since the 
frames will be mixed up. In fact, you *must* reorder the frames before LiVES will let you insert or delete frames to 
that clip.

To clear performance data, simply press 'r' twice.

Clip switches and realtime effects can be recorded. Go to
Preferences/Recording, and select "real time effects" and "clip
switches" as events to be recorded. Afterwards you can render what was
recorded, or view it in the multitrack window.




3. Capturing an external window
-------------------------------

LiVES has the ability to capture and record almost any X11 window.
This works particularly well with, for example, xmms visual plugins or xscreensaver modules.

This is now done simply through Tools|Capture external window. Press 'q' when you are done recording.



4. Multitrack window
--------------------
This is still being tested. After loading a few clips, you can go to
the multitrack window by pressing ctrl-m. Here you can lay out your
clips and render them. Effects have not yet been merged in with the
multitrack window.




5. Jack transport control
-------------------------
LiVES can be controlled by a jack transport
(http://jackit.sf.net). You must recompile LiVES with the option:
./configure --enable-jack.






6. Planned features (before 1.0)
--------------------------------

More effects / improve existing effects - currently in progess.
Ability to remotely control LiVES using OSC - basic structure now in place.
Improved merging of frames - more merge methods - work on this has begun, using RFX.
Make the app extendable, so that effects and players can be plugged in - mostly done, still some work needed 
for realtime effect parameters, and rendered generators.
Handle audio seek/playback internally.
Lots more previews and thumbnails - partially done - images can now be previewed 
in the fileselector.
Playback on a separate display (maybe using SDL).
General performance enhancements - mostly done...
Ability to open v4l1/2 devices as weed generators (planned via videojack).
On screen display/realtime text renderer
GTK+ 2.4 support


Post 1.0 (?)
--------
Subtitle/text rendering module.

Direct interface to gimp - i.e. apply a gimp filter to one frame, and have it 
apply to all frames.

Improved streaming

Support for freeframe/openFX

Support for paths

Support for grouping of clips

Support for masks

Auto-streaming/control architecture for pipelined applications

GTK+ 2.6/2.8 Cairo support

