X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=demo%2FREADME;h=5e2fe08a5bc94ebb7f29dddc11da66212e549696;hb=fc1d15d905d89379235c5b7bd4b1c34f7ba1e56a;hp=6cec29c9dbdfa34cdedaf87e6abba32f17c89f1a;hpb=440783291b4f6e1ead0a9feacdfe77039dbe1304;p=mlt diff --git a/demo/README b/demo/README index 6cec29c9..5e2fe08a 100644 --- a/demo/README +++ b/demo/README @@ -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. @@ -11,14 +11,17 @@ what details to look for. First, a note on consumers. When you start the script, the main menu asks you to choose a consumer. A consumer is like a viewer, but it could also write to a stream/file. The "SDL" consumer is the popular Simple DirectMedia -Layer audio and video output. The "Westley" consumer generates an XML +Layer audio and video output. The "xml" 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 -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. +XML producer plugin. See docs/mlt-xml.txt for more information. "/dev/dv1394/0" +refers to a device file for transmitting DV over FireWire using the Linux +dv1394 kernel module. + +These examples assume the numeric locale LC_NUMERIC decimal separator is a +period. Therefore, the demo script sets LC_NUMERIC=C for you, but if you are +running these manually or learning from them, remember to use the appropriate +separator for your locale. + And now the demos... @@ -73,6 +76,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 +93,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 @@ -154,7 +159,7 @@ Title over graphic Slideshow This demo requires any number of JPEG images with the extension ".jpg" - in a subdirectory named "Scotland." + in a subdirectory named "photos." Bouncy, Bouncy @@ -166,3 +171,61 @@ 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. + +Pango Keyframed Markup + + You can create timed text and subtitles using a .mpl file, which is a + properties format file. A properties file contains key=value pairs on + separate lines. For .mpl the key is a frame number and the value is + Pango Markup Language. A tilde is interpreted as a new line. This + example also demonstrates using the watermark and the alignment + properties of its encapsulated composite transition where halign + is the horizontal, valign is the vertical, c is for center, and m + is for middle.