img

画像情報を確認し、JPEG、PNG、WebP のサイズ、形式、品質を一括変換できます。

ファイルバージョン 1.1.4安定版
lil-terminal

概要

img は Web 画像向けの小さな作業ツールです。追加拡張なしで画像情報を確認し、GD または Imagick があれば JPEG・PNG・WebP を単一ファイル、ディレクトリ、マスク、一覧から縮小・変換できます。

画像をまとめて処理する

画像の一括処理では、まず1枚で変換を確認してから、同じサイズ・形式・品質のルールをディレクトリや一覧に適用します。

構文

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

リファレンス

img <file>

画像情報を表示する

-s <size>

比率を保ってリサイズし、1つの数値で長辺を制限する

-s <size> -w | -h

指定した幅または高さを基準に比率を保ってリサイズする

-s <WxH>

正確な <WxH> サイズにリサイズする

-t <format>

Web 形式に変換する: jpg|png|webp

-q <1..100>

出力品質を設定する。既定値は 85

-o <dst>

変換した 1 枚の画像を明示した出力先へ書き込む

-r

変換成功後に元画像を置き換える

-f [dir] [mask]

ディレクトリ内の一致する画像を処理する。既定は現在のディレクトリと *

< <list>

テキストファイルに 1 行ずつ並べた画像パスを処理する

使い方

img <file> [options] | img -f [dir] [mask] [options] | img [options] < <list>

アクティブファイル

現在の core では、正常に開いたファイルをすぐに $ で再利用できます。このモジュールがその拡張子に対するインストール済みハンドラーのうち最優先なら、ファイル名だけを入力してこのコマンドで開けます。これらは core の補助機能であり、明示的な形式は img <file> のままです。

安全性

既定では隣に name.img.ext を作成し、既存の出力先は置き換えません。1 枚の明示出力には -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
比率を保ってリサイズし、1つの数値で長辺を制限する
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
比率を保ってリサイズし、1つの数値で長辺を制限する
img -f \sandbox\images "*.jpg" -s 1200 -t webp
photo.jpg > photo.img.webp
テキストファイルに 1 行ずつ並べた画像パスを処理する
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、簡潔な「元 > 結果」表示を追加しました。

# バージョン履歴