img

查看图像信息,并批量调整 JPEG、PNG 和 WebP 的尺寸、格式与质量。

文件版本 1.1.4稳定
lil-terminal

概览

img 是面向 Web 图片的小型工具:无需额外扩展即可查看图片信息;若有 GD 或 Imagick,则可按单文件、目录、掩码或文件列表缩放和转换 JPEG、PNG、WebP。

批量处理图像

批量处理图片前先在单个文件上验证转换,再把同样的尺寸、格式和质量规则应用到目录或列表。

语法

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

参考

img <file>

显示图像信息

-s <size>

按比例调整大小;单个数字限制最长边

-s <size> -w | -h

按指定宽度或高度等比例调整

-s <WxH>

调整为精确尺寸 <WxH>

-t <format>

转换为 Web 格式:jpg|png|webp

-q <1..100>

设置输出质量;默认为 85

-o <dst>

把单个转换后的图像写入明确的目标路径

-r

转换成功后替换源图像

-f [dir] [mask]

处理目录中匹配的图像;默认使用当前目录和 *

< <list>

处理文本文件中每行一个的图像路径

当前文件

在当前 core 中,成功打开的文件会立即可通过 $ 再次引用。如果此模块是该扩展名已安装的最高优先级处理器,只输入文件名即可由此命令打开。这些是 core 提供的便捷机制;img <file> 仍是明确调用形式。

安全性

默认转换会创建同目录的 name.img.ext,并拒绝覆盖已有目标。单个明确输出使用 -o,只有确实需要替换源图像时才使用 -r。批量模式不会递归进入子目录。 使用 -r 时图像格式必须保持不变;转换格式时请省略 -r 或使用 -o

交互式 sandbox 预览

可直接在页面中运行预先准备的示例。结果已预先生成并在浏览器中显示;服务器不会执行任何终端命令。

检查当前目录中的图像

安装与管理

安装当前兼容版本。完整功能请选择 Base,精简包请选择 Minimum;已安装模块的更新请使用 upgrade。

Base 与 Minimum 是同一当前模块版本的两个包。

Base 包

安装包含本地参考和全部已发布模式的完整包。

install img
Minimum 包

安装精简包。该包不包含本地参考;help <cmd> -i 会打开当前服务器参考。

install img -m
精确公开版本

安装这个确切的已发布版本。

install img -v 1.1.4
检查或升级

让 upgrade 检查兼容性,仅在需要时替换已安装块。

upgrade img
删除模块

删除扩展块,不影响核心和其他模块。

install img -u

示例

示例可复制,但网站不会执行。请先检查路径、权限和破坏性选项。

检查当前目录中的图像
cd \sandbox\images | img photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
显示图像信息
photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
按比例调整大小;单个数字限制最长边
img $ -s 1200 -t webp -q 82
photo.jpg > photo.img.webp
按指定宽度或高度等比例调整
img photo.jpg -s 32 -w -o photo-thumb.jpg
photo.jpg > photo-thumb.jpg
按比例调整大小;单个数字限制最长边
img -f \sandbox\images "*.jpg" -s 1200 -t webp
photo.jpg > photo.img.webp
处理文本文件中每行一个的图像路径
img -s 1200 < \sandbox\images\images.txt
photo.jpg > photo.img.jpg
product.jpg > product.img.jpg
转换成功后替换源图像
img photo.jpg -s 40 -r
photo.jpg > photo.jpg
显示图像信息
img \sandbox\images\missing.jpg
未找到文件

本示例使用的文件: sandbox/images/photo.jpg

该示例使用受保护的 /sandbox/ 文档工作区中的文件或目录。

[binary file: photo.jpg]

相关文档

当前公开版本

v1.1.42026-08-09

灵活的等比缩放

新增最长边、指定宽度/高度、精确 WxH,以及紧凑的“源 > 结果”输出。