img

img inspecciona, redimensiona y convierte imágenes web.

ArchivosVersión 1.1.5Estable
lil-terminal

Resumen

img es una herramienta compacta para imágenes web: inspecciona sin extensiones adicionales y, con GD o Imagick, redimensiona o convierte JPEG, PNG y WebP por archivo, directorio, máscara o lista.

Procesar imágenes por lotes

Prueba primero con una imagen y después procesa la carpeta o lista. El original no cambia sin -r.

Sintaxis

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

Referencia

img <file>

mostrar información de la imagen

-s <size>

redimensionar proporcionalmente; un número limita el lado mayor

-s <size> -w | -h

redimensionar proporcionalmente por ancho o alto elegido

-s <WxH>

redimensionar a dimensiones exactas <WxH>

-t <format>

convertir a formato web: jpg|png|webp

-q <1..100>

definir la calidad de salida; 85 de forma predeterminada

-o <dst>

escribir una imagen transformada en un destino explícito

-r

reemplazar la imagen de origen tras una transformación correcta

-f [dir] [mask]

transformar imágenes coincidentes de un directorio; por defecto el directorio actual y *

< <list>

transformar rutas de imágenes listadas una por línea en un archivo de texto

Archivo activo

Con el core actual, un archivo abierto correctamente queda disponible de inmediato como $. Si este módulo es el controlador instalado con mayor prioridad para la extensión, basta escribir el nombre del archivo para abrirlo con este comando. Son comodidades del core; img <file> sigue siendo la forma explícita.

Seguridad

Por defecto se crea un archivo vecino name.img.ext y no se reemplaza un destino existente. Use -o para una salida explícita o -r solo cuando quiera reemplazar el origen. El modo por lotes no recorre subdirectorios. Con -r el formato de imagen debe permanecer igual; para convertir a otro formato, omita -r o use -o.

Las transformaciones de imagen admiten como máximo 32 MiB de entrada y 24 millones de píxeles de origen o destino (16000 por lado). Lotes: 200 imágenes; archivos de lista: 128 KiB. Se requiere GD o Imagick.

Vista interactiva del sandbox

Ejecuta los ejemplos preparados directamente en la página. Los resultados están predefinidos y se muestran en el navegador; no se ejecuta ningún comando de terminal en el servidor.

Inspeccionar una imagen del directorio actual

Instalar y administrar

Instala la versión compatible actual. Elige Base para el conjunto completo de funciones o Minimum para el paquete reducido; usa upgrade para actualizar un módulo ya instalado.

Base y Minimum son dos paquetes de la misma versión actual del módulo.

Paquete Base

Instala el paquete completo con referencia local y todos los modos publicados.

install img
Paquete Minimum

Instalar el paquete reducido. No incluye la referencia local; help <cmd> -i abre la referencia actual del servidor.

install img -m
Versión pública exacta

Instalar exactamente esta versión publicada.

install img -v 1.1.5
Comprobar o actualizar

upgrade comprueba la compatibilidad y sustituye el bloque solo cuando hace falta.

upgrade img
Eliminar módulo

Elimina el bloque de extensión sin tocar el núcleo ni otros módulos.

install img -u

Ejemplos

Los ejemplos se pueden copiar, pero el sitio no los ejecuta. Revisa rutas, permisos y opciones destructivas.

Inspeccionar una imagen del directorio actual
img \sandbox\images\photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
Redimensionar proporcionalmente; un número limita el lado mayor
img \sandbox\images\photo.jpg -s 24
photo.jpg > photo.img.jpg
Redimensionar proporcionalmente por ancho o alto elegido
img \sandbox\images\photo.jpg -s 24 -w
photo.jpg > photo.img.jpg
Redimensionar proporcionalmente por ancho o alto elegido
img \sandbox\images\photo.jpg -s 24 -h
photo.jpg > photo.img.jpg
Redimensionar a dimensiones exactas <WxH>
img \sandbox\images\photo.jpg -s 32x20
photo.jpg > photo.img.jpg
Convertir a formato web: jpg|png|webp
img \sandbox\images\photo.jpg -t webp -q 82
photo.jpg > photo.img.webp
Escribir una imagen transformada en un destino explícito
img \sandbox\images\photo.jpg -s 24 -o \sandbox\images\thumb.jpg
photo.jpg > thumb.jpg
Reemplazar la imagen de origen tras una transformación correcta
img \sandbox\images\photo.jpg -s 24 -r
photo.jpg > photo.jpg
Transformar imágenes coincidentes de un directorio; por defecto el directorio actual y *
img -f \sandbox\images "*.jpg" -s 24 -t webp
photo.jpg > photo.img.webp
product.jpg > product.img.webp
Transformar rutas de imágenes listadas una por línea en un archivo de texto
img -s 24 < \sandbox\images\images.txt
photo.jpg > photo.img.jpg
product.jpg > product.img.jpg
Mostrar información de la imagen
img \sandbox\images\missing.jpg
Archivo no encontrado
Transformar imágenes coincidentes de un directorio; por defecto el directorio actual y *
img -f \sandbox\images "*.jpg"
Resize or output format required

Archivo usado en este ejemplo: sandbox/images/photo.jpg

El ejemplo usa un archivo o directorio del espacio protegido de documentación /sandbox/.

[binary file: photo.jpg]

Documentación relacionada

¿Cómo se protegen las operaciones del sistema de archivos? →¿Por qué se limitan los archivos grandes y la cantidad de salida? →

Versión pública actual

v1.1.52026-11-01

Refinamiento de producción

Versión estable actual de img. img inspecciona, redimensiona y convierte imágenes web.

# Historial de versiones