Merge ../mlt++
[melted] / demo / README
index 6cec29c..a9a5a08 100644 (file)
@@ -2,8 +2,8 @@ MLT Demo Notes
 
 Before running the demo script, make sure you '. setenv' from the parent
 directory. Also, please create clips clip1.dv, clip2.dv, clip3.dv, clip1.mpeg,
-clip2.mpeg, clip3.mpeg, and music1.ogg. It is okay if some of these are
-duplicates. Please make sure clips are at least 500 frames duration.
+clip2.mpeg, clip3.mpeg, and music1.ogg. Please make sure clips are at least 500 
+frames duration.
 
 These notes explain the the concepts presented in each demonstration and
 what details to look for.
@@ -15,7 +15,7 @@ Layer audio and video output. The "Westley" consumer generates an XML
 representation of the service network. That can be played directly due to the
 westley producer plugin. See docs/westley.txt for more information. The
 "MainConcept DV" consumer refers to the proprietary MLT plugin required to
-use MLT with MainConcept DV, DVCPro, and MPEG codecs. "/dev/dv1394" refers
+use MLT with MainConcept DV, DVCPro, and MPEG codecs. "/dev/dv1394/0" refers
 to a device file for transmitting DV over FireWire using the Linux dv1394 kernel
 module. The "BlueFish444" consumer is another proprietary plugin to use
 the BlueFish444 manufactured SDI video/audio output cards with MLT.
@@ -73,6 +73,8 @@ Clock in and out
        This image can be a 16 bit PGM (grayscale bitmap) or the luma channel of
        any video producer. A number of high quality wipes can be downloaded from
        http://mlt.sf.net/. It also performs field rendering.
+       The second wipe demonstrates the ability to control the direction of the
+       wipe as well.
        
 Obscure
 
@@ -88,7 +90,7 @@ Audio Stuff
 
        A music bed sound track can be mixed with a video. The sound track of the
        video clip has a "floating" amplitude normalisation filter applied.
-       Typically, audio nornmalisation applies a constant gain factor across the
+       Typically, audio normalisation applies a constant gain factor across the
        entire duration of an audio segment from a single source where the 
        gain factor is automatically determined by anaylsing the maximum "power"
        or peak levels. However, in news production, a popular requirement is to
@@ -166,3 +168,50 @@ Bouncy, Bouncy Ball
 
        A variation on the above Bouncy, Bouncy demo that applies a shape, or
        alpha producer, to the the compositing region.
+       
+Breaking News
+
+       This demonstrates layout capabilities of the compositor.
+
+Squeeze Transitions
+
+       This demonstrates a distorting barndoor-like wipe.
+
+
+J Cut
+
+       A J cut is an edit where the audio cuts before the video.
+       It gets its name from the way it looks on a NLE timeline user interface.
+       When the audio cuts over, it does an audio crossfade over the duration of 
+       one frame. This makes the audio cut slightly less abrupt and avoids any 
+       "click" due to mismatched sample levels at the edit point. The video edit
+       is a hard cut.
+
+L Cut
+
+       An L cut is an edit where the video cuts before the audio.
+       It gets its name from the way it looks on a NLE timeline user interface.
+       This demo shows a very quick dissolve over 5 frames for a soft video cut.
+       Like the J Cut demo, an audio crossfade for the duration of one frame makes
+       an audio edit nearly instantaneous while being slightly softened and 
+       avoiding aberrations.
+
+Fade from/to black/silence
+
+       Of course, it is possible using MLT to fade from black on video and silence
+       on audio as well fade to black and silence.
+       
+Push wipe
+
+       A push wipe is a somewhat fancier transition than most standard wipes
+       because it involves motion. The new video clip "pushes" the old video
+       clip off one edge. If you can preview on an analog monitor you will notice
+       how smooth the motion is due to field-based rendering.
+       
+Ticker tape
+
+       A very minimal reverse crawling title neard the bottom of the screen.
+       The goal of the demo is show fluid motion of the field-based rendering of
+       the compositor when viewed on an analog monitor using a DV or BlueFish444
+       consumer. The demo also shows the potientional for using and extending the
+       existing set of services for a full blown news ticker implementation.