img

img esamina, ridimensiona e converte immagini web.

FileVersione 1.1.5Stabile
lil-terminal

Panoramica

img è un piccolo strumento per immagini web: ispeziona senza estensioni aggiuntive e, con GD o Imagick, ridimensiona o converte JPEG, PNG e WebP per file, directory, maschera o elenco.

Elaborare immagini in gruppo

Prova prima su un’immagine, poi passa alla cartella o all’elenco. L’originale non cambia senza -r.

Sintassi

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

Riferimento

img <file>

mostrare formato, dimensioni, tipo MIME e dimensione del file immagine

-s <size>

ridimensionare proporzionalmente; un numero limita il lato più lungo

-s <size> -w | -h

ridimensionare proporzionalmente in base alla larghezza o all’altezza scelta

-s <WxH>

ridimensionare alle dimensioni esatte <WxH>

-t <format>

convertire nel formato web jpg|png|webp

-q <1..100>

impostare la qualità di output; valore predefinito 85

-o <dst>

scrivere una singola immagine trasformata in una destinazione esplicita

-r

sostituire l’immagine sorgente dopo una trasformazione riuscita

-f [dir] [mask]

trasformare le immagini corrispondenti in una directory; per impostazione predefinita usa la directory corrente e *

< <list>

trasformare i percorsi immagine elencati, uno per riga, in un file di testo

File attivo

Con il core corrente, un file aperto correttamente diventa subito disponibile come $. Se questo modulo è il gestore installato con priorità più alta per l’estensione, basta digitare il nome del file per aprirlo con questo comando. Sono scorciatoie del core; img <file> resta la forma esplicita.

Sicurezza

Per impostazione predefinita una trasformazione crea accanto alla sorgente un file name.img.ext e rifiuta di sostituire una destinazione esistente. Usa -o per indicare una destinazione precisa oppure -r solo quando vuoi sostituire intenzionalmente la sorgente. La modalità batch non attraversa le sottodirectory in modo ricorsivo. Con -r il formato deve restare invariato; per convertirlo, ometti -r oppure usa -o.

Le trasformazioni richiedono file sorgente fino a 32 MiB e massimo 24 milioni di pixel in ingresso o uscita (16000 per lato). Lotti: 200 immagini; liste: 128 KiB. Serve GD o Imagick.

Anteprima interattiva del sandbox

Esegui gli esempi preparati direttamente nella pagina. I risultati sono predefiniti e mostrati nel browser; sul server non viene eseguito alcun comando del terminale.

Controllare un’immagine nella directory corrente

Installa e gestisci

Installa la versione compatibile corrente. Scegli Base per tutte le funzioni o Minimum per il pacchetto ridotto; usa upgrade per aggiornare un modulo già installato.

Base e Minimum sono due pacchetti della stessa release corrente del modulo.

Pacchetto Base

Installa il pacchetto completo con riferimento locale e tutte le modalità pubblicate.

install img
Pacchetto Minimum

Installa il pacchetto ridotto. Il riferimento locale è omesso; help <cmd> -i apre il riferimento server corrente.

install img -m
Versione pubblica esatta

Installa esattamente questa versione pubblicata.

install img -v 1.1.5
Controlla o aggiorna

upgrade controlla la compatibilità e sostituisce il blocco solo quando serve.

upgrade img
Rimuovi modulo

Rimuove il blocco estensione senza toccare core e altri moduli.

install img -u

Esempi

Gli esempi sono copiabili ma il sito non li esegue. Controlla percorsi, permessi e opzioni distruttive.

Controllare un’immagine nella directory corrente
img \sandbox\images\photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
Ridimensionare proporzionalmente; un numero limita il lato più lungo
img \sandbox\images\photo.jpg -s 24
photo.jpg > photo.img.jpg
Ridimensionare proporzionalmente in base alla larghezza o all’altezza scelta
img \sandbox\images\photo.jpg -s 24 -w
photo.jpg > photo.img.jpg
Ridimensionare proporzionalmente in base alla larghezza o all’altezza scelta
img \sandbox\images\photo.jpg -s 24 -h
photo.jpg > photo.img.jpg
Ridimensionare alle dimensioni esatte <WxH>
img \sandbox\images\photo.jpg -s 32x20
photo.jpg > photo.img.jpg
Convertire nel formato web jpg|png|webp
img \sandbox\images\photo.jpg -t webp -q 82
photo.jpg > photo.img.webp
Scrivere una singola immagine trasformata in una destinazione esplicita
img \sandbox\images\photo.jpg -s 24 -o \sandbox\images\thumb.jpg
photo.jpg > thumb.jpg
Sostituire l’immagine sorgente dopo una trasformazione riuscita
img \sandbox\images\photo.jpg -s 24 -r
photo.jpg > photo.jpg
Trasformare le immagini corrispondenti in una directory; per impostazione predefinita usa la directory corrente e *
img -f \sandbox\images "*.jpg" -s 24 -t webp
photo.jpg > photo.img.webp
product.jpg > product.img.webp
Trasformare i percorsi immagine elencati, uno per riga, in un file di testo
img -s 24 < \sandbox\images\images.txt
photo.jpg > photo.img.jpg
product.jpg > product.img.jpg
Mostrare formato, dimensioni, tipo MIME e dimensione del file immagine
img \sandbox\images\missing.jpg
File non trovato
Trasformare le immagini corrispondenti in una directory; per impostazione predefinita usa la directory corrente e *
img -f \sandbox\images "*.jpg"
Resize or output format required

File usato in questo esempio: sandbox/images/photo.jpg

L’esempio usa un file o una directory dell’area di documentazione protetta /sandbox/.

[binary file: photo.jpg]

Documentazione correlata

Come vengono protette le operazioni sul file system? →Perché file grandi e output estesi sono limitati? →

Versione pubblica attuale

v1.1.52026-11-01

Rifinitura di produzione

Versione stabile attuale di img. img esamina, ridimensiona e converte immagini web.

# Cronologia versioni