head	1.6;
access;
symbols
	start:1.1.1.1
	salsaman:1.1.1;
locks; strict;
comment	@# @;


1.6
date	2009.06.27.21.05.43;	author gfinch;	state Exp;
branches;
next	1.5;

1.5
date	2006.12.13.01.03.43;	author gfinch;	state Exp;
branches;
next	1.4;

1.4
date	2006.02.15.13.37.29;	author gfinch;	state Exp;
branches;
next	1.3;

1.3
date	2005.12.11.00.08.11;	author gfinch;	state Exp;
branches;
next	1.2;

1.2
date	2005.03.28.13.08.59;	author gfinch;	state Exp;
branches;
next	1.1;

1.1
date	2004.09.19.04.06.47;	author gfinch;	state Exp;
branches
	1.1.1.1;
next	;

1.1.1.1
date	2004.09.19.04.06.47;	author gfinch;	state Exp;
branches;
next	;


desc
@@


1.6
log
@update and cleanup
@
text
@For a list of current features, see:
http://lives.sourceforge.net/index.php?do=features

For the LiVES manual and other documentation, see:
http://lives.sourceforge.net/index.php?do=documentation

@


1.5
log
@updates
@
text
@d1 2
a2 3
CONTENTS
-----------------
Sample features:
d4 2
a5 122
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
File/Load clip set and File/Close/Save all clips. A set can also be
saved when you quit, and can then be optionally autoloaded the next
time you start up.


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


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 are recorded by default. If you
want to change this, go to Tools/Preferences/Recording.




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
--------------------
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. For more information, see the multitrack
tutorial on the LiVES site (http://lives.sourceforge.net)




5. Jack transport control
-------------------------
LiVES can be controlled by a jack transport
(http://jackit.sf.net). You can set your jack transport
settings from Tools/Preferences/Jack.






6. Planned features (before 1.0)
--------------------------------
Freeze the encoder plugin API
Freeze the basic OSC API
General performance enhancements - mostly done...
Ability to open v4l1/2 devices as weed generators (planned via videojack).
Document all API's, finish multitrack tutorial (in progress)
Support Livido via a wrapper plugin.
Allow opening of multiple files at once.
Allow mixing of foreground and background generators.
Faster resizing.
Allow playback from any point on the multtrack timeline




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

Improved streaming

Support for freeframe

Support for paths

Support for grouping of clips

Support for masks

Auto-streaming/control architecture for pipelined applications

Cairo support
@


1.4
log
@updates
@
text
@d16 3
a18 1
VJ/save VJ set and VJ/load VJ set.
d75 1
a75 1
This is still being tested. After loading a few clips, you can go to
d77 2
a78 2
clips and render them. Effects have not yet been merged in with the
multitrack window.
d86 1
a86 2
(http://jackit.sf.net). You must recompile LiVES with the option:
./configure --enable-jack. You can now set your jack transport
d96 2
a97 9

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 rendered generators.
Handle audio seek/playback internally.
Lots more previews and thumbnails - pretty much done.
Playback on a separate display (maybe using SDL) (dual/multi head mode).
d100 8
a107 2
On screen display/realtime text renderer
GTK+ 2.4 support
a113 3
Direct interface to gimp - i.e. apply a gimp filter to one frame, and have it 
apply to all frames.

d126 1
a126 1
GTK+ 2.6/2.8 Cairo support
@


1.3
log
@code cleanup
@
text
@d55 2
a56 4
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.
d85 2
a86 1
./configure --enable-jack.
d100 1
a100 1
for realtime effect parameters, and rendered generators.
d102 2
a103 3
Lots more previews and thumbnails - partially done - images can now be previewed 
in the fileselector.
Playback on a separate display (maybe using SDL).
d119 1
a119 1
Support for freeframe/openFX
@


1.2
log
@doc updates
@
text
@d3 1
d5 1
d9 8
a16 1
4. Planned features
d26 3
d37 3
a39 1
If you are having fun skipping around a video using ctrl and cursor keys, and changing the playback speed, you will be happy to know you can 
a52 3
You can also back up a file with performance data, and when you restore it, your performance data will also be 
restored.

d55 4
a58 3

Note: at present it is not possible to record clip switches or effect changes in 
real time.
d73 8
d83 5
d90 5
a94 1
4. Planned features (before 1.0)
a105 1
Record should record clip switches and realtime effects.
d107 1
a107 1
Ability to open v4l1/2 devices as livido generators.
d109 1
a109 2
Real time key assigner
GTK+ 2.2 support
a113 5
Multitrack timeline - need some ideas for this : what is your ideal timeline 
setup ?

Multitrack realtime compositor

d127 1
a127 3
Support for keyframing

Support for masks and alpha blending
d131 1
a131 1
GTK+ 2.4/2.6 support
@


1.1
log
@Initial revision
@
text
@d69 4
a72 5
Ability to remotely control LiVES using OSC.
Improved merging of frames - more merge methods.
Make the app extendable, so that effects and players can be plugged in - 
encoders are done, video playback plugins are done, effects are being worked on 
Still to do: decoders.
d76 1
a76 2
Playback on a separate display (maybe through xinerama (local) and libOMC 
(remote)).
d79 4
d90 2
a93 2
Ability to open v4l2 devices as normal clips.

d97 1
d99 1
d101 1
d103 1
d105 1
d107 1
d109 1
d111 1
@


1.1.1.1
log
@Initial Import
@
text
@@
