# Documentation de la bibliothèque MLV-1.2.1

- Presentation
- Téléchargement
- Installation
- Compilation
- Exemples
- API
- Liste des fonctions
- bogues
- FAQ
- contacts

Installer MLV sous MacOS X

Vous pouvez installer la bibliothèque MLV de deux façons différentes:

- Installation de MLV à partir d'un paquet d'installation MacOSX
- Installation de MLV à partir du code source de la bibliothèque

Si vous ne savez pas quoi choisir, nous vous conseillons d'utiliser l'installation à l'aide des paquets car c'est la plus simple à installer. La deuxième, qui utilise le code source de la bibliothèque vous permettra toujours de réussir l'installation, mais elle est beaucoup plus compliquée à mettre en oeuvre.

# Installation de MLV à partir d'un paquet d'installation MacOSX

Pour insaller la bibliothèque MLV pour MacOS 10.5, vous devez téléchargez le fichier : mlv-1.2.1_macos-10.9.pkg.

Cliquez sur le paquet téléchargé et suivez les instructions.

A la fin de la procédure, l'installation est terminée.

# Installation de MLV à partir du code source de la bibliothèque

## Installation des outils de développement de MacOSX

Commencez par installer l'environnement de programmation d'Apple. Pour cela, au choix,

- Installez Xcode depuis le site de téléchargement de Apple.
- chargez le second dvd d'installation du système d'exploitation de votre ordinateur, puis installez XCode Tool.

Cet environnement contient entre autre gcc, et make.

## Mise en place d'un environnement de développement pour MLV

Nous allons installer la bibliothèque MLV ainsi que ses dépendances dans un répertoire de votre dossier personnel.

Créez un répertoire en tapant la commande :

    mkdir $HOME/fakeroot
    mkdir $HOME/fakeroot/src
    mkdir $HOME/Library/Frameworks

Il est nécessaire de configurer le système d'exploitation pour qu'il sache que de nouvelles bibliothèques sont installées dans le répertoire fakeroot. Pour cela, il suffit de définir quelques variables d'environnement dans un fichier qui est exécuté à chaque démarrage du terminal.

Ce fichier est $HOME/.bash_profile

Ajoutez, à la fin du fichier, les commandes suivantes:

    export FAKEROOT="$HOME/fakeroot"
    export PATH="$FAKEROOT/bin:$PATH"
    export DYLD_LIBRARY_PATH="$FAKEROOT/lib:$DYLD_LIBRARY_PATH"
    export PKG_CONFIG_PATH="$FAKEROOT/lib/pkgconfig:$PKG_CONFIG_PATH"
    export LD_LIBRARY_PATH="$FAKEROOT/lib:$LD_LIBRARY_PATH"
    export ACLOCAL="aclocal -I $FAKEROOT/share/aclocal -I /usr/share/aclocal"
    export PKG_CONFIG="$FAKEROOT/bin/pkg-config"
    export CPPFLAGS="-I$FAKEROOT/include"
    export LDFLAGS="-L$FAKEROOT/lib"

Si le fichier n'existe pas, créez le.

Vous devez maintenant redémarrer votre terminal pour prendre en compte les changements.

Vérifiez que les variables d'environnement ont bien été installées en tapant la commande:

    export

Cette commande devrait afficher toutes les variables d'environnement existantes.

Vous pouvez aussi les examiner une à une en tapant la commande:

    echo $FAKEROOT
    echo $PATH
    etc ...

## Installation des dépendances de MLV

Nous allons maintenant installer différents programmes et bibliothèques qui seront nécessaires au fonctionnement de MLV.

### Installation de pkg-config

Commencez par télécharger pkg-config.tar en allant sur le site :

http://pkgconfig.freedesktop.org/releases/

et en le mettant dans le répertoire

    $HOME/fakeroot/src

Il est important de PRENDRE LA DERNIÈRE VERSION DE PKG-CONFIG. En effet, pkg-config utilise une autre bibliothèque qui n'est pas incluse dans le codes source des anciennes versions.

Désarchivez le fichier en tapant la ligne de commande suivante:

    cd $HOME/fakeroot/src
    tar -xf pkg-config-X.X.tar

où X.X est le numéro de la version de la bibliothèque que vous avez téléchargée.

Nous allons maintenant installer pkg-config :

    cd ./pkg-config-X.X
    ./configure --with-internal-glib --prefix=$FAKEROOT
    make
    make install

La deuxième ligne de commande configure le code source de pkg-config pour que le code source prenne en compte les caractéristiques de l'architecture de votre ordinateur. L'option –prefix permet de dire au code source que le résultat de la compilation doit être installé dans le répertoire $FAKEROOT. Nous rappelons que la variable d'environnement $FAKEROOT a été précédemment configurée pour valoir la valeur $HOME/fakeroot (qui est votre répertoire d'installation des bibliothèques). La 3ème commande compile le programme. La dernière installe la bibliothèque sur votre ordinateur à l'endroit que vous avez donné lors de l'étape de configuration du code source.

Voilà, pkg-config est installée.

### Installation de M4

M4 est un outil d'aide à la compilation.

L'installation de M4 est identique à celle de pkg-config. Commencez par télécharger m4-X.X.X.tar sur le site : http://ftp.gnu.org/gnu/m4/

Puis tapez les commandes suivantes:

    cd $FAKEROOT/src
    tar -xf m4-X.X.X.tar.gz
    cd m4.X.X.X
    ./configure --prefix=$FAKEROOT
    make
    make install

### Installation de autoconf

Autoconf est un outil d'aide à la compilation.

Commencez par télécharger autoconf-X.X.tar.gz sur le site : http://ftp.gnu.org/gnu/autoconf/

Puis tapez les commandes suivantes:

    cd $FAKEROOT/src
    tar -xzf autoconf-X.X.tar.gz
    cd autoconf-X.X
    ./configure --prefix=$FAKEROOT
    make
    make install

### Installation de autoconf-archive

Autoconf-archives est une bibliothèque de script pour autoconf.

Commencez par télécharger autoconf-archive-X.X.X.tar.gz sur le site : http://ftp.gnu.org/gnu/autoconf-archive/

Puis tapez les commandes suivantes:

    cd $FAKEROOT/src
    tar -xzf autoconf-archive-X.X.X.tar.gz
    cd autoconf-archiv-X.X.X
    ./configure --prefix=$FAKEROOT
    make
    make install

### Installation de automake

Autocomake est un outil d'aide à la compilation.

Commencez par télécharger automake-X.X.tar.gz sur le site : http://ftp.gnu.org/gnu/automake/

Puis tapez les commandes suivantes:

    cd $FAKEROOT/src
    tar -xzf automake-X.X.tar.gz
    cd automake-X.X
    ./configure --prefix=$FAKEROOT
    make
    make install

### Installation de libtool

Libtool est un outil d'aide à la compilation.

L'installation de libtool est identique à celle de pkg-config. Commencez par télécharger libtool-X-X.tar sur le site : http://ftp.gnu.org/gnu/libtool/.

Puis tapez les commandes suivantes:

    cd $FAKEROOT/src
    tar -xf libtool-X-X.tar
    cd libtool-X-X
    ./configure --prefix=$FAKEROOT
    make
    make install

### Installation de libxml2

Téléchargez le code source de la bibliothèque sur le site ftp://xmlsoft.org/libxml2/

Vous pouvez choisir, par exemple, le fichier libxml2-git-snapshot.tar.gz.

Puis tapez les lignes de commandes suivantes:

    cd $FAKEROOT/src
    tar -xzf libxml2-X.tar.gz
    cd libxml2-X.X.X
    ./configure --prefix=$FAKEROOT
    make
    make install

### Installation de libffi

Commencez par télécharger libffi-X.X.tar.gz en allant sur le site :

    http://sourceware.org/libffi/

Puis tapez les lignes de commandes suivantes:

    cd $FAKEROOT/src
    tar -xzf libffi-X.X.tar.gz
    cd libffi-X.X
    ./configure --prefix=$FAKEROOT
    cd x86_64-apple-darwinX.X.X
    make
    make install

### Installation de gettext

Commencez par télécharger gettext-X.tar.gz en allant sur le site :

    http://www.gnu.org/software/gettext/

    cd $FAKEROOT/src
    tar -xzf gettext-X.X.X.X.tar.gz

Il faut modifier le code source de gettext, car il contient quelques erreurs. Pour cela, modifiez le fichier ./gettext-tools/gnulib-lib/stpncpy.c, et remplacez les lignes

    #ifndef weak_alias
    # define __stpncpy stpncpy
    #endif

par les lignes

    #ifndef weak_alias
    # undef stpncpy
    # define __stpncpy stpncpy
    #endif

Ensuite, compilez et installez la bibliothèque en tapant les commandes suivantes:

    cd gettext-X.X.X.X
    ./configure --prefix=$FAKEROOT
    make
    make install

### Installation de glib2

Téléchargez la bibliothèque sur le site http://ftp.gtk.org/pub/glib/

Désarchivez ensuite la bibliothèque en tapant les commandes suivantes:

    cd $FAKEROOT/src
    tar -xzf glib-2.X.X.tar.gz
    cd glib-2.X.X
    ./configure --prefix=$FAKEROOT
    make
    make install

### Installation de SDL

Téléchargez le paquet d'installation pour MacOSX de la bibliothèque sur le site http://www.libsdl.org/download-1.2.php

Ce paquet a pour nom : SDL-1.2.X.dmg (Intel10.5+)

Puis, installez le paquet en tapant les commandes suivantes :

    hdiutil attach SDL-1.2.X.dmg
    sudo cp -r /Volumes/SDL/SDL.framework /Library/Frameworks/
    hdiutil detach /Volumes/SDL

### Installation de SDL_image

Téléchargez le paquet d'installation pour MacOSX de la bibliothèque sur le site http://www.libsdl.org/projects/SDL_image/release-1.2.html

Ce paquet a pour nom : SDL_image-1.2.X.dmg (Intel10.5+)

Puis, installez le paquet en tapant les commandes suivantes :

    hdiutil attach SDL_image-1.2.X.dmg
    sudo cp -r /Volumes/SDL_image/SDL_image.framework /Library/Frameworks/
    hdiutil detach /Volumes/SDL_image

### Installation de SDL_mixer

Téléchargez le paquet d'installation pour MacOSX de la bibliothèque sur le site http://www.libsdl.org/projects/SDL_mixer/release-1.2.html

Ce paquet a pour nom : SDL_mixer-1.2.X.dmg (Intel10.5+)

Puis, installez le paquet en tapant les commandes suivantes :

    hdiutil attach SDL_mixer-1.2.X.dmg
    sudo cp -r /Volumes/SDL_mixer/SDL_mixer.framework /Library/Frameworks/
    hdiutil detach /Volumes/SDL_mixer

### Installation de SDL_ttf

Téléchargez le paquet d'installation pour MacOSX de la bibliothèque sur le site http://www.libsdl.org/projects/SDL_ttf/release-1.2.html

Ce paquet a pour nom : SDL_ttf-X.X.X.dmg (Intel10.5+)

Puis, installez le paquet en tapant les commandes suivantes :

    hdiutil attach SDL_ttf-X.X.X.dmg
    sudo cp -r /Volumes/SDL_ttf/SDL_ttf.framework /Library/Frameworks/
    hdiutil detach /Volumes/SDL_ttf

### Installation de SDL_gfx

Téléchargez le code source de la bibliothèque sur le site : http://www.ferzkopp.net/joomla/content/view/19/14/

    cd  $FAKEROOT/src
    tar -xzf SDL_gfx-X.X.tar.gz

ATTENTION ! Il faut prendre la version de SDL_gfx prévue pour la version 1.2 de SDL (il ne faut pas prendre SDL2_gfx qui est prévue pour SDL 2.0) !

Modifiez le configure.in en remplacant les lignes

    dnl Check for SDL
    AM_PATH_SDL($SDL_VERSION,
                :,
            AC_MSG_ERROR([*** SDL version $SDL_VERSION not found!])
    )
    CFLAGS="$CFLAGS $SDL_CFLAGS"
    # Remove dependencies from 'sdl-config' not meant for us libraries:
    SDL_LIBS=$(echo "$SDL_LIBS" |sed -e 's/-lmingw32//' -e 's/-lSDLmain//')
    LIBS="$LIBS $SDL_LIBS"

par les lignes

    SDL_CFLAGS="-I/Library/Frameworks/SDL.framework/Headers -framework SDL"
    SDL_LIBS="-framework SDL"
    CFLAGS="$CFLAGS $SDL_CFLAGS"
    LIBS="$LIBS $SDL_LIBS -framework SDL"

Reconfigurez la bibliothèque en exécutant la commande:

    cd SDL_gfx-X.X
    autoreconf --install

Finissez la compilation et l'installation de la bibliothèque en tapant les commandes suivantes:

    ./configure --prefix=$FAKEROOT --without-x
    make
    make install

### Installation de Doxygen

Téléchargez le code source de Doxygen, contenu dans le fichier doxygen-X.X.X.src.tar.gz situé sur le site : http://www.stack.nl/~dimitri/doxygen/download.html#latestsrc

Installez le paquet en tapant les commandes suivantes:

    cd $FAKEROOT/src
    tar -xzf doxygen-X.X.X.src.tar.gz
    cd doxygen-X.X.X
    ./configure --prefix $FAKEROOT
    make
    make install

## Installation de la bibliothèque MLV

Commencez par télécharger le code source de la bibliothèque MLV. Téléchargez la bibliothèque située à l'adresse : http://download.savannah.gnu.org/releases/mlv/mlv-1.2.1/mlv-1.2.1.tar.gz

Installez la bibliothèque en tapant les commandes suivantes:

    cd $FAKEROOT/src
    tar -xzf mlv-1.2.1.tar.gz
    cd mlv-1.2.1
    ./configure --prefix=$FAKEROOT libxml_LIBS=-lxml2 libxml_CFLAGS=-I/usr/include/libxml2
    make
    make install