LiVES
LiVES - the Linux Video Editing System
released under the GPL 2.0
Screenshot of latest version:
Author: salsaman <salsaman@xs4all.nl>
Download:
Version 0.4.5 (released 17/02/03)
GNU/Linux binary package -
LiVES-0.4.5-bin.tar.bz2
GNU/Linux source package -
LiVES-0.4.5-src.tar.bz2
README file
Requirements:
mplayer 0.90rc1+
mencoder with libavcodec (required for saving
only)
ImageMagick
perl 5+
gtk+ 2.x
libjpeg62
gdk-pixbuf-loaders
sox (recommended)
xmms (optional)
Technical
LiVES is written as a client/server architecture.
smogrify
Smogrify (super mogrify) is the command line client for LiVES. It runs
in background mode.
Any items in [square brackets] are planned but not yet implemented.
Except where indicated otherwise, functions return 0 on success, 1 on
failure.
File Ops
*smogrify new
- create handle for new file
On success : returns n_handle,
on failure, returns 0.
Info file is created in
tempdir/.info.n_handle
(default temp dir is /tmp/livestmp).
This file contains handle,
which is used as a key in all
other functions below.
[File is
optional, if it is set, smogrify will write file details in...]
*smogrify get_details
<file>
- return number file size [and number of frames]
smogrify open handle <file>
- saves frames
to temporary space. New should
be called first to obtain handle
*smogrify save handle fps new_file s_frame e_frame arate
achans asamp [type]
- save to new
file from start to end [in format type]
arate, achans and
asamp are audio rate,channels and sample
size
*smogrify close handle
-
clean up temp directory entry for handle,
should be called for each handle
before
gui exit.
(close will call cancel - see below, if required
before it cleans up).
*smogrify cleanup
- clean up all temporary
space (generally only required during testing)
Frame Ops
*smogrify cut handle s_frame
e_frame [cut_audio] num_frames
-
cuts frames s_frame to e_frame (inclusive) from handle. Frames
after the cut are renumbered
so there is no gap. If cut_audio is
>0, audio track will be
cut also.
num_frames should be a count of the number
of frames in handle;
this is necessary to assist smogrify in making
space.
*smogrify insert handle where
paste_after s_frame e_frame handle2
[with_audio] num_frames width height
- insert s_frame to e_frame from handle2
to handle at
postion where.
If paste_after
is >0, frames are pasted after where,
otherwise
before where. With_audio !=0 indicates
paste with audio.
*smogrify reverse handle
s_frame e_frame [reverse_audio]
-
reverse time order of frames in handle
Utility Ops
*smogrify report
homedir
- reports temp
directory and other details to file /tmp/.smogrify
should be called first on gui startup
since it also initialises .rc file
*smogrify rc_set key value
- set key to value in .rc file
[*smogrify rc_get key
- get value of key - value is
returned in status file, (cf. new)
[*smogrify rc_get_default key
- like rc_get, but returns a default value
*smogrify tell_window pid
window_id
- create a file /tmp/liveswin.pid
containing window_id of player
window
*smogrify remove_window
pid
- remove /tmp/liveswin.pid (should
be called before gui exit)
*smogrify cancel handle
- cancels the process working on handle.
Commands marked with * should
not/cannot be cancelled.
*smogrify undo handle
s_frame e_frame
- undoes the last filter or resize operation on handle,
between s_frame and e_frame
*smogrify redo handle
s_frame e_frame
- redoes the last filter or resize operation on handle,
between s_frame and e_frame
*smogrify version
- prints the version
number and exits
Audio
Ops
smogrify mp3open handle
filename
- load an alternate audio track
smogrify oggopen handle filename
smogrify wavopen handle
filename
[smogrify audioopen handle
filename]
- auto open of audio file
*smogrify xmmsplay
filename
- make xmms play filename
*smogrify xmmsstop
filename
- make xmms stop
Playback Ops
*smogrify play handle
s_frame e_frame fps fs loop w_id height width arate achans asamp
- plays file (from start frame to end
frame at rate fps) in window
w_id, using
width and height if possible.
if
fs is non-zero, full screen mode will be requested. loop=1 will
loop until audio is finished. arate
achans and asamp are audio rate
and number of chans.
Arate <0 will mute audio.
*smogrify stop handle
- stop playing handle
(audio and video streams)
(but see the
file BUGS).
[smogrify get_frames_played handle]
???
Filter Ops
smogrify charcoal handle
s_frame e_frame [radius]
- simulate charcoal (from s_frame to e_frame)
smogrify colorize handle
s_frame e_frame cstart %start cstep %end
- apply a wash (from s_frame to
e_frame)
smogrify cycle handle
s_frame e_frame [cstart cstep]
- cycle colours from s_frame to e_frame
{slow}
smogrify edge handle
s_frame e_frame [radius]
- edge detect from s_frame to e_frame
smogrify enhance handle
s_frame e_frame
- enhance each frame from s_frame to e_frame
smogrify monochrome handle s_frame
e_frame -
monochrome each frame from s_frame to e_frame
smogrify negate handle
s_frame e_frame skip -
negate each frame from s_frame to e_frame with a skip value of skip
smogrify randomzoom handle
s_frame e_frame max_zoom speed -
randomly zoom in and out from s_frame to e_frame [max_zoom and speed]
smogrify resize handle
s_frame e_frame height width -
resize frames to height and width
smogrify rotate handle s_frame e_frame
degstep - rotate each
frame from s_frame to e_frame with a step value of degstep
smogrify solarize handle
s_frame e_frame start step
- solarize each frame from s_frame to e_frame with a step value of step
smogrify swirl handle s_frame
e_frame [degstart degstep]
- swirl frames
lives-exe
lives-exe is the gui front end for LiVES. It currently supports/runs
with gtk+2.0. A QT version is also planned for the future.
CHANGES
comments ? suggestions ? requests ?
contact the author at: salsaman@xs4all.nl