X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=demo%2FREADME;h=5e2fe08a5bc94ebb7f29dddc11da66212e549696;hb=5a9b3541e147a343c998b286ada0c87293354d7c;hp=bcfcafa8ee5840646ccf66d887b0cd814740de7c;hpb=2204f74946a3d159cf667015b4d48aad5b02dde0;p=mlt diff --git a/demo/README b/demo/README index bcfcafa8..5e2fe08a 100644 --- a/demo/README +++ b/demo/README @@ -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/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. +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... @@ -90,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 @@ -156,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 @@ -215,3 +218,14 @@ Ticker tape 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.