+Installation Documentation
+
+Copyright (C) 2004 Ushodaya Enterprises Limited
+Author: Charles Yates <charles.yates@pandora.be>
+Last Revision: 2004-04-13
+
+
INSTALL
-------
This document provides a description of the MLT project installation and
organisation.
- It provides *CRITICAL* architecture information, so please read carefully
- if you plan to extend or use the MLT code base.
-
Directories
-----------
+ ffmpeg - ffmpeg dependent services
+ avformat - libavformat dependent services
+ vorbis - vorbis dependenent services
- + sdl - SDL dependent services
+ + sdl - SDL dependent services
+ resample - libresample dependent services
+ gtk2 - pango and pixbuf dependent services
+ fezzik - A giant (meta) service to load and normalise media
- + westley Nice and clever XML services
- + vorbis Ogg Vorbis dependent services
+ + westley - Nice and clever XML services
+ + vorbis - Ogg Vorbis dependent services
+ xine - Xine-derived sources
+ bluefish - Bluefish dependent services (*)
+ mainconcept - mainconcept dependent services (*)
(*) Not posted to CVS due to licensing issues.
+Dependencies
+------------
+
+ The MLT core is dependent on:
+
+ * a C99 compliant C compiler
+ * posix threading
+ * standard posix libraries
+
+ The MLT applications and libraries provided are all dependent on the core.
+
+ The modules have the following dependencies:
+
+ ----------- ----------------------------------------------------------
+ MODULE DESCRIPTION
+ ----------- ----------------------------------------------------------
+ avformat Provided from ffmpeg CVS and compiled as a shared library.
+ URL: http://ffmpeg.sf.net
+ ----------- ----------------------------------------------------------
+ bluefish Bluefish hardware and software development kit
+ URL: http://www.bluefish444.com
+ ----------- ----------------------------------------------------------
+ dv libdv 0.102 or later.
+ URL: http://libdv.sf.net
+ ----------- ----------------------------------------------------------
+ gtk2 GTK2 and associated dependencies.
+ URL: http://www.gtk.org
+ ----------- ----------------------------------------------------------
+ mainconcept Mainconcept MPEG and DVCPRO Release SDKs.
+ URL: http://www.mainconcept.com
+ ----------- ----------------------------------------------------------
+ resample libsamplerate 0.15 or later
+ URL: http://www.mega-nerd.com/SRC/
+ ----------- ----------------------------------------------------------
+ sdl SDL 1.2 or later.
+ URL: http://www.libsdl.org
+ ----------- ----------------------------------------------------------
+ vorbis libvorbis 1.0.1 or later.
+ URL: http://www.vorbis.com/
+ ----------- ----------------------------------------------------------
+ westley libxml2 2.5 or later.
+ URL: http://www.xmlsoft.org/
+ ----------- ----------------------------------------------------------
+
+
Configuration
-------------
./configure --help - report all configure options
./configure --prefix=[dir] - target install directory (default: /usr/local)
+ ./configure --disable-debug - turn off debugging
+ ./configure --disable-mmx - turn off MMX usage
+ ./configure --cpu='cpu' - tune build for a specific cpu
./configure --disable-[mod] - do not compile specified module(s)
./configure --[other] - pass through to children
. setenv
- NB: This applies to your current shell only.
+ NB: This applies to your current shell only and it assumes sh or bash.
Installation
------------
- * NOT IMPLEMENTED YET *
-
- The install is triggered by running make install or make install-strip
- from the top level directory.
+ The install is triggered by running make install from the top level
+ directory.
The framework produces a single shared object which is installed in
$prefix/lib/ and public header files which are installed in
$prefix/include/mlt/framework.
- The client produces a single shared object which is installed in
+ Valerie produces a single shared object which is installed in
$prefix/lib/ and public header which are installed in
- $prefix/include/mlt/client.
+ $prefix/include/mlt/valerie.
- The server produces a single exectuable which is installed in
- $prefix/bin/. This is linked against the framework shared object and
- posix libs but not against any of the modules.
+ Miracle produces a single exectuable which is installed in
+ $prefix/bin/, a library in $prefix/lib and associated header files in
+ $prefix/include.
The modules produce a shared object per module and update text files
containing a list of modules provided by this build. These are installed
- in $prefix/share/mlt/. It is at the discretion of the module to install
- additional support files.
+ in $prefix/share/mlt/modules. It is at the discretion of the module to
+ install additional support files.
- To allow the development of external components, mlt-client-config and
- mlt-framework-config scripts are generated and installed in $prefix/bin.
+ To allow the development of external components, mlt-config and scripts
+ are generated and installed in $prefix/bin.
After install, only those modules listed are usable by the server. No
module is loaded unless explicitly requested via server configuration
or usage.
- External modules are also placed in this $prefix/share/mlt, and the
+ External modules are also placed in this $prefix/share/mlt/modules, and the
installation of those must modify the text file accordingly before they
will be considered at runtime.