guide-imagemagick-ffmpeg/README.md
2019-02-26 11:21:02 -05:00

301 lines
No EOL
10 KiB
Markdown

# Manipulation d'image et de vidéo à l'aide d'outils en ligne de commandes et de scripts
## Introduction
Pourquoi utiliser la ligne de commande pour manipuler des images ou des vidéos ?
![](flickr/47151962531_9b9c400b47_z.jpg)
"[Girl blowing question marks...](https://www.flickr.com/photos/79157069@N03/47151962531/)" ([CC BY 2.0](https://creativecommons.org/licenses/by/2.0/)) by [Matthew Paul Argall](https://www.flickr.com/people/79157069@N03/)
## Introduction
- Télécharger des images ou des vidéos depuis une page web
- Pour pouvoir effectuer des traitements massifs sur des images
- Ajout d'un logo sur des photos
- Redimensionnement
- Conversion dans un autre format de fichier
- Application de filtres
- Mosaique
- Pour créer des animations gif
- Extraire une section d'un vidéo
- Pour faire un montage de plusieurs vidéos
- Héberger une image sur un serveur d'images libre
## Les outils
### GNU Wget
GNU Wget est un client pour les protocoles FTP, HTTP et HTTPS. Il est entre autre utile pour extraire toutes les images d'un certain format d'une page web. Il est disponible sous la licence GPL.
- [Site officiel]()
### ExifTool
ExifTool est un logiciel qui permet de manipuler les métadonnées dans des fichiers images. L'installation ne se fait pas par un gestionnaires de paquets, mais en suivant les instructions sur le site web.
- [Site Officiel](https://www.sno.phy.queensu.ca/~phil/exiftool/)
### CSVKit
CSVKit est un ensemble d'outils qui permettent d'effectuer des opérations sur des fichiers de données au format CSV.
- [Site officiel](https://csvkit.readthedocs.io/en/1.0.3/)
Nous l'utiliserons pour extraire des informations pertinentes depuis les fichiers de sortie de ExifTool
### ImageMagick
Imagemagick sert à créer, modifier, composer et convertir des images matricielles (bitmaps). C'est un logiciel libre sous une licence permissive de type [BSD 2Clause](https://spdx.org/licenses/BSD-2-Clause.html)
- [Site officiel](http://www.imagemagick.org/)
### FFmpeg
FFmpeg permet d'enregistrer, de convertir, de diffuser de l'audio et de la vidéo. Il est disponible sous la licence LGPL.
- [Site officiel](https://ffmpeg.org/legal.html)
### Inkscape
Inkscape est un logiciel bien connu pour éditer graphiquement des images vectorielles. Mais, il est aussi possible de l'utiliser depuis la ligne de commande.
- [Site officiel](https://inkscape.org/)
## Scénarios
Comme ces outils sont très polyvalents et comprennent de nombreux paramètres et fonctionnalités, nous allons nous concentrer sur un certain nombre de scénarios à réaliser
-
## Scénario 1
Dans ce scénario, nous allons télécharger les images d'une page web, les redimensionner, créer une mosaique et la publier en ligne sur un serveur d'image libre [Lutim](https://framagit.org/fiat-tux/hat-softwares/lutim).
Nous allons créer une mosaique de corneilles à partir des photos de la page [Animalphotos.info](http://animalphotos.info/a/topics/animals/birds/crows/)
### Téléchargement
Nous allons utiliser Wget pour télécharger les images
```bash
wget -P photos_corneille/ -nd -p -H -A jpg \
http://animalphotos.info/a/topics/animals/birds/crows/
```
Les différentes options se définissent comme suit:
- `-P photos_corneille/` télécharge les fichiers dans le répertoire `photos_corneille`;
- `-nd` ne crée pas de hiérarchie de répertoires;
- `-p` télécharge tous les fichiers dépendants de la page;
- `-H` télécharge les fichiers même s'ils sont hébergés ailleurs (dans notre cas, ils sont hébergés sur Flickr);
- `-A jpg` télécharge seulement les fichiers qui ont l'extension `.jpg`;
- Enfin, on spécifie l'URL de la page
### Caractéristiques des images téléchargées
On peut facilement lister les caractéristiques des images téléchargées dans un fichier CSV en utilisant la commande suivante
```bash
exiftool -ImageWidth -ImageHeight -csv photos_corneille \
> exif_photo_corneille.csv
```
Nous voulons ensuite obtenir la largeur et la hauteur minimale des images pour créer notre mosaique
```bash
dims=`csvsql --query "SELECT min(ImageWidth), min(ImageHeight) from exif_photo_corneille" exif_photo_corneille.csv | sed '2q;d'`
minImageWidth=$(cut -d',' -f1 <<< "$dims")
minImageHeight=$(cut -d',' -f2 <<< "$dims")
```
### Redimensionnement
Nous allons maintenant redimensioner nos images dans un rectangle ayant les dimensions respectives de `minImageWidth` par `minImageHeight`
```bash
echo "Largeur: $minImageWidth\nHauteur:$minImageHeight"
```
C'est ici qu'on utilise la commande convert d'ImageMagick
La première utilisation permet de convertir l'image en un seul pixel, ce qui permet de retrouver la couleur "moyenne" de l'image, que l'on va utiliser comme couleur d'arrière-plan `mainColor` pour l'image redimensionnée
La seconde utilisation permet d'effectuer la conversion de l'image selon les dimensions identifiées précédemment. L'image redimensionnée est centrée `-gravity center` dans le canevas de dimension spécifiées par `-extent` avec un arrière plan de couleur `mainColor`
```bash
for i in $(find photos_corneille -type f)
do
myFilename=$(basename -- "$i")
mainColor=`convert "$i" +dither -colors 1 -unique-colors -format "%f\n%c\n" txt: | sed -r -n 's/^.*(\#[A-F0-9]{6}).*$/\1/p'`
convert "$i" \
-resize ${minImageWidth}x${minImageHeight} \
-background $mainColor \
-gravity center \
-extent ${minImageWidth}x${minImageHeight} \
"resize_photos_corneille/resize_${myFilename}"
done
```
### Mosaique
Nous sommes maintenant prêts à créer une mosaique. Comme nous avons 20 images, nous creerons une mosaique d'une largeur de 5 images et d'une hauteur de 4 images.
```bash
montage resize_photos_corneille/* \
-tile 5x4 \
-mode Concatenate montage_photos_corneille/montage.jpg
```
![montage.jpg](montage_photos_corneille/montage.jpg)
### Chargement sur un hébergeur d'images en ligne Lutim
On peut charger l'image générée sur un hébergeur d'image en ligne Lutim. Pour ce faire, on utilise le client HTTP cURL et l'API REST de Lutim.
```bash
curl -F "format=json" -F "file=@montage_photos_corneille/montage.jpg" https://francoispelletier.org/lutim
```
On reçoit une réponse en JSON comme suit:
```json
{
"msg": {
"created_at": 1550955875,
"del_at_view": false,
"ext": "jpg",
"filename": "montage.jpg",
"limit": 0,
"real_short": "Ux46pjrt",
"short": "Ux46pjrt\\/rauu3q7P",
"thumb": null,
"token": "lWsOFhIqRYgLNA6ZbxKLXvFF"
},
"success": true
}
```
L'url de la photo est, dans ce cas
[https://francoispelletier.org/lutim/Ux46pjrt/rauu3q7P](https://francoispelletier.org/lutim/Ux46pjrt/rauu3q7P)
## Scénario 2
Dans ce scénario, nous allons animer une séquence d'images vectorielles, ajouter un logo et la joindre à un court extrait vidéo.
Nous avons 9 images qui épellent le mot **Bienvenue**
```bash
for i in animation_bienvenue/*.svg; do echo "$i"; done
```
```
animation_bienvenue/bienvenue001.svg
animation_bienvenue/bienvenue002.svg
animation_bienvenue/bienvenue003.svg
animation_bienvenue/bienvenue004.svg
animation_bienvenue/bienvenue005.svg
animation_bienvenue/bienvenue006.svg
animation_bienvenue/bienvenue007.svg
animation_bienvenue/bienvenue008.svg
animation_bienvenue/bienvenue009.svg
```
Voici la 5e image
![](animation_bienvenue/bienvenue005.svg)
### Conversion
Pour convertir les les images vectorielles en images matricielles, nous allons utiliser l'interface en ligne de commandes de Inkscape
```bash
for i in animation_bienvenue/*.svg
do
inkscape -f "$i" -e "${i%.*}.png"
done
```
Voici la 5e image au format png
![](animation_bienvenue/bienvenue005.png)
### Ajout du logo
Nous ajouterons le logo de LinuQ aux images
![](animation_bienvenue/logo-linuq.png)
Pour ce faire, nous utiliserons l'option `-draw` de `convert` pour ajouter une image à la position désirée. Notez que pour nos besoins, l'image du logo est déjà redimensionnée à la largeur désirée.
```
for i in animation_bienvenue/bienvenue*.png
do
convert "$i" -gravity south -draw "image over 0,0 0,0 animation_bienvenue/logo-linuq.png" "${i%.*}-aveclogo.png"
done
```
Les paramètres suivants permettent de définir la transformation
- `-gravity south`: aligne les transformations au bas de l'image
- `image over 0,0 0,0`: Positionne l'image ajoutée au coin inférieur gauche
Nous obtenons alors, pour la 5e image:
![](animation_bienvenue/bienvenue005-aveclogo.png)
### Animation
Nous avons maintenant des images au format `png` pour faire notre animation. Nous utiliserons ImageMagick pour créer une animation au format `gif`.
```bash
convert -delay 50 -loop 0 animation_bienvenue/bienvenue*-aveclogo.png animation_bienvenue/animation.gif
```
Les paramètres suivants permettent de définir l'animation
- `-delay 50`: Ajoute un délai de 50/100 secondes entre les images
- `-loop 0`: Crée une boucle d'animation
Nous obtenons alors cette animation
![](animation_bienvenue/animation.gif)
### Téléchargement du vidéo
Nous allons ajouter un vidéo en arrière plan à notre animation
Téléchargement du vidéo
```bash
wget https://videos.pond5.com/automatic-data-processing-machine-footage-044586354_main_xl.mp4 -O video/automatic-data-processing-machine-footage-044586354_main_xl.mp4
```
### Animation en MP4
Création de l'animation **Bienvenue** avec le logo de LinuQ au format MP4
```bash
ffmpeg -framerate 3 -i animation_bienvenue/bienvenue%03d-aveclogo.png -vcodec png video/animation-linuq.mov
```
Les paramètres suivants permettent de définir l'animation
- `-framerate 3`: 3 images par seconde
- `-vcodec png`: codec utilisé: png (pour grader la transparence)
### Superposition de l'animation au vidéo
Superposition des deux vidéos avec FFmpeg:
```bash
ffmpeg -i video/automatic-data-processing-machine-footage-044586354_main_xl.mp4 -i video/animation-linuq.mov -filter_complex "overlay=(W-w)/2:(H-h)/2" -pix_fmt rgba -vcodec h264 video/animation-final.mp4
```
Les paramètres suivants permettent de définir l'animation
- `-filter_complex "overlay=(W-w)/2:(H-h)/2"`: permet d'aligner les deux vidéos au centre du plus grand des deux
- `-pix_fmt rgba`: permet de garder le profil de couleur transparent
- `-vcodec h264`: Encoder avec le codec `h264` qui est très performant
Le résultat:
[video/animation-final.mp4](video/animation-final.mp4)