Documentation de la librairie MLV

Sommaire

1. Présentation

La librairie MLV est une librairie multimedia simplifiée. Cette librairie convient parfaitement aux étudiants qui débutent dans la programmation en C et qui souhaitent ajouter des effets graphiques et sonores dans leurs programmes. La librairie permet de:

Ces outils sont des interfaces simplifiées de la librairie SDL. Si vous n'êtes pas débutant, nous vous recommandons d'utiliser plutôt les librairies SDL (SDL, SDL_gfx, SDL_sound, SDL_ttf) au lieu de la librairies MLV. La librairie est portable, elle peut donc être compilée et exécutée sous Linux, Macintosh et Windows.

2. Télécharger la librairie MLV

La dernière version stable de la librairie est la version 0.4.

La librairie MLV est diponible sous plusieurs formats et pour différentes plate-formes:

3. Installation la librairie MLV

3.1. Installer MLV sous Linux

3.1.1. Debian et Ubuntu

Commencez par installer les librairies sdl, sdl-gfx, sdl-sound, sdl-ttf et glib2.0 en tapant la commande suivante:

sudo apt-get install libsdl-gfx1.2-dev libsdl1.2-dev libsdl-sound1.2-dev 
libsdl-ttf2.0-dev libglib2.0-dev

Téléchargez ensuite les paquets de la librairie :

et installez-les en tapant la commande suivante:

sudo dpkg -i libmlv-0.4-dev_0-1_i386.deb libmlv-0.4_0-1_i386.deb

La librairie MLV est installée.

N'oubliez pas que pour compiler vos programme, il vous faut les outils de compilation. Si vous n'avez pas encore installé ces outils, tapez la commande suivante:

sudo apt-get install build-essential

3.1.3. Fedora

Commencez par télécharger les paquets de la librairie à l'adresse:

et installez-les en tapant la commande suivante:

su
yum update
rpm --import RPM-GPG-KEY-Boussicault
yum install mlv-0.4-0.fc12.i386.rpm 
yum install mlv-devel-0.4-0.fc12.i386.rpm 
yum install mlv-static-0.4-0.fc12.i386.rpm
exit

La librairie MLV est installée.

3.1.5. À partir du code source

Avant de commencer à compiler et installer la librairie MLV,il faut que vous vérifiez que vous avez les librairies de développement et les programmes suivants correctement installés:

Téléchargez le code source de la librairie MLV : mlv-0.4.tar.gz.

Décompressez le code en tapant la commande suivante :

tar -xzf mlv-0.4.tar.gz

Installez la librairie en tapant les commandes suivantes:

cd mlv-0.4
./configure --prefix=/usr
make
sudo make install

Voilà, la librairie est installée.

4. Compiler un programme avec la librairie MLV

4.1. Options de compilation pour gcc

La libraire MLV est compatible avec les outils de pkg-config. Vous pouvez donc récupérer les différentes options de compilation en tapant les commandes suivantes:

Ainsi, si vous avez écrit un programme demo.c, vous pouvez le compiler en tapant la commande suivante:

gcc -Wall `pkg-config --cflags MLV` `pkg-config --libs MLV` demo.c

4.2. Compilation simplifiée avec un makefile

Vous pouvez aussi utiliser le makefile suivant, en modifiant le champs TARGET pour mettre le nom de vos différents programmes.

TARGETS = programme1 programme2 programme3

##########################################################

LDFLAGS = `pkg-config --libs MLV`
CFLAGS = -g -O2 -Wall `pkg-config --cflags MLV`
LDLIBS = `pkg-config --libs-only-l MLV`


all: $(TARGETS)

clean:
	-rm -rf $(TARGETS)

4.3. Compilation avancée avec un makefile

Vous pouvez aussi utilisez le makefile suivant, en modifiant les champs TARGET et OBJECTS pour mettre le nom de votre programme.

#
# Mettre ici le nom de votre programme 
# (il faut que dans les OBJECT il y ai un objet de même nom que celui de TARGET
#
TARGET= main

#
# Mettre ic l'ensemble des fichier objet nécessaire aux programmes 
# (les fichier peuvent se situer dans des repertoires)
#
OBJECTS=  main.o affiche.o

#
# Mettre ici vos options de compilation
#
CFLAGS= -DDEBUG -g -Wall `pkg-config --cflags MLV`

#
# Mettre ici les options qui devront ére pasé à l'éditeur de lien
#
LDFLAGS=`pkg-config --libs MLV`

#
# Mettre ici les nom des librairies et les répertoires ou elles se trouvent.
# par exemple (-lpthread ou -L/directory)
#
LDLIBS=`pkg-config --libs-only-l MLV`

 
###############################################################################

DEPENDS=$(OBJECTS:.o=.d)
INCLUDE_DEPENDS=$(foreach i,$(DEPENDS),$(wildcard $(i)))
 
all: $(TARGET)
 
$(TARGET): $(DEPENDS) $(OBJECTS)
	$(CC) -o $@ $(LDFLAGS) $(OBJECTS) $(LDLIBS)
 
%.d:%.c
	$(CC) -M $(CFLAGS) -MT '$(shell echo "$<" | sed 's,\($*\)\.c,\1.o $@,' )'  $< > $@
 
include $(INCLUDE_DEPENDS)
 
clean:
	-rm -f $(TARGET)
	-rm -f $(OBJECTS)
	-rm -f $(DEPENDS)

5. Trouver de la documentation sur la librairie

5.1. Connaître les prototypes et le fonctionnement des fonctions proposées par MLV

Une fois que vous avez terminé d'installer la librairie, un ensemble d'exemples est disponible dans le répertoire: /usr/share/doc/mlv/examples. Les démonstrations proposées sont classées en trois niveaux : débutant, moyen, avancé. Les programmes montrent différentes façon d'utiliser la librairie MLV. Le code source de ces démonstrations contiennent une documentation détaillée des fonctions utilisées.

Il est possible d'obtenir une documentation complète de tous les protoypes des fonctions disponnibles dans la librairie MLV en tapant la commande suivante:

man MLV_all.h

Cette commande vous fera ouvrir une page de manuel qui est un sommaire vers d'autres pages de manuels comme (MLV_color.h, MLV_image.h, etc ...).

5.2. Créer des paquets distribuables de la librairie MLV

La documentation pour pour créer des paquets distribuables de la librairie MLV peux se trouver :