diff --git a/README.md b/README.md index b95c594..6022729 100644 --- a/README.md +++ b/README.md @@ -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) + + + +