research.m1stereo.tv/gitweb/ - melted/blob - mlt++/README

   1 MLT++
   2 -----
   3
   4         This mlt sub-project provides a C++ wrapping for the MLT library.
   5
   6 INSTALLATION
   7 ------------
   8
   9         ./configure [ --prefix=path ]
  10         make
  11         make install
  12
  13 USAGE
  14 -----
  15
  16         Use the following definitions in a Makefile to compile and link with mlt++:
  17
  18                 CXXFLAGS=`mlt-config -Wall`
  19                 LDFLAGS=-lmlt++
  20
  21         Include files for the classes can either be explicitly included, ie:
  22
  23                 #include <mlt++/MltProducer.h>
  24                 etc
  25
  26         Or you can include all using:
  27
  28                 #include <mlt++/Mlt.h>
  29
  30         All definitions are placed in an Mlt namespace, and adhere closely to the C
  31         naming convention. Mappings always follow the pattern:
  32
  33         Factory methods:
  34
  35                 mlt_factory_init        ==> Mlt::Factory::init
  36                 mlt_factory_producer    ==> Mlt::Factory::producer
  37                 mlt_factory_filter      ==> Mlt::Factory::filter
  38                 mlt_factory_transition  ==> Mlt::Factory::transition
  39                 mlt_factory_consumer    ==> Mlt::Factory::consumer
  40                 mlt_factory_close       ==> Mlt::Factory::close
  41
  42         NB: Factory usage for service construction is optional.
  43
  44         Types:
  45
  46                 mlt_properties          ==> Mlt::Properties
  47                 mlt_frame               ==> Mlt::Frame
  48                 mlt_service             ==> Mlt::Service
  49                 mlt_producer            ==> Mlt::Producer
  50                 mlt_filter              ==> Mlt::Filter
  51                 mlt_transition          ==> Mlt::Transition
  52                 mlt_consumer            ==> Mlt::Consumer
  53
  54         Methods:
  55
  56                 mlt_type_method         ==> Mlt::Type.method
  57         ie:     mlt_playlist_append     ==> Mlt::Playlist.append
  58
  59         Parent methods are available directly on children.
  60
  61         Additionally, you can specify:
  62
  63                 using namespace Mlt;
  64
  65         To avoid the enforced use of the Mlt:: prefix.
  66
  67         Enumerators and macros are reused directly from the C library.
  68
  69 CLASS HIERARCHY
  70 ---------------
  71
  72         The currently mapped objects are shown in the following hierarchy:
  73
  74                 Factory
  75                 Properties
  76                         Frame
  77                         Service
  78                                 Consumer
  79                                         FilteredConsumer [*]
  80                                 Field
  81                                 Filter
  82                                 Multitrack
  83                                 Producer
  84                                         Playlist
  85                                 Tractor
  86                                 Transition
  87
  88         [*] These classes have no direct equivalent in the C API.
  89
  90 SPECIAL CASES
  91 -------------
  92
  93         Care should be taken with wrapper objects.
  94
  95         Taking, as an example, the C function that returns the immediate consumer of
  96         a service:
  97
  98                 mlt_service mlt_service_consumer( mlt_service );
  99
 100         This maps to:
 101
 102                 Mlt::Service *Mlt::Service.consumer( );
 103
 104         Note that you get an object back - it is never the original c++ object, but
 105         a wrapping object. This is done to keep consistency with the C api which may
 106         instantiate C instances - therefore it cannot be assumed that a C++ object
 107         exists for all mlt service instances.
 108
 109         As such, it is mandatory that you delete these objects. The original will
 110         not be affected. However, all other modifications (to properties or its
 111         state of connection) will be reflected in the original object.
 112
 113         This approach excludes the use of RTTI to determine the real type of the
 114         object - this can only be done by parsing the objects properties.
 115
 116         Objects may be invalid - always use the is_valid method to check validity
 117         before use.
 118
 119 LIMITATIONS
 120 -----------
 121
 122         The mechanisms for the definition of new services are deliberately
 123         excluded from the C++ wrappings - this is done to ensure that service
 124         networks constructed can be serialised and used by existing applications
 125         which are based on the C API (such as miracle).
 126
 127 SWIG
 128 ----
 129
 130         Experimental swig bindings based on mlt++ are provided.
 131