img

img affiche, redimensionne et convertit les images Web.

FichiersVersion 1.1.5Stable
lil-terminal

Vue d’ensemble

img est un petit atelier pour les images web : inspection sans extension supplémentaire, puis redimensionnement ou conversion JPEG, PNG et WebP avec GD ou Imagick, par fichier, dossier, masque ou liste.

Traiter des images par lot

Testez d’abord sur une image avant un lot. L’original reste inchangé sans -r explicite.

Syntaxe

lil-terminal
img <file> [options] · img -f [dir] [mask] [options] · img [options] < <list>

Référence

img <file>

afficher les informations de l’image

-s <size>

redimensionner proportionnellement ; un nombre limite le côté le plus long

-s <size> -w | -h

redimensionner proportionnellement selon la largeur ou la hauteur choisie

-s <WxH>

redimensionner aux dimensions exactes <WxH>

-t <format>

convertir vers un format web : jpg|png|webp

-q <1..100>

définir la qualité de sortie ; 85 par défaut

-o <dst>

écrire une image transformée vers une destination explicite

-r

remplacer l’image source après une transformation réussie

-f [dir] [mask]

transformer les images correspondantes d’un répertoire ; répertoire courant et * par défaut

< <list>

transformer les chemins d’images listés ligne par ligne dans un fichier texte

Fichier actif

Avec le core actuel, tout fichier ouvert avec succès devient immédiatement disponible sous $. Si ce module est le gestionnaire installé prioritaire pour l’extension, saisir uniquement le nom du fichier suffit à l’ouvrir avec cette commande. Ces raccourcis appartiennent au core ; img <file> reste la forme explicite.

Sécurité

Par défaut, une transformation crée un fichier voisin name.img.ext et refuse d’écraser une destination existante. Utilisez -o pour une sortie explicite ou -r uniquement pour remplacer la source. Le mode lot ne parcourt pas les sous-répertoires. Avec -r, le format de l’image doit rester identique ; pour convertir le format, omettez -r ou utilisez -o.

La transformation est limitée à 32 Mio en entrée et 24 millions de pixels en source ou sortie (16000 par côté). Lots : 200 images ; listes : 128 Kio. GD ou Imagick est nécessaire pour transformer.

Aperçu interactif du sandbox

Lancez les exemples préparés directement sur la page. Les résultats sont prédéfinis et affichés dans le navigateur ; aucune commande terminal n’est exécutée sur le serveur.

Inspecter une image du répertoire courant

Installer et gérer

Installez la version compatible actuelle. Choisissez Base pour l’ensemble complet des fonctions ou Minimum pour le paquet réduit ; utilisez upgrade pour mettre à jour un module déjà installé.

Base et Minimum sont deux paquets de la même version actuelle du module.

Paquet Base

Installer le paquet complet avec référence locale et tous les modes publiés.

install img
Paquet Minimum

Installer le paquet réduit. La référence locale est omise ; help <cmd> -i ouvre la référence serveur actuelle.

install img -m
Version publique exacte

Installer exactement cette version publiée.

install img -v 1.1.5
Vérifier ou mettre à jour

upgrade vérifie la compatibilité et remplace le bloc seulement si nécessaire.

upgrade img
Supprimer le module

Supprimer le bloc d’extension sans toucher au noyau ni aux autres modules.

install img -u

Exemples

Les exemples sont copiables mais ne sont pas exécutés par le site. Vérifiez chemins, droits et options destructrices.

Inspecter une image du répertoire courant
img \sandbox\images\photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
Redimensionner proportionnellement ; un nombre limite le côté le plus long
img \sandbox\images\photo.jpg -s 24
photo.jpg > photo.img.jpg
Redimensionner proportionnellement selon la largeur ou la hauteur choisie
img \sandbox\images\photo.jpg -s 24 -w
photo.jpg > photo.img.jpg
Redimensionner proportionnellement selon la largeur ou la hauteur choisie
img \sandbox\images\photo.jpg -s 24 -h
photo.jpg > photo.img.jpg
Redimensionner aux dimensions exactes <WxH>
img \sandbox\images\photo.jpg -s 32x20
photo.jpg > photo.img.jpg
Convertir vers un format web : jpg|png|webp
img \sandbox\images\photo.jpg -t webp -q 82
photo.jpg > photo.img.webp
Écrire une image transformée vers une destination explicite
img \sandbox\images\photo.jpg -s 24 -o \sandbox\images\thumb.jpg
photo.jpg > thumb.jpg
Remplacer l’image source après une transformation réussie
img \sandbox\images\photo.jpg -s 24 -r
photo.jpg > photo.jpg
Transformer les images correspondantes d’un répertoire ; répertoire courant et * par défaut
img -f \sandbox\images "*.jpg" -s 24 -t webp
photo.jpg > photo.img.webp
product.jpg > product.img.webp
Transformer les chemins d’images listés ligne par ligne dans un fichier texte
img -s 24 < \sandbox\images\images.txt
photo.jpg > photo.img.jpg
product.jpg > product.img.jpg
Afficher les informations de l’image
img \sandbox\images\missing.jpg
Fichier introuvable
Transformer les images correspondantes d’un répertoire ; répertoire courant et * par défaut
img -f \sandbox\images "*.jpg"
Resize or output format required

Fichier utilisé dans cet exemple: sandbox/images/photo.jpg

L’exemple utilise un fichier ou un répertoire de l’espace de documentation protégé /sandbox/.

[binary file: photo.jpg]

Documentation associée

Comment les opérations sur les fichiers sont-elles protégées ? →Pourquoi les gros fichiers et les longues sorties sont-ils limités ? →

Version publique actuelle

v1.1.52026-11-01

Affinage de production

Version stable actuelle de img. img affiche, redimensionne et convertit les images Web.

# Historique des versions