img

img は Web 画像の確認、サイズ変更、変換を行います。

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

概要

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

画像をまとめて処理する

まず１枚で設定を確かめ、問題なければフォルダーや一覧を処理してください。-r を明示しない限り元画像は変更されません。

構文

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 を使用します。

画像変換は入力 32 MiB 以下、入出力とも 2400 万画素以下（各辺最大 16000）に制限します。一括処理は 200 枚、一覧ファイルは 128 KiB までです。変換には GD または Imagick が必要です。

インタラクティブな sandbox プレビュー

用意された例をページ上でそのまま実行できます。結果は事前に生成されてブラウザに表示され、サーバーではターミナルコマンドを実行しません。

現在のディレクトリにある画像を確認

インストールと管理

現在の互換バージョンをインストールします。全機能は Base、縮小版は Minimum を選び、すでに導入済みのモジュール更新には upgrade を使います。

Base と Minimum は同じ現在のモジュールリリースの二つのパッケージです。

Base パッケージ

ローカル参照と公開済みの全モードを含む完全パッケージをインストールします。

install img
Minimum パッケージ

縮小パッケージをインストールします。ローカルリファレンスは含まれず、help <cmd> -i で現在のサーバーリファレンスを開きます。

install img -m
正確な公開版

この公開済みバージョンを正確に指定してインストールします。

install img -v 1.1.5
確認または更新

upgrade が互換性を確認し、必要な場合だけブロックを置換します。

upgrade img
モジュールを削除

コアや他のモジュールに触れず拡張ブロックを削除します。

install img -u

例

例はコピーできますが、サイトは実行しません。実プロジェクトではパス、権限、破壊的オプションを確認してください。

現在のディレクトリにある画像を確認
img \sandbox\images\photo.jpg
Format      JPEG
Dimensions  48x32
MIME        image/jpeg
Size        732 B
比率を保ってリサイズし、1つの数値で長辺を制限する
img \sandbox\images\photo.jpg -s 24
photo.jpg > photo.img.jpg
指定した幅または高さを基準に比率を保ってリサイズする
img \sandbox\images\photo.jpg -s 24 -w
photo.jpg > photo.img.jpg
指定した幅または高さを基準に比率を保ってリサイズする
img \sandbox\images\photo.jpg -s 24 -h
photo.jpg > photo.img.jpg
正確な <WxH> サイズにリサイズする
img \sandbox\images\photo.jpg -s 32x20
photo.jpg > photo.img.jpg
Web 形式に変換する: jpg|png|webp
img \sandbox\images\photo.jpg -t webp -q 82
photo.jpg > photo.img.webp
変換した 1 枚の画像を明示した出力先へ書き込む
img \sandbox\images\photo.jpg -s 24 -o \sandbox\images\thumb.jpg
photo.jpg > thumb.jpg
変換成功後に元画像を置き換える
img \sandbox\images\photo.jpg -s 24 -r
photo.jpg > photo.jpg
ディレクトリ内の一致する画像を処理する。既定は現在のディレクトリと *
img -f \sandbox\images "*.jpg" -s 24 -t webp
photo.jpg > photo.img.webp
product.jpg > product.img.webp
テキストファイルに 1 行ずつ並べた画像パスを処理する
img -s 24 < \sandbox\images\images.txt
photo.jpg > photo.img.jpg
product.jpg > product.img.jpg
画像情報を表示する
img \sandbox\images\missing.jpg
ファイルが見つかりません
ディレクトリ内の一致する画像を処理する。既定は現在のディレクトリと *
img -f \sandbox\images "*.jpg"
Resize or output format required

この例で使うファイル: sandbox/images/photo.jpg

例では、保護されたドキュメント用 /sandbox/ ワークスペースのファイルまたはディレクトリを使います。

[binary file: photo.jpg]

関連ドキュメント

ファイルシステム操作はどのように保護されますか？ →大きなファイルや長い出力に制限があるのはなぜですか？ →

現在の公開版

v1.1.52026-11-01

プロダクション向け調整

img の現在の安定版。img は Web 画像の確認、サイズ変更、変換を行います。

# バージョン履歴