tutoriel et scénario 1

This commit is contained in:
François Pelletier 2019-02-23 16:15:29 -05:00
parent 46ee6a74d1
commit 0291bf24b7

142
README.md
View file

@ -20,9 +20,30 @@ Pourquoi utiliser la ligne de commande pour manipuler des images ou des vidéos
- 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)
@ -40,3 +61,124 @@ FFmpeg permet d'enregistrer, de convertir, de diffuser de l'audio et de la vidé
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)