img

img inspeciona, redimensiona e converte imagens para a web.

ArquivosVersão 1.1.5Estável
lil-terminal

Visão geral

img é uma ferramenta pequena para imagens da web: inspeciona sem extensões extras e, com GD ou Imagick, redimensiona ou converte JPEG, PNG e WebP por arquivo, diretório, máscara ou lista.

Processar imagens em lote

Teste primeiro em uma imagem antes de processar uma pasta ou lista. O original não muda sem -r.

Sintaxe

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

Referência

img <file>

mostrar informações da imagem

-s <size>

redimensionar proporcionalmente; um número limita o lado maior

-s <size> -w | -h

redimensionar proporcionalmente pela largura ou altura escolhida

-s <WxH>

redimensionar para dimensões exatas <WxH>

-t <format>

converter para formato web: jpg|png|webp

-q <1..100>

definir a qualidade da saída; padrão 85

-o <dst>

gravar uma imagem transformada em um destino explícito

-r

substituir a imagem de origem após uma transformação bem-sucedida

-f [dir] [mask]

transformar imagens correspondentes em um diretório; diretório atual e * por padrão

< <list>

transformar caminhos de imagens listados um por linha em um arquivo de texto

Arquivo ativo

Com o core atual, um arquivo aberto com sucesso passa a ficar disponível imediatamente como $. Se este módulo for o manipulador instalado de maior prioridade para a extensão, basta digitar o nome do arquivo para abri-lo por este comando. Esses são atalhos do core; img <file> continua sendo a forma explícita.

Segurança

Por padrão a transformação cria um arquivo vizinho name.img.ext e recusa substituir um destino existente. Use -o para uma saída explícita ou -r somente para substituir a origem conscientemente. O modo em lote não percorre subdiretórios. Com -r, o formato da imagem deve permanecer igual; para converter o formato, omita -r ou use -o.

Transformações aceitam até 32 MiB de entrada e 24 milhões de pixels na origem ou saída (16000 por lado). Lotes: 200 imagens; listas: 128 KiB. GD ou Imagick é necessário.

Prévia interativa do sandbox

Execute os exemplos preparados diretamente na página. Os resultados são predefinidos e exibidos no navegador; nenhum comando do terminal é executado no servidor.

Inspecionar uma imagem no diretório atual

Instalar e gerenciar

Instale a versão compatível atual. Escolha Base para o conjunto completo de recursos ou Minimum para o pacote reduzido; use upgrade para atualizar um módulo já instalado.

Base e Minimum são dois pacotes da mesma versão atual do módulo.

Pacote Base

Instala o pacote completo com referência local e todos os modos publicados.

install img
Pacote Minimum

Instalar o pacote reduzido. A referência local é omitida; help <cmd> -i abre a referência atual do servidor.

install img -m
Versão pública exata

Instalar exatamente esta versão publicada.

install img -v 1.1.5
Verificar ou atualizar

upgrade verifica compatibilidade e substitui o bloco somente quando necessário.

upgrade img
Remover módulo

Remove o bloco da extensão sem afetar o núcleo ou outros módulos.

install img -u

Exemplos

Os exemplos podem ser copiados, mas o site não os executa. Revise caminhos, permissões e opções destrutivas.

Inspecionar uma imagem no diretório atual
img \sandbox\images\photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
Redimensionar proporcionalmente; um número limita o lado maior
img \sandbox\images\photo.jpg -s 24
photo.jpg > photo.img.jpg
Redimensionar proporcionalmente pela largura ou altura escolhida
img \sandbox\images\photo.jpg -s 24 -w
photo.jpg > photo.img.jpg
Redimensionar proporcionalmente pela largura ou altura escolhida
img \sandbox\images\photo.jpg -s 24 -h
photo.jpg > photo.img.jpg
Redimensionar para dimensões exatas <WxH>
img \sandbox\images\photo.jpg -s 32x20
photo.jpg > photo.img.jpg
Converter para formato web: jpg|png|webp
img \sandbox\images\photo.jpg -t webp -q 82
photo.jpg > photo.img.webp
Gravar uma imagem transformada em um destino explícito
img \sandbox\images\photo.jpg -s 24 -o \sandbox\images\thumb.jpg
photo.jpg > thumb.jpg
Substituir a imagem de origem após uma transformação bem-sucedida
img \sandbox\images\photo.jpg -s 24 -r
photo.jpg > photo.jpg
Transformar imagens correspondentes em um diretório; diretório atual e * por padrão
img -f \sandbox\images "*.jpg" -s 24 -t webp
photo.jpg > photo.img.webp
product.jpg > product.img.webp
Transformar caminhos de imagens listados um por linha em um arquivo de texto
img -s 24 < \sandbox\images\images.txt
photo.jpg > photo.img.jpg
product.jpg > product.img.jpg
Mostrar informações da imagem
img \sandbox\images\missing.jpg
Arquivo não encontrado
Transformar imagens correspondentes em um diretório; diretório atual e * por padrão
img -f \sandbox\images "*.jpg"
Resize or output format required

Arquivo usado neste exemplo: sandbox/images/photo.jpg

O exemplo usa um arquivo ou diretório do espaço protegido de documentação /sandbox/.

[binary file: photo.jpg]

Documentação relacionada

Como as operações no sistema de arquivos são protegidas? →Por que arquivos grandes e saídas extensas são limitados? →

Versão pública atual

v1.1.52026-11-01

Refinamento de produção

Versão estável atual de img. img inspeciona, redimensiona e converte imagens para a web.

# Histórico de versões