Framework Documentation
-Copyright (C) 2004 Ushodaya Enterprises Limited
+Copyright (C) 2004-2009 Ushodaya Enterprises Limited
Author: Charles Yates <charles.yates@pandora.be>
-Last Revision: 2004-10-08
+Last Revision: 2005-05-08
MLT FRAMEWORK
opposed to the implementation details.
It is not required reading for the MLT client/server integration - please
- refer to valerie.txt and dvcp.txt for more details on this area.
+ refer to libmvsp.txt and mvsp.txt for more details on this area.
SECTION 1 - BASIC OVERVIEW
The defaults requested here are a special case - the NULL usage requests
that we use the default producers and consumers.
- The default producer is "fezzik". This producer matches file names to
+ The default producer is "loader". This producer matches file names to
locate a service to use and attaches 'normalising filters' (such as scalers,
deinterlacers, resamplers and field normalisers) to the loaded content -
these filters ensure that the consumer gets what it asks for.
- The default consumer is "sdl". The combination of fezzik and sdl will
+ The default consumer is "sdl". The combination of loader and sdl will
provide a media player.
In this example, we connect the producer and then start the consumer. We
Also note, you can override the defaults as follows:
- $ MLT_CONSUMER=westley ./hello file.avi
+ $ MLT_CONSUMER=xml ./hello file.avi
- This will create a westley xml document on stdout.
+ This will create a XML document on stdout.
- $ MLT_CONSUMER=westley MLT_PRODUCER=avformat ./hello file.avi
+ $ MLT_CONSUMER=xml MLT_PRODUCER=avformat ./hello file.avi
This will play the video using the avformat producer directly, thus it will
bypass the normalising functions.
+------------------+------------------------------------+------------------+
|MLT_NORMALISATION |The normalisation of the system |PAL or NTSC |
+------------------+------------------------------------+------------------+
- |MLT_PRODUCER |The default producer |"fezzik" or other |
+ |MLT_PRODUCER |The default producer |"loader" or other |
+------------------+------------------------------------+------------------+
|MLT_CONSUMER |The default consumer |"sdl" or other |
+------------------+------------------------------------+------------------+
mlt_producer_optimise( mlt_playlist_producer( playlist ) );
after the mix calls have be done. Note that this is automatically applied
- to deserialised westleys.
+ to deserialised MLT XML.
Multiple Tracks and Transitions:
mlt_multitrack multitrack = mlt_tractor_multitrack( tractor );
// Create a composite transition
- mlt_transition transition = mlt_factory_transition( "composite", "10%,10%:15%x15%" );
+ mlt_transition transition = mlt_factory_transition( "composite", "10%/10%:15%x15%" );
// Create track 0
mlt_producer track0 = create_playlist( argc, argv );
- // Create the watermark track - note we NEED fezzik for scaling here
- mlt_producer track1 = mlt_factory_producer( "fezzik", "pango" );
+ // Create the watermark track - note we NEED loader for scaling here
+ mlt_producer track1 = mlt_factory_producer( "loader", "pango" );
// Get the length of track0
mlt_position length = mlt_producer_get_playtime( track0 );
A service does not define any properties when constructed. It should be
noted that producers, filters and transitions my be serialised (say, via the
- westley consumer), and care should be taken to distinguish between
+ xml consumer), and care should be taken to distinguish between
serialisable and transient properties. The convention used is to prefix
transient properties with an underscore.