ImageMagick 日本語ドキュメント
⚠️ これは 非公式の翻訳サイトです。ImageMagick Studio LLC とは無関係です。正確な情報は 原文（https://imagemagick.org/identify/） を参照してください。

identify

使用例 • オプション一覧

magick identify プログラムは、1 つ以上の画像ファイルのフォーマットと特性を記述します。画像が不完全または破損している場合も報告します。返される情報には、画像番号、ファイル名、画像の幅と高さ、カラーマップ画像かどうか、画像の色数、画像のバイト数、画像のフォーマット（JPEG、PNM など）、そして画像の読み込みと処理にかかった秒数が含まれます。verbose オプションを使うと、さらに多くの属性が得られます。magick identify コマンドの組み立て方についてはコマンドライン処理を参照するか、以下のコマンド使用例をご覧ください。

使用例

magick identify コマンドの有用さと手軽さを示すため、いくつか例を挙げます。手始めに、JPEG 形式の画像を識別してみましょう:

$ magick identify rose.jpg
rose.jpg JPEG 70x46 70x46+0+0 8-bit sRGB 2.36KB 0.000u 0:00.000

既定では、magick identify は次の出力を返します:

Filename[frame #] image-format widthxheight page-widthxpage-height+x-offset+y-offset colorspace user-time elapsed-time

次に、同じ画像をより詳細に見てみます:

$ magick identify -verbose rose.jpg
Image: rose.jpg
  Format: JPEG (Joint Photographic Experts Group JFIF format)
  Mime type: image/jpeg
  Class: DirectClass
  Geometry: 70x46+0+0
  Units: Undefined
  Type: TrueColor
  Endianness: Undefined
  Colorspace: sRGB
  Depth: 8-bit
  Channel depth:
    Red: 8-bit
    Green: 8-bit
    Blue: 8-bit
  Channel statistics:
    Pixels: 3220
    Red:
      min: 31 (0.121569)
      max: 255 (1)
      mean: 145.557 (0.570814)
      standard deviation: 69.1933 (0.271346)
      kurtosis: -1.38945
      skewness: 0.138955
      entropy: 0.970683
    Green:
      min: 27 (0.105882)
      max: 255 (1)
      mean: 89.246 (0.349984)
      standard deviation: 52.4608 (0.205729)
      kurtosis: 2.60139
      skewness: 1.80708
      entropy: 0.869711
    Blue:
      min: 21 (0.0823529)
      max: 255 (1)
      mean: 80.4196 (0.315371)
      standard deviation: 54.9377 (0.215442)
      kurtosis: 2.93417
      skewness: 1.95544
      entropy: 0.853176
  Image statistics:
    Overall:
      min: 21 (0.0823529)
      max: 255 (1)
      mean: 105.074 (0.412056)
      standard deviation: 58.8639 (0.230839)
      kurtosis: 1.37788
      skewness: 1.48073
      entropy: 0.897856
  Rendering intent: Perceptual
  Gamma: 0.454545
  Chromaticity:
    red primary: (0.64,0.33,0.03)
    green primary: (0.3,0.6,0.1)
    blue primary: (0.15,0.06,0.79)
    white point: (0.3127,0.329,0.3583)
  Alpha color: grey74
  Background color: white
  Border color: srgb(223,223,223)
  Transparent color: none
  Interlace: None
  Intensity: Undefined
  Compose: Over
  Page geometry: 70x46+0+0
  Dispose: Undefined
  Iterations: 0
  Compression: JPEG
  Quality: 92
  Orientation: Undefined
  Properties:
    jpeg:colorspace: 2
    jpeg:sampling-factor: 1x1,1x1,1x1
    signature: aea65c9b557d779d142f26d04abe7008bab50f1e9647faae20afdcc6c15140d5
  Artifacts:
    verbose: true
  Tainted: False
  Filesize: 2.65KB
  Number pixels: 3.22K
  User time: 0.000u
  Elapsed time: 0:01.000
  Version: ImageMagick 7.0.4-8 Q16 x86_64 http://imagemagick.org

なお、画像のシグネチャは画像メタデータではなく、ピクセル成分から生成されます。

72 DPI における画像の印刷サイズをインチで取得するには、次を使います:

$ magick identify -format "%[fx:w/72] by %[fx:h/72] inches" document.png
8.5 x 11 inches

生（raw）画像のビット深度と寸法は、コマンドラインで指定する必要があります:

$ magick identify -depth 8 -size 640x480 image.raw
image.raw RGB 640x480 sRGB 9kb 0.000u 0:01

ここでは、画像のテクスチャ特徴、モーメント、知覚ハッシュ、およびユニークな色数を表示します:

$ magick identify -verbose -features 1 -moments -unique image.png

画像の凸包と最小外接矩形の属性を表示するには、次を使います:

magick identify -define identify:convex-hull=true image.png

画像の最小・最大ピクセルの位置を出力する特別な define もあります:

magick identify -precision 5 -define identify:locate=maximum -define identify:limit=3 image.png

magick identify の使用例は Examples of ImageMagick Usage でさらに見つかります。

オプション一覧

magick identify コマンドは以下のオプションを認識します。各オプションをクリックすると、その動作の詳細を確認できます。

オプション 説明
-alpha アルファチャンネルの on, activate, off, deactivate, set, opaque, copy, transparent, extract, background, shape の指定
-antialias ピクセルのエイリアシングを除去する
-authenticate value このパスワードで画像を復号する
-auto-orient 画像の向きを自動調整する
-channel type 選択した画像チャンネルにオプションを適用する
-clip 8BIM プロファイルの最初のパスに沿ってクリップする
-clip-mask filename クリップマスクを画像に関連付ける
-clip-path id 8BIM プロファイルの名前付きパスに沿ってクリップする
-colorspace type 画像の色空間を設定する
-crop geometry 画像を切り抜く
-debug events 大量のデバッグ情報を表示する
-define format:option 1 つ以上の画像フォーマットオプションを定義する
-density geometry 画像の水平・垂直解像度
-depth value 画像のビット深度
-endian type 画像のエンディアン（MSB または LSB）
-extract geometry 画像から領域を抽出する
-features distance 画像特徴（コントラスト、相関など）を解析する
-format string 画像特性を整形して出力する
-gamma value ガンマ補正のレベル
-grayscale method 画像をグレースケールに変換する
-help プログラムのオプションを表示する
-interlace type 画像のインターレース方式の種別
-interpolate method ピクセル色の補間方法
-limit type value ピクセルキャッシュのリソース上限
-list type Color, Configure, Delegate, Format, Magic, Module, Resource, Type のいずれか
-log format デバッグ情報の書式
-mask filename マスクを画像に関連付ける
-moments 画像モーメントと知覚ハッシュを表示する
-monitor 進捗を監視する
-negate 各ピクセルを補色に置き換える
-ping 既定では、必要な画像メタデータのみを読み込んで特定の画像特性を効率的に判定する。すべてのメタデータとピクセル特性を正確に識別するには +ping を使う。
-precision value 表示する有効桁数の上限を設定する
-quiet すべての警告メッセージを抑制する
-regard-warnings 警告メッセージを重視する
-respect-parentheses 括弧の境界まで設定を有効に保つ
-sampling-factor geometry 水平・垂直のサンプリング係数
-set attribute value 画像属性を設定する
-size geometry 画像の幅と高さ
-strip 画像からすべてのプロファイルとコメントを除去する
-unique 画像内のユニークな色数を表示する
-units type 画像解像度の単位
-verbose 画像の詳細情報を表示する
-version バージョン情報を表示する
-virtual-pixel method 画像境界外のピクセルへのアクセス方法

原文: https://imagemagick.org/identify/