ImageMagick の例 --
画像ファイル処理

インデックス

ImageMagick の例 序文とインデックス

画像フォーマットの概要

画像の読み込み

• 読み込み修飾子
• 入力ファイル名メタ文字処理
• 圧縮画像

画像の保存

• ファイル名のパーセントエスケープ
• GZipped 圧縮画像
• 保存された属性
• 暗号化された画像
• 複数の画像書き込み (adjoin)
• 開始シーケンス (シーン) 番号
• 画像を複数回書き込む

特殊な出力ファイル形式 (IMに固有)

miff:   info:   null:   txt:   sparse-color:   histogram:   mpr:   mpc:   fd:   inline:  

clipboard: -- Windows クリップボードとの読み書き

ephemeral: -- 読み込み後に自動削除

show:, win:, and x: -- 画像を直接表示

x: (入力として) -- 表示キャプチャと再描画

画像フォーマットのデリゲートとコーダー

• 入力デリゲートの例
• 出力デリゲートの例
• デリゲートとソースファイルのリスト
• デリゲートの印刷
• 外部コマンドの実行
• Postscript と PDF のデリゲート
• 直接デリゲート形式変換 (taint)
• その他のデリゲートの例

大規模な画像処理

大量の画像の長いストリーム、ビデオシーケンス

画像フォーマットの概要

画像の読み込み

  logo:      granite:     rose:

  -size 30x30  canvas:red
  -size 30x30  gradient:yellow-lime
  -size 30x30  pattern:fishscales
  magick import:

  -size 30x30  tile:pattern:gray95

magick http://www.ict.griffith.edu.au/anthony/images/anthony_castle.gif \ -resize 100x100 castle_logo.png

プレフィックスファイル形式が指定されている場合、ファイル名の一部として指定されたサフィックスは、ファイルの読み込み方法には影響しません。これは、「text:」対「txt:」ファイル形式の処理など、一部のファイル形式を読み込む場合に不可欠です。もちろん、画像ジェネレーターが特別な方法で処理するために実際に画像ファイルを読み込む場合（たとえば「tile:」）、サフィックス（またはプレフィックス）ファイル形式が再び重要になります。最後の例のように

  magick montage  '*.jpg' -geometry 50x50+2+2  image_index.gif

  magick image_[0-9].gif  image_[1-9][0-9].gif  animation.gif
  magick image_?.gif  image_??.gif  image_???.gif  animation.gif
  magick image_(?|??|???|????).gif  animation.gif

cat tree.gif | magick - -frame 5x5+2+2 read_stdin.gif

for image in eye.gif news.gif storm.gif do magick $image miff:- done | magick - -frame 5x5+2+2 +append read_multiple_stdin.gif

echo "eye.gif news.gif storm.gif" > filelist.txt magick @filelist.txt -frame 5x5+2+2 +append filelist.gif

echo "eye.gif news.gif storm.gif" |\ magick @- -frame 5x5+2+2 +append filelist_stdin.gif

'@' 構文を使用してファイルからファイル名のリストを読み取る機能は、IM v6.5.2-1 で追加されました。

セキュリティ上の予防措置として、これは実際の画像ファイルでのみ機能します。 "rose:" や "label:string" などの画像ジェネレーターでは機能しません。また、ファイルからコマンドラインオプションを「インクルード」するために使用することもできません。

読み込み修飾子または抽出設定

magick -extract 32x32+20+5 rose: +repage rose_extract.gif

magick 'rose:[32x32+20+5]' +repage rose_read_modifier.gif

'[#]' '[#-#]' '[#,#,#]' [#,#-#,#]'. 読み込みフレーム

読み込まれた画像から、マルチイメージファイル形式から特定のサブフレームを選択します。指定された数値 '#' インデックスは、読み取るフレーム番号を指定します。複数のインデックスを、コンマ順またはインデックス範囲として指定できます。画像インデックスは、最初の画像が 0、2 番目の画像が 1 というようにゼロから始まります。負のインデックスを指定すると、画像シーケンスの末尾から逆順にカウントされ、最後の画像が -1、最後から 2 番目の画像が -2 になります。これは、画像リスト演算子に使用される規則とまったく同じです。例

magick document.pdf'[0]' first_page_of_pdf.gif magick animation.gif'[1-3]' second_to_fourth_frames.gif magick animation.gif'[-1,2]' last_then_the_third_frame.gif

IM に、数値のリストに基づいて画像を読み込ませることもできます。例

magick 'image_%03d.png[5-7]' ...

ファイル「image_005.png」、「image_006.png」、および「image_007.png」が読み込まれます。この方法では、負のインデックスを使用できません。

'[#x#]' 読み込みサイズ変更

IM バージョン 6.2.6-2 から、IM ユーザーが非常に大きな画像を処理するのに役立つ新しい修飾子が追加されました。この修飾子は、読み込まれたばかりの画像を、その画像が既にメモリ内にある他の画像に追加される直前にサイズ変更します。

これにより、画像を縮小したり、拡大したりできます。例... magick pattern:gray95'[60x60]' enlarged_dots.gif

警告、読み込み修飾子は現在、'!' (アスペクト比を保持しない) や '>' (より大きな画像のみを縮小) などのサイズ変更フラグを一切使用していません。(リクエストすれば使えるようになるかもしれません。) また、単色のキャンバスのサイズを指定する別の方法としても使用できます。実際に行われていることは、デフォルトの単一ピクセル画像のサイズを変更していることです。例...

magick 'canvas:DodgerBlue[50x50]' canvas_size.gif

この修飾子は、非常に大きな画像を多数読み込もうとしている場合に最も重要です。各画像は、次の画像が読み込まれる前にサイズ変更されるため、それらの画像を処理するために必要な総メモリを大幅に節約できます。たとえば、次のようにする代わりに...

magick montage '*.tiff' -geometry 100x100+5+5 -frame 4 index.jpg

まず最初にすべてのTIFFファイルを読み込み、その後でリサイズを行います。代わりに、次のように行うことができます...

magick montage '*.tiff[100x100]' -geometry 100x100+5+5 -frame 4 index.jpg

これにより、各画像を読み込み、リサイズしてから、次の画像に進みます。これにより、メモリ使用量が大幅に減少し、メモリ制限に達したときのディスクスワップ（スラッシング）を回避できる可能性があります。JPEG画像については、特別な「-define」設定を使用することをお勧めします。たとえば、次のようになります...

magick montage -define jpeg:size=200x200 '*.jpg[100x100]' -strip \ -geometry 100x100+5+5 -frame 4 index.png

特別な設定はJPEGライブラリに渡され、読み込みプロセス中のJPEG画像のサイズを制限するために使用されます。ただし、正確ではなく、結果の画像は、アスペクト比を維持したまま、そのサイズと2倍のサイズの間になります。詳細については、JPEG画像の読み込みを参照してください。この組み合わせの結果、JPEG画像の読み込みが大幅に高速化され、メモリ使用量もさらに削減されます。特に、多数の小さなサムネイルを生成する場合に有効です。一般的なサムネイル作成を参照してください。

'[#x#+#+#]' 読み込み時の切り抜き

IM v6.3.1以降では、オフセットを追加すると、上記が読み込み中の画像の切り抜きになります。たとえば、はるかに大きな画像から、より小さな600x400ピクセルのサブセクションを取得する場合。

magick 'image.png[600x400+1900+2900]' tileimage.png

ただし、これは画像全体をメモリに読み込んでから切り抜き、最終的に現在の画像シーケンスに追加します。本当に大きな画像を処理したい場合は、「stream」コマンドを参照し、画像を「magick」コマンドにパイプしてさらに処理することをお勧めします。以下の巨大な画像処理を参照してください。

PNG形式には、形式仕様の一部として「gzip」圧縮が含まれています。この場合、2桁のPNG「-quality」設定の最初の桁が圧縮レベルを定義します。詳細については、PNG画像ファイル形式の例を参照してください。

スクリプトでユーザーが提供した引数をIMに渡す場合は、引数が予想どおりであることを確認して、十分に注意してください。たとえば、Web画像処理スクリプトでシステムパスワードファイルの画像が返されるようなことは避けたいでしょう。

入力ファイル名のメタ文字処理

構築中

Not only does the shell handle meta-characters (unless that argument is
quoted) but IM also does its own form of meta-character handling in filenames.

For example
  magick *.jpg ....

is expanded by the shell BEFORE passing the filenames to IM, while

  magick '*.jpg' ....

will have the shell pass "*.jpg" to ImageMagick, which then expands into
an internal list of filenames!  This was provided for Windows Dos support, and
as a method to preventing command line limit overflows in command such as
"magick mogrify" and "magick montage", which typically process long lists of images.

As such to actually get IM to read a file names literially named on disk as
'*.jpg'  you need to use any of the following forms...

  magick '\*.jpg' ....
  magick "\*.jpg" ....
  magick "\\*.jpg" ....
  magick \\\*.jpg ....

NOTE; the second line is NOT recommended as some shells (not bash) and some
APIs (C programs, possibly PHP) may actually remove the single backslash, and
pass '*.jpg' to IM which it will again expand!

On top of '?' and '*',  IM also adds the meta-character handling of  ':', '%'
and '[...]' for read modifier handling.  These however have a different
meaning  (codec specification, scene number inclusion, and read modifiers) to
normal shell syntax of those meta-characters.

For example DOS uses will need to escape a 'drive-letter' in filename paths
being passed to ImageMagick.  For example...

  magick C\:\path\to\image.jpg ....

Another example is when loading an image containg a time code.  For example..

  magick "time_10\:30.jpg" ....

will read the filename "time_10:30.jpg" from disk.  Without the backslash, IM
may think that the image should be read with a non-existant image file format
(or delegate) "time_10:", and fail in an unexpected way.

An alternative is to use a question mark...

  magick "time_10?30.jpg" ...

However that may also match another file such as "time_10_30.jpg" as well!

画像の圧縮

構築中

IM will also read files that have been compressed, and given the appropriate
suffix, or image format specification.

That is, an image saved as "image.gif.gz"  will first be uncomressed, before
being decoded from its GIF image format.

Gzipped XPixmap (xpm) and NetPbm/PbmPlus (ppm) images is also automatically
handled, both by Imagemagick, and the formats normal delegate library.  As
such you can use the compressed forms directly either in IM, or in other
programs that understand these file formats.

See  Saving Compressed Images below.

画像の保存

magick tree.gif GIF:tree_image

magick tree.gif -resize 1x3\! txt:-

magick tree.gif -resize 200% miff:- | identify -

ファイル名のパーセントエスケープ

magick rose: -set filename:mysize "%wx%h" 'rose_%[filename:mysize].png'

magick eye.gif news.gif storm.gif -scale 200% \ -set filename:f '%t_magnify.%e' +adjoin '%[filename:f]'

自動GZip接尾辞

magick rose: -compress none rose.gif.gz

magick rose: rose.gif

保存された属性

構築中

Other Settings specific to image writing....
    -depth  -quality  -compress -type  -loop
    -set label   -set comment
Also see Image Depth,
Image Type,
JPEG Quality,
PNG Quality.
GIF loop.

Talk about file compressions, which are part of various image formats.

Different compressions are used for different image formats.

Especially the JPEG to TIFF compression change needed.

Using or "-compress
None" and "-compress" NetPBM text/binary format selection.

The GIF compression and the copyright patent.

Other than using IM to reduce -quality or changing the format to something
else the -compression option is rarely used.  Often it is only used internally
by IM to save images using the same compression the image was read with.

暗号化された画像

複数の画像の書き込み - 隣接手法

magick eye.gif news.gif storm.gif +adjoin image.gif

ImageMagickバージョン6.2.0以前では、上記の出力ファイル名は「image.gif.0」から「image.gif.2」になっていました。これはファイル名サフィックスが失われるため多くの問題を引き起こしたので、ファイル名サフィックスの前に画像番号を追加するように変更されました。

magick eye.gif news.gif storm.gif +adjoin image_%d.gif

10進数には「%d」を使用できるだけでなく、16進数（小文字）には「%x」、16進数（大文字）には「%X」、8進数には「%o」を使用できます。

これらの文字のいずれかが続くパーセント文字が必要な場合は、パーセント文字の意味をエスケープするためにパーセント文字を二重にする必要があります。つまり、パーセント記号を実際に生成するには、「%%」を使用する必要があります。

出力ファイル名の「%d」は、実際にはImageMagickの「+adjoin」設定を自動的に有効にします。 ただし、上記では実際には「+adjoin」は必要ありませんが、個別の画像を生成していることを明確にするためにも、提供しておくのが良いでしょう。

  magick image_[0-9].gif  image_[1-9][0-9].gif  animation.gif
  magick image_?.gif  image_??.gif  image_???.gif  animation.gif
  magick image_(?|??|???|????).gif  animation.gif
  magick 'image_%d.gif[0-123]'  animation.gif

magick eye.gif news.gif storm.gif +adjoin image_%03d.gif

書き込まれたシーン番号

magick null: eye.gif news.gif storm.gif +adjoin image_%01d_of_3.gif rm image_0_of_3.gif

magick eye.gif news.gif storm.gif +adjoin -scene 101 image_%03d.gif

画像を複数回書き込む

magick parrots_orig.png \ \( +clone -resize x128 -write parrots_lrg.jpg +delete \) \ \( +clone -resize x96 -write parrots_big.jpg +delete \) \ \( +clone -resize x64 -write parrots_med.jpg +delete \) \ -resize x32 parrots_sml.jpg

magick scroll.gif -background lightsteelblue -flatten -alpha off \ -write mpr:scroll -resize x128 -write scroll_lrg.jpg +delete \ mpr:scroll -resize x96 -write scroll_big.jpg +delete \ mpr:scroll -resize x64 -write scroll_med.jpg +delete \ mpr:scroll -resize x32 scroll_sml.jpg

特別なファイル形式（IM固有）

miff:

は、ImageMagickファイル形式です。画像シーケンス全体と、画像に関連付けられたすべての属性がこのファイル形式で保存されます。もちろん、ImageMagickコマンドのみがこの形式を読み取るため、異なる画像処理パッケージ間で転送するのには適していません。「miff:」ファイル形式の主な目的は、長くて複雑な方法で画像を処理する際の、中間保存形式としての使用です。また、画像に関連付けられた画像メタデータやその他の属性を渡しながら、あるIMコマンドから別のIMコマンドに画像を「パイプライン処理」するのにも適しています。「miff:」を書き込むときは、「+depth」オプションを含めることをお勧めします。これにより、中間画像保存に可能な限り最高の品質を使用するように、画像の「入力深度」がIMメモリ品質にリセットされます。もちろん、「-depth 8」を使用して保存画像の深度を「クリップ」してディスク上の画像サイズを縮小することもできますが、HDRI浮動小数点保存も有効にしない限り、量子化丸め効果も強制されます。この形式の解析に関心がある場合は、すべての画像属性のプレーンテキストヘッダーから始まります。ヘッダーは、単一の改ページ文字を含む行で終わります。このヘッダー自体が、さまざまな画像処理スクリプトで基本的な画像情報を抽出するための便利な方法です。たとえば、次に、GNU-sedコマンドを使用して、改ページ区切り文字までの「miff:」ヘッダーをリストし、組み込みの「rose:」画像のすべての属性を表示します。

magick rose: miff:- | sed -n '/^\f$/q; p'

これは、IMが画像について認識している現在のすべての設定フラグとメタデータを明らかにするため、非常に役立ちます。ただし、統計情報も存在します。これらは、「magick identify」コマンド、「-identify」演算子、または特別な「info:」形式のいずれかによって生成されます。要求された場合は「-verbose」オプションが適用されます（次を参照）。画像ファイル形式の解析要件は非常に低く、圧縮されていませんが、IMが認識しているあらゆるタイプの画像を処理できます。一時的な画像や、使用できるパイプライン化された画像コマンドに最適な形式です。ただし、ImageMagickプログラムのみが読み取ることができます。下記の「MPR」画像メモリレジスタと「MPC」メモリディスクマッピング形式も参照してください。

生の画像データ（バイナリ）は、実際には4文字のシーケンス「\n\f\n:」（改行された単独の改ページとコロン）がプレフィックスとして付いています。このデータの読み込み方はヘッダーデータにエンコードされていますが、通常はRGBタプルでのバイナリ整数で構成されます。ただし、より多くのチャネルを持つことも、浮動小数点や倍精度データ値で構成されることもあります。 多くの点で、バイナリのPbmPlus画像ファイル形式と実質的に同じですが、画像メタデータを保持するためのヘッダーが大幅に拡張されており、チャネル数とデータ型に多くのバリエーションがあります。

MIFF画像ストリーミング

「miff:」形式は「ストリーミング」画像ファイル形式です。つまり、複数の画像を次々と追加または連結するだけで処理します。これにより、パイプラインなどの同じ宛先に画像を書き込むだけで、複数の画像の「ストリーム」を生成できます。個々の画像が異なるコマンドで生成された場合でも同様です。たとえば、各コマンドが単に「ストリーミング」MIFF画像を出力する画像処理コマンドのループを持つことができます。ループの後、画像の「ストリーム」を単一のコマンドにパイプして、モンタージュ、コラージュ、アニメーション、またはその他のものを生成できます。たとえば、以下は文字「b」で始まる色のリストを生成し、次に「magick」コマンドのループを使用して、ラベル付きの色パッチを一度に1色ずつ生成します。これらは「magick montage」に「パイプ」され、単純なカラーテーブルを生成します。

magick -list color | egrep '^b' | \ while read color junk; do \ magick -label $color -size 70x20 xc:$color +depth miff:-; \ done |\ magick montage - -frame 5 -tile 6x -geometry +2+2 \ -background none color_table.png

上記の特定の例は、スクリプト「show_colors」にプログラムされており、画像処理で使用する色を検索、見つけ、表示するために使用できます。上記は、マルチイメージシーケンスを生成するのに非常に役立つ「ストリーミング画像のパイプライン」の例です。この手法の他の例としては、レイヤー画像のプログラムによる配置、マップ内のピン、名前による色の「名前付きカラー画像」、およびランダムな波紋に示されているようなアニメーションなどがあります。この手法は、「-write miff:-」のような操作でも使用でき、単一のコマンドの複数の場所からmiff形式の画像を出力できます。各画像は、最終出力ストリームに自動的に追加されます。これは、複雑な画像処理コマンドをデバッグするのに特に役立ちます。代替方法（PHPスクリプトで一般的に使用される）は、「生成されたコマンド」の手法を使用することです。これは、長い「magick」コマンドを生成して実行するシェルスクリプトを使用します。画像ワーピングアニメーションのスクリプトでは、この手法を使用しています。

info:

「info:」ファイル形式（IM v6.2.4で追加）は、実際には画像を出力しません！この形式は基本的に、ImageMagickの「magick identify」コマンドが出力するのと同じ情報を出力します。「magick identify」と同様に、この出力形式は「-format」および「-verbose」オプションによって制御され、画像プロパティエスケープページで定義されている、関心のある特定の情報のみを出力できます。たとえば、上記のようにMIFF画像を「magick identify」にパイプする代わりに（画像の保存を参照）、次のものを使用して、結果の画像形式の1行の識別を取得できた可能性があります。

magick granite: info:-

もちろん、「-format」設定を使用して、目的の情報を特定の、より解析可能な方法で出力できます。「info:」の非常に便利な点は、画像に関する追加情報を同時に抽出しながら、画像を生成できるようになったことです。これは、「-write」演算子を使用して、この特別な画像形式をファイル（またはコマンドの通常の標準出力）に保存することで行われます。

	magick rose: -shave 12x0 -repage 64x64+9+9 \ -format '%wx%h %g' -write info:info_paged.txt paged.gif

「-identify」演算子もあり、これは「-write info:」を使用して画像識別情報を標準出力に出力するのと同等です。これにより、IMコマンドをデバッグする際に画像に何が起こっているかをさらに簡単に監視できます。たとえば...

	magick logo: -identify \ -trim -identify \ +repage -identify \ -resize 80x80\! -identify \ logo_thumbnail.gif

ここでは、「-trim」が画像のサイズを縮小しましたが、画像のどの部分がトリミングされたかの「トリミング」情報を保持し、次に「+repage」がその余分な「キャンバス」または「ページ」情報を削除した様子を確認できます。など。「magick identify」コマンドと同様に、「info:」と「-identify」の両方とも、「-verbose」設定がオンになっていると、はるかに詳細な出力になります。ここでは、長い出力を最初の数行に制限して、少しだけ理解できるようにします。

magick rose: -verbose info: | head

「-verbose」設定を使用すると、読み込まれたり出力されたりする画像に関する追加情報が標準エラーに出力されます（「info:」形式を除く）。また、「-colors」のような一部の演算子も追加情報を出力します。そのため、「-identify」または「info:」形式で使用した後で、オフに戻した方がよい場合があります。 たとえば   「-verbose -write info:image_info.txt +verbose」   または   「-verbose -identify +verbose」。

任意の形式の「identify」からの出力のスクリプトによる読み取りは、大文字と小文字を区別しない方法で行う必要があります。これにより、ImageMagickの異なるバージョン間の下位互換性が向上します。

注意: 「info:」（および「-identify」）は出力形式のみであり、「identify」コマンドと同じ出力を生成します。「info:」ファイル形式を使用して、画像を読み込んだり作成したりすることはできません。「-print」を使用して情報を出力することもできますが、これは画像シーケンス全体に対して1回のみ適用されます。つまり、この演算子を使用して、複数の画像を含むより複雑な「%[fx:...]」式を計算できます。ただし、上記の他の方法とは異なり、すべての画像に対して1回のみ適用されることに注意してください。

null:

出力形式として、これは画像の結果を「破棄」するだけです。そのため、「magick」、「magick montage」、または「magick composite」コマンドの最後の引数として使用した場合、最終結果は保存されません！理由は？まあ、特にデバッグするときに、全体的な結果よりも、画像処理中に生成された特定の画像に関心がある可能性があるためです。たとえば、ここでは、画像シーケンスから1つの画像を抽出して保存し、「null:」を使用して他のすべての画像を破棄します。

magick eye.gif news.gif storm.gif tree.gif rose: logo: \ \( -clone 2 -write write_storm.gif \) null:

これは、他のすべての画像を1つずつ削除しようとするよりもはるかに簡単です。ただし、入力画像形式として、「null:」は、現在の画像シーケンスに特別な「nullソース」フラグを持つ、単一の透明なピクセルの特別なプレースホルダー画像を生成します。この特別な画像は、モンタージュにギャップを残すため、および複数画像のレイヤー合成のリストセパレーターとして特に重要です。これは、「-crop」などの操作で生成できる、「見逃された画像」として知られる別の特別な画像形式と密接に関連しています。この画像形式は、操作で空または無意味な結果が生成された場合に生成されます。両方の画像は単一の透明なピクセルであり、そのため「null:」画像も「見逃された画像」であるかのように扱われます。現時点では、現在の画像シーケンスから「null:」や「見逃された画像」を削除する方法はありません。ただし、そのような方法が提案されています。そのような方法が必要だと感じたら、私にメールしてください。

txt:

これは、基本的に画像内の各ピクセルを1行ずつリストする単純なASCIIテキストファイルです。これは、一般的なテキストから画像へのコンバーターではありません。それについては、複数行テキストファイルの例を参照してください。「ピクセル列挙」が認識されない場合、画像は「text:」形式のコーダーに渡され、プレーンテキストファイルとしてレンダリングされます。たとえば、ここに「netscape:」画像を2x2ピクセルの画像にスケーリングし、「txt:」画像形式を使用してリストします。

magick netscape: -scale 2x2\! txt_netscape.txt

画像の最初の行（ヘッダー）には、画像に関する基本情報がパックされています。情報は次のもので構成されます... ファイルマジック: イメージヘッダーは、このファイルを特別なIMテキスト画像形式（例：「ImageMagickピクセル列挙」ファイル）として定義します。これは、コンピューティングの世界では、ファイルの「マジック」、またはこのファイルをこの特定のファイル形式として識別するコード文字列として知られています。画像サイズ: 次の2つの数値は、このファイルに含まれる画像のサイズを定義します。これらの数値を掛け合わせると、画像を完全に定義するためにヘッダーの後に続く必要がある行数もわかります。IMは常にこれだけの行数を出力しますが、後で読み取りを行うときに、すべてのピクセルを定義する必要はないことがわかります。MaxValue: ヘッダーの最後の数値は、可能な画像データの「最大値」を定義します。上記の例では、「255」であり、これは8ビット深度を使用した結果です。組み込みの「netscape:」画像をこの深度で出力したのは、8ビット値を使用して内部的に定義されていたため、IMが画像のこの深度レベルを保持したためです。詳細については、深度設定のセクションを参照してください。ただし、画像の「-depth」を変更することで、IMのQまたはコンパイル時の品質設定の上限まで、深度設定を上書きできます。たとえば、ここでは、色の値を16ビット値（0〜65535）として出力します...

magick netscape: -scale 2x2\! -depth 16 txt_netscape_16.txt

現時点では、出力ファイル形式で使用する特定の「最大値」を設定することはできません。現在の「-depth」設定の観点から異なる値を定義することしかできず、最大値は2^depth-1に等しくなります。

カラースペース: ヘッダーの最後の項目は、後に続くデータのカラースペースを定義します。画像に透明度が含まれている場合、カラースペース名に最後の文字「a」（アルファ用）も追加され、括弧で囲まれた数値の追加の列が追加されます。グレースケール画像は「grey」として画像を出力しますが、少なくとも3つの数値を定義します。これは各ピクセルで同じ値になります。たとえば、ここにカラースペースが「LAB」で、アルファチャネルが追加された同じ画像があります！

magick netscape: -scale 2x2\! -colorspace LAB -alpha set txt_cspace_lab.txt

初期ヘッダーの後には、画像のピクセルごとに1つずつ、ピクセルデータ行があります。座標: コロン「:」までの最初の2つの数値は、0から始まるピクセル位置です。色値: この後、ピクセルの色値（ヘッダーに指定されたMaxValueの0から）が括弧で囲まれて与えられ、画像の現在のカラースペースに応じて3から5個の数値が与えられます。スペースはオプションであるため、括弧内の数値を解析する際には注意が必要です。

値は通常整数です。ただし、IM v6.9.2-1以降、「-define txt:compliance=css」が「-depth 16」で指定されている場合、値は「%」記号付きのパーセント値として表現されます。これは、SVG、CSS準拠の一部です。

色のコメント: 括弧内の数字に続くものはすべてコメントとみなされます。IMは、色の引数として解析できる形式を使用して、ピクセル色の追加情報を埋め込みます（これらの色の指定の詳細については、「-fill」マニュアルエントリを参照してください）。ただし、色のコメントは可変です。通常はハッシュ（'#'）16進カラー値で始まり、その後にRGB()値、または指定されたピクセルデータに応じて色名が出力される場合があります。これらの色名はImageMagickで理解される必要がありますが、あくまでもコメントとして参照されるものです。提供される色は、特に初期のIM v6バージョン以前では、使用しているIMバージョンに大きく依存します。このコメント領域が将来再び変更されないという保証はないため、依存しないのが最善です。IMは、ピクセル列挙イメージを読み込む場合は依存しません。以下は、シェルスクリプトでピクセル列挙を正しく読み込む例です。TXTイメージの正確な形式はconvertコマンドによって定義され、次に'tail'を使用してヘッダーを削除し、'tr'を使用して数字以外のすべての文字を単一のスペースに置き換えます。これにより、後で'while'が数値を簡単に読み取り、残っている可能性のある後続のコメント番号を削除できます。

magick rose: -resize 3x2\! -depth 8 -colorspace RGB -alpha off txt:- | tail -n +2 | tr -cs '0-9.\n' ' ' | while read x y r g b junk; do echo "$x,$y = rgb($r,$g,$b)" done

TXTイメージの読み込みも有効です。イメージ内のすべてのピクセルを定義する必要はありません。実際、ピクセルを正しい順序で配置する必要さえありません！ImageMagickは、各ピクセル定義行を順番に読み取り、空白のイメージキャンバスに「描画」します。このためには、各行の括弧内の数字のみが使用され、色名は使用されません。初期の空白キャンバスは、クリアされて現在の背景色に設定されます。したがって、「txt:」イメージによって提供されないピクセルは、この色で残ります。「txt:」イメージの興味深い使用法については、フォワードピクセルマッピングを参照してください。ここでは、列挙されたピクセルイメージを出力し、各ピクセル位置を変更して（歪ませて）イメージを回転させてから、列挙されたピクセルイメージを再びIMに読み込んでいます。結果のイメージでは、一部のピクセル位置が定義されておらず、他の位置には複数のピクセルが追加されていました。IMはこれを問題なく処理しました。
「txt:」形式は、「-unique-colors」演算子で特に役立ちます。この演算子は、現在のイメージシーケンス内の各イメージを、見つかった一意の色ごとに1つのピクセルを含む新しいイメージに置き換えます。これを「txt:」形式のファイルに出力すると、イメージに含まれる色の基本的な概要が得られます（ただし、カウントやヒストグラムは得られません）。たとえば、以下はツリーイメージで使用されている色です。GIFは8ビットの数値しか使用できないため、色は同じ深度でも出力されます。

	magick tree.gif -unique-colors txt:-

さまざまなNetPBMイメージファイル形式を使用するIMの「txt:」形式を使用する別の方法もあります。IMはデフォルトでこの形式をバイナリとして出力しますが、「-compress」をオフにしてNetPBM形式のASCIIテキストバージョンを出力できます。例:

magick tree.gif -unique-colors -compress None -depth 8 tree_netpbm.ppm

上記の数値がIMの列挙されたピクセル（「txt:」）形式の数値と一致していることに気づくでしょう。IMが読み取るNetPBM形式のイメージを生成する例については、サイズ変更されたグラデーションを参照してください。特定のピクセルの色だけが必要な場合は、イメージを1ピクセルにトリミングして、「txt:」イメージとして出力できます。

magick rose: -crop 1x1+12+26 txt:

または、特別なFXエスケープ形式を使用して、IMで直接使用できる形式で色を出力することもできます。

magick rose: -format '%[pixel:u.p{12,26}]' info:

イメージカラーの抽出も参照してください。

sparse-color:

これは、透明ではない各ピクセルの座標と色をコンマ区切りで返す特別な出力イメージ形式です。出力文字列は、スパースカラー演算子に直接入力するのに適しています。たとえば、これは「rose:」イメージで純粋な赤色に「最も近い」少数のピクセルを見つけます。

magick rose: -alpha set -fuzz 13% +transparent red sparse-color:

多くの場合、これは上記で示した「txt:」形式よりも便利ですが、関与するピクセルが少数の場合に限ります。ただし、執筆時点では、出力はすべて1行であることに注意してください。シェルスクリプトは、出力内のスペースを改行に変換する必要がある場合があります。

histogram:

これは実際には「miff:」イメージ形式ですが、イメージ内のすべての色の完全なカウントを含む非常に大きなイメージコメントが含まれています。つまり、「miff:」テキストヘッダーの「Comment={...}」属性です。たとえば、ここでは「tree」イメージに存在する色を再度リストしますが、今回は各色のピクセル数を含みます。テキストヒストグラムコメントは、二次的な「info:」形式のマジック識別を使用して、「histogram:」イメージから抽出されます。

	magick tree.gif -define histogram:unique-colors=true \ -format %c histogram:info:-

「info:」出力形式は、IM v6.2.4で追加されました。これより前のIMバージョンでは、以下を使用します。 magick tree.gif histogram:- | identify -format %c -

形式は、前のTXTまたはIMピクセル列挙イメージ形式とほぼ同じであることに注意してください。色の値に関するコメントを含めてください。唯一の違いは、X、Yの位置がピクセル数に置き換えられていることです。

このコメントの作成には非常に時間がかかる場合があります。IM v6.6.1-5以降では、特別な設定「-define histogram:unique-colors=false」を追加できます。これにより、不要な場合はこのコメントの生成をオフにします。

イメージ自体は、サイズが256x200ピクセルのヒストグラムグラフです。x軸は色値（0〜255）であり、y軸はピクセル数（ピクセル数に正規化）です。各チャネルのヒストグラムは、それが表す色で表示され、一緒に追加されます。したがって、赤と青は重なり合ってマゼンタになります。つまり、カラーチャネルにはそれぞれ独自のヒストグラムがあります。

イメージを他の形式に変換する場合は、その形式で保存するだけです。「histogram:」は、特殊なイメージ処理形式です。イメージをマジックし、ファイル名のサフィックスまたはさらに「format:」コードで指定された形式で出力します。 magick rose: \ -define histogram:unique-colors=false \ histogram:histogram.gif

非常に暗いイメージは左に大きく重み付けられ、明るいイメージは右に大きく重み付けられます。同様に、中間トーンは中央に表示されます。これをよりよく見るために、ここでは各カラーチャネルのヒストグラムを分離します。また、ヒストグラムのテキストコメント（まだ存在する場合）を削除し、表示用にイメージのサイズを変更します。

magick histogram.gif -strip -resize 50% -separate histogram-%d.gif

赤	緑	青

上記の「rose:」イメージの場合、赤はイメージで重要な重要性を示すため、より広く広がっていることがわかります。一方、緑と青は左側にスパイクがあり、イメージへの影響が非常に少ないことを示しています。

イメージの色ではなく明るさに興味がある場合は、イメージをグレースケールにマジックしてから、「histogram:」イメージを生成してください。 magick rose: -colorspace Gray \ -define histogram:unique-colors=false \ histogram:histogram_gray.gif

グレースケールイメージのヒストグラムは少し異なることがわかります。優勢な赤色が中間トーンのグレー色に近くなり、ヒストグラムの中央にスパイクが生成されます。また、イメージ内のオフホワイトの小さな領域は、グラフの右端に明確なスパイクを生成します。左端の完全に空のスペースも、イメージに暗いパッチがまったくないことを示しています。

一方、より優れた「グローバル」ヒストグラムは、元のイメージのすべてのカラーチャネルを分離して追加するだけで生成できます。結果のヒストグラムは、その値がどのチャネルからのものであるかに関係なく、すべてのカラー値を表したものです。 magick rose: -separate -append \ -define histogram:unique-colors=false \ histogram:histogram_values.gif

残念ながら、「histogram:」は出力形式であるため、イメージを別のコマンドに「パイプ」するか、ディスクに保存するか、または特別な「mpr:」保存/読み取りを使用する必要があります。イメージをさらに処理する場合は、「mpr:」の例を参照してください。ヒストグラム（およびその他のグラフ）を、特別な出力形式ではなく演算子として生成できる方法が利用可能になると便利です。

mpr:{label}

（メモリプログラムレジスタ）は、イメージシーケンス全体を名前付きメモリレジスタに保存します。後でそこからイメージデータを読み取ることができます。したがって、複雑なイメージ操作で後で使用するためにイメージを保存したい場合は、そうすることができます。処理の最後に「mpr:」に書き込んでも、プログラムの終了時にプログラムメモリがシステムに返されるため、役に立ちません。したがって、別のプロセスで必要な場合は、処理ステップの途中で書き込み操作を使用してイメージをファイルに保存する必要があります。「mpr:」に与えられた「label」は、好きなものにすることができます。これは、メモリ内のイメージが保存された場所のラベルにすぎません。スクリプト作成者で名前を扱いたくない人のために、単なる単純な数字にすることもできます。ただし、名前を使用すると、スクリプトがわかりやすくなる可能性があります。イメージを保存したら（下記参照）、同じ「ラベル付き」メモリ位置から何度でもイメージを読み込むことができます。例...

magick tree.gif -write mpr:tree +delete \ \ mpr:tree mpr:tree mpr:tree +append mpr.gif

上記のイメージ処理での「+delete」の使用に注意してください。上記では必要ありません（「mpr:tree」を3回ではなく2回読み取るだけです）が、イメージを「mpr:」レジスタに保存した後、現在のイメージシーケンスからすべてのイメージを削除するのが非常に一般的です。基本的に、上記の2行は、2つの完全に異なる「magick」コマンドと考えることができますが、中間イメージにはディスクスペースではなく名前付きメモリレジスタを使用します。多くの場合、「mpr:」の使用は、クローンまたは複製（上記の例で使用できた）を使用するようなものですが、「mpr:」を使用すると、すべてのイメージを完全に削除して、他の作業のために現在のイメージリストをクリアできます。この方法の最大の利点は、イメージ入力でのみ機能する設定と操作を使用できることです。たとえば、入力イメージ「tile:」演算子でイメージをより広い領域にタイル表示する場合に使用します。

magick tree.gif -flip -write mpr:tree +delete \ -size 64x64 tile:mpr:tree mpr_tile.gif

また、「mpr:」を使用して、特殊な出力イメージ形式フィルターの一部の出力を取得して、さらに処理することもできます。たとえば、ここでは「histogram:」からの出力イメージを保存し、同じコマンドで再び読み込んで処理を続けます。

magick rose: -define histogram:unique-colors=false \ -write histogram:mpr:hgram +delete \ mpr:hgram -strip -resize 50% histogram_resized.gif

インメモリセーブの "mpr:" は、実際には "histogram:" のような出力ファイル形式や、"tile:" のような入力ファイル形式などの特別な I/O フィルターを通じて、すでにメモリ内にある画像を再利用できる唯一の方法です。同様に、"-tile" や、別の画像をソースとして使用する "Color Mapping" 画像など、実際の入力画像を受け取る特別なオプションにも当てはまります。「複数画像のカラーマップ」を参照してください。これらのオプションは IMv7 では、ファイルから画像を読み込む必要のないバージョンに置き換えられていることに注意してください。また、-draw 'image' メソッドを使用して、生成されたインメモリ画像をオーバーレイする場合の唯一の方法でもありますが、これを行うための他の手法もたくさんあります。"mpr:" イメージは、実際には 1 枚の画像だけでなく、画像シーケンス全体を保存します。これは、後で再ロードしてさらに処理できるように、現在の画像シーケンスのスナップショットを撮るようなものです。これにより、実際に関与している画像の数を知らなくても、アニメーションシーケンス全体のコピーを複製またはクローン作成することができます。これを行う例については、「レイヤー合成」を参照してください。"mpr:" に複数の画像がある場合でも、そのシーケンスから個々の画像を抽出することができます。"-write mpr:image" を使用して保存されたマルチイメージシーケンスから 3 番目の画像を取得するには、"mpr:image'[2]'" を使用します。たとえば、ここで 4 つの画像セットから 'storm' 画像を抽出します。

magick eye.gif news.gif storm.gif tree.gif \ -write mpr:images -delete 0--1 \ \ mpr:images'[2]' mpr_extract.gif

画像クローン作成オペレーターは、通常、不明な可変数の画像を処理できず、実際、クローンオペレーターが追加される前は、"mpr:" は、中間ディスクファイルを使用せずに、インメモリ画像を複製する唯一の方法でした。

IM v6.8.2 以降では、リモートの IM キャッシュデーモンプロセスに画像を保存することもできます。これにより、ディスク容量を必要とせずに、別々に実行されている IM コマンド間で画像（およびそのメタデータ）を渡すことができます。「分散ピクセルキャッシュデーモン」を参照してください。

mpc:

は、もともと非常に大きな画像を念頭に置いて設計された、特別な IM 固有のディスク保存形式です。基本的には、プログラムメモリのメモリマップされたディスクファイルで、2 つのバイナリファイルとしてディスクに保存されます。1 つは画像のメタデータを保持する ".mpc"、もう 1 つは画像のピクセルキャッシュを保持する ".cache" です。

"MPC:" 形式では、1 つの画像を保存するために 2 つのファイルが作成されます。

このようなファイルは、IM の再コンパイルまたはアップグレード後は機能せず、特定のマシン用にコンパイルされた IM のみに有効です。そのため、スクリプト化された画像処理で使用される一時的な画像などを保持するなど、一時的な「クイックリード」ファイルにのみ適しており、長期保存には適していません。例えば...

magick very_big_image.tif very_big_image.mpc

は、ディスク上に 2 つのファイルを作成します。1 つは小さな "very_big_image.mpc" ファイル、もう 1 つは "very_big_image.cache" という特殊なメモリダンプファイルです。2 番目のファイルのサイズは、生の非圧縮メモリダンプであるため、他の画像ファイル形式よりもはるかに大きくなる可能性があります。ただし、ファイルは「読み込まれる」または「デコードされる」必要はなく、コンピューターのメモリに直接「ページング」して、まったく同じように処理オーバーヘッドなしで使用できます。必要なのは、大量のディスク容量とディスク IO だけです。言い換えれば、ファイル形式の処理なしに、読み取りにディスクアクセス時間のみが必要です。つまり、データのデコードは必要ありません。画像は「メモリ準備完了」であるため、次に発行する IM コマンドですぐに使用できるようになるため、あらゆるサイズの一時的な画像に特に便利です。ただし、2 つのファイルが生成され、通常の画像ファイルサイズよりも大きくなることを覚えておいてください。そのため、ディスクの使用量とスクリプトのクリーンアップには注意してください。私の IM スクリプトでは、この機能をうまく利用しています。たとえば、スクリプト "de-pixelate" および "divide_vert" を参照してください。これらは、画像処理操作にかなり大量の一時画像ファイルを使用します。これは、IM が画像をデコードしたり、保存するためだけに大量のメモリを消費する必要がないため、同じ画像を何度も何度も読み取る必要があるスクリプトや Mogrify アルファ合成に非常に役立ちます。これは、処理のために画像の小さなセクションを抽出または 切り抜きする必要がある、非常に大きな画像を処理する場合にも非常に役立ちます。ただし、ほとんどの画像操作では、処理中に画像のクローンコピーが作成されるため、新しいインメモリコピーを作成することもできます。そのため、依然として注意が必要です。切り抜きまたは サイズ変更は、MPC の大きな画像処理に対して最も安全な操作です。詳細については、下の「非常に大規模な画像処理」を参照してください。

fd:{file_descriptor}

これは、画像を読み取る、または書き込む特定の「ファイル記述子」を指定できる特別なファイル名です。名前 'fd:0' はプログラムの「標準入力」であり、'fd:1' は「標準出力」です。これらは、ファイル名として '-' を使用することと同じです。ただし、画像の読み取り/書き込みを行う任意の「ファイル記述子」を指定できます。「標準エラー」の場合は 'fd:2' など、親プログラムが事前に配置した他の任意のオープン済みファイルハンドルを指定できます。これの最も一般的な用途は、非常に高度なシェルスクリプトで、複数の画像ファイルストリームがある場合です。または、複数のファイルストリームを同時に開いている可能性のあるネットワークデーモンの場合です。

inline:{base64_file|data:base64_data}

インライン画像を使用すると、特別な base64 エンコードで定義された画像を読み取ることができます。たとえば、base64 エンコードされた画像を読み取るには...

inline:base64_image.txt

このエンコードはファイルからのものかもしれませんが、外部画像ソースからのファイル名としてではなく、読み取り引数として直接与えられるのが一般的です。これは、コマンドラインまたは API 画像処理での「blob」の代替として一般的に使用されます。または、コマンドラインに画像データを直接入力します...

inline:data:mime-type;base64,/9j/4AAQSk...knrn//2Q==

たとえば、非常に小さな画像を base64 エンコードしてみましょう（この変換を行うことができるプログラムはたくさんあります）...

openssl enc -base64 -in noseguy.gif

base64 データには、リターンや改行などの任意の量の空白を含めることができることに注意してください。フォーマットによって単に無視されます。また、通常の ASCII 文字のみを使用するため、メールや Web ページでバイナリデータをエンコードするために使用されます。また、バイナリデータを問題なくプログラムやスクリプトに保存することもできます。たとえば、次のコマンドをシェルスクリプトに含めることができるため、スクリプト自体に画像が組み込まれ、したがって、外部の別の画像ソースを必要としません。

magick 'inline:data:image/gif;base64, R0lGODlhIAAgAPIEAAAAAB6Q/76+vvXes////wAAAAAAAAAAACH5BAEAAAUALAAA AAAgACAAAAOBWLrc/jDKCYG1NBcwegeaxHkeGD4j+Z1OWl4Yu6mAYAu1ebpwL/OE YCDA0YWAQuJqRwsSeEyaRTUwTlxUqjUymmZpmeI3u62Mv+XWmUzBrpeit7YtB1/r pTAefv942UcXVX9+MjNVfheGCl18i4ddjwwpPjEslFKDUWeRGj2fnw0JADs= ' b64_noseguy.gif

これにより、画像はスクリプト（シェルまたは API）で使用できるようになることを覚えておいてください。インストールが複雑になるような、外部の画像ファイルを別途用意する必要はありません。では、なぜ "inline:" にこのような複雑な形式があるのでしょうか？基本的に、これは HTML Web ページでインライン画像に使用される形式であるためです。たとえば、次の例では、右側の画像は Web ページに直接インラインで含まれており、次のような HTML タグを使用して、別の外部ファイルとして含まれていませんでした...

<IMG SRC="data:image/gif;base64, R0lGODlhIAAgAPIEAAAAAB6Q/76+vvXes////wAAAAAAAAAAACH5BAEAAAUALAAA AAAgACAAAAOBWLrc/jDKCYG1NBcwegeaxHkeGD4j+Z1OWl4Yu6mAYAu1ebpwL/OE YCDA0YWAQuJqRwsSeEyaRTUwTlxUqjUymmZpmeI3u62Mv+XWmUzBrpeit7YtB1/r pTAefv942UcXVX9+MjNVfheGCl18i4ddjwwpPjEslFKDUWeRGj2fnw0JADs=" ALT="Nose Guy" WIDTH=32 HEIGHT=32 VSPACE=5 HSPACE=5 BORDER=0 >
これはすべての Web ブラウザーで機能するわけではありません。たとえば、IE7 以前では機能しませんが、IE8 では機能します。基本的に、最新の Web ブラウザーはそれを理解します。

同じタイプのインラインデータ形式は、メールヘッダーの「顔」画像や、おそらく他の多くのファイルタイプにも使用されています。余談：ImageMagick の「マジック」のおかげで、ほとんどの画像ファイル形式には、mime-type（長い文字列の 'image/gif' の部分）を含める必要はありません。実際には、いずれにせよ IM によって完全に無視されます。ただし、インライン画像データ文字列のその部分の終わりを示すために、コンマ ',' は依然として必要です。

magick 'inline:data:,R0lGODlhEAAOALMAAOazToeHh0tLS/7LZv/0jvb29t/f3//U b//ge8WSLf/rhf/3kdbW1mxsbP//mf///yH5BAAAAAAALAAAAAAQAA4AAARe8L1Ek yky67QZ1hLnjM5UUde0ECwLJoExKcppV0aCcGCmTIHEIUEqjgaORCMxIC6e0CcguW w6aFjsVMkkIr7g77ZKPJjPZqIyd7sJAgVGoEGv2xsBxqNgYPj/gAwXEQA7 ' b64_folder.gif

警告：コマンドラインオプションの入力は 5000 文字に制限されています。また、多くのシェル（特に PC-DOS 入力）には、コマンドライン全体の長さ制限があります。そのため、これは非常に大きな base64 画像には適していません。

clipboard:

Windows クリップボードとの間で画像を読み書きします（Windows のみ）。

ephemeral:{image_file}

この画像ファイルを読み込んでから削除します。これは、与えられた画像ファイルがメモリに読み込まれた後に IM がその画像ファイルを削除する、特別な画像読み取りファイル形式です。メモリ内の画像は、読み込まれたファイルが削除されたときには処理も保存もされていないことに注意してください。これは非常に危険であり、細心の注意を払って使用する必要があります。主に 委任スポーンで使用されます。ここで、バックグラウンド委任は入力画像を読み込み、データを受け取ったときに削除します。これにより、「子」が提供された画像の読み込みを終了したため、フォアグラウンドの「親」プロセスに、単独で続行する準備ができていることが通知されます。その後、メインプログラムはクリーンアップし、画像処理を別々に続行するか、場合によっては単に終了することができます。"show:" 画像出力委任は、"magick display" コマンドでこれを使用して、メインコマンドが続行または終了する前に、自動的にバックグラウンドで画像マジック表示を行います（下記参照）。たとえば、私は "flicker_cmp" を呼び出して、いくつかの中間結果を表示するシェルスクリプトでこれを使用しましたが、IM が 2 番目に指定された画像を削除することで、プログラムが入力画像の読み込みを終了したことを通知したときに、自動的に続行（または終了）します。そのフィードバックが必要だが、読み込まれる画像を保持する必要がある場合は、元の画像のコピー、ハードリンク、またはシンボリックリンクを作成し、そのファイルを "ephemeral:" として渡します。そうすれば、削除されても元の画像は保持されます。注意：現在、「アニメーション」または「表示」がアニメーションを終了したか、実際に画像を表示するために画像マジックをアップロードしたときに信号を送信する方法はありません。 :-( ただし、「magick」に別の "ephemeral:" 画像を読み込ませて、画像処理の特定のポイントに到達したことを制御スクリプトに通知することができます。

# Blur an image, and show an on screen comparision before # auto-deleting and exiting. magick rose: input_image.png magick input_image.png -blur 0x5 blurred.png flicker_cmp input_image.png ephemeral:blurred.png & # wait for the second image to have been read and deleted! while [ -f blurred.png ]; do usleep 100; done # At this point we can continue (or exit) without problems. # while the on screen display continues in background. rm -f input_image.png

私はまた、他のバックグラウンドプログラムで、そのバックグラウンドプログラムが続行する準備ができているという信号としてこれを使用しました。

show:、win: および x: -- 画像を画面に直接表示する

これらは、画像の結果を画面に直接表示する特別な出力形式です。画像をファイルに保存する代わりに、結果を表示するだけです。これは、IM コマンドの結果がどうなるかを確認するための迅速なテストに非常に役立ち、この目的のために強くお勧めします。ただし、これらは "display" および "animate" コマンドの非常に単純なバージョンにすぎません。たとえば、ディレクトリ内の画像の簡単な概要を取得します...

magick montage *.jpg show:

2 つの画像の間で異なる領域を確認します...

magick compare image1.png image2.png show:

ここにリストされているすべての形式は、実際には "display" プログラムを呼び出してタスクを実行します。ただし、それぞれが異なる方法でジョブを処理しました。たとえば、'show:' は、別の "display" プログラムを実行するために、スポーン委任を使用します。つまり、画像が表示されたら、元のコマンドは処理を続行します（通常は終了します。"-write show:" を使用しない限り）。一方、'x:' または 'win:' を使用すると、表示ウィンドウを終了するまで、元のコマンドが続行（および終了）できるようになるのを待ちます。残念ながら、これらの方法はいずれもアニメーションをうまく表示できません。そのためには、アニメーションを（MIFF 形式で）"animate" コマンドにパイプ処理することをお勧めします。

x: (入力として) - X Window 表示の読み取り

現在の X ウィンドウの表示を "x:" オペレーターを使って読み取ることもできます。これは "import" コマンドとほぼ同じです。実際、オプションなしでは "import" コマンドとまったく同じように動作します。左ボタンを使ってコピーするウィンドウを選択するか、中ボタンを使って領域をマークします。たとえば、マウスを使ってウィンドウを選択し、取得したウィンドウを別のウィンドウに表示するには（取得したウィンドウが表示されたら終了）...

magick x: show:

警告：マップされていない（アイコン化された）ウィンドウや、別のウィンドウが重なっているウィンドウを取得した場合、画像の内容は空白の領域か、重なっているウィンドウの内容になります！したがって、ウィンドウを取得するときは、ウィンドウが画面に完全に表示されていることを確認してください。画面全体を取得するには、ウィンドウ名として 'root' を使用します。

magick x:'root' full_screen_dump.jpg

または、読み取り修飾子を使用して、ディスプレイの特定の領域を取得します。

magick x:'root[300x400+879+122]' part_screen_dump.jpg

ウィンドウ名を指定すると、特定のウィンドウを取得できます。たとえば、これは 'MailEd' というタイトルのウィンドウを取得します...

magick x:'MailEd' window.jpg

しかし、これはあまりうまく機能しません。同じ名前のウィンドウが複数ある場合や、ウィンドウの名前を特定できないことがよくあるからです。より良い方法は、Xディスプレイが特定のウィンドウ（または子ウィンドウ）を一意に識別するために使用する「XウィンドウID」を使用して、IM に正確なウィンドウを伝えることです。XウィンドウIDは通常、"xwininfo" コマンドを使用して調べますが、"xdotool"、"xwit" などの他のプログラムや、"xprop" のようなツールも、ウィンドウに関する情報を見つけるために使用できます。たとえば、ウィンドウのクラス、名前、タイトル、サイズと配置、子ウィンドウ、ウィンドウマネージャーの装飾などです。たとえば、「Mozilla Firefox」がタイトルまたは名前に含まれるすべてのウィンドウを見つけるには...

xwininfo -root -all | grep "Mozilla Firefox"

上記の出力から、目的のウィンドウの X ウィンドウ ID を抽出できます。次に、ウィンドウマネージャーにある、より複雑なbashスクリプトを示します。ボタンを押すと、現在「フォーカス」があるウィンドウの ID を調べてキャプチャし、以前のキャプチャに従って、次のキャプチャ番号を使用して現在のディレクトリに PNG としてファイル名を付けます。

bash -c " id=$(xprop -root _NET_ACTIVE_WINDOW | sed 's/.* //') magick x:$id capture-tmp-$$.png num=$( ls capture-[0-9]*.png 2>/dev/null | sed -n '$ s/[^0-9]//gp' ) num=$( printf %03d $(expr $num + 1) ) mv capture-tmp-$$.png capture-$num.png "

ほとんどのターミナルプログラムは、環境変数 "WINDOWID" でテキストを表示するために使用している X ウィンドウ ID を教えてくれます。したがって、XTerm または Gnome Terminal のコマンドラインからこれを実行すると、現在のターミナルウィンドウのコピーが取得されます。

magick x:$WINDOWID this_terminal.png

さて、少し面白いことを... ここでは、現在のターミナルの内容を取得し、そこに何かを描画してから、"display" を使って同じターミナルウィンドウに描き戻します！

window=`xwininfo -children -id $WINDOWID |\ sed -n 's/^ *\(0x[^ ]*\).*/\1/p'`; \ window="${window:-$WINDOWID}"; \ magick x:$window -background black \ -draw 'fill black rectangle 40,40 160,160' \ -draw 'stroke red line 50,50 50,150 line 50,150 150,150' \ -draw 'fill lime circle 110,100 80,100' \ -draw 'stroke dodgerblue line 50,150 150,50' \ rose: -geometry +180+60 -composite \ png:- |\ magick display -window $window -

上記の最初のコマンドは、"magick display" を実行するウィンドウが、提供された "WINDOWID" の子ウィンドウである必要がある "XTerm" ウィンドウ用に設計されています。2行目は、子ウィンドウが見つからない場合、"Gnome-Terminal" ウィンドウの場合のように、"WINDOWID" の元の値にフォールバックします。使用するウィンドウが決定したら、それを取得し、描画してターミナルウィンドウに復元します！すると、現在のターミナルウィンドウに直接グラフィカルな出力が得られます。より簡単な例を次に示します。これは、実行するたびにウィンドウの内容を暗くします。実際の "xterm" ウィンドウでこれを数回実行してみると、ターミナルウィンドウで古いコマンドほど暗くなることがわかります！

window=`xwininfo -children -id $WINDOWID |\ sed -n 's/^ *\(0x[^ ]*\).*/\1/p'`; \ window="${window:-$WINDOWID}"; \ magick x:$window -background black -colorize 20% png:- |\ magick display -window $window -

そして、これは私が自分の "xterm" ウィンドウで上記を繰り返したときに何が起こったかを示す「スクリーンキャプチャ」です...

ターミナルの内容は変更されますが、一時的なものであることに注意してください。アイコン化したり、隠したり、デスクトップ画面を変更してからターミナルに戻ると、ターミナルプログラムがウィンドウを再描画し、自分の「描画」を消してしまうため、変更は失われます。上記の操作は、"XTerm" ほど "Gnome-Terminal" ではうまく機能しません。これは、後者がスクロールするたびにウィンドウを「再描画」するのに対し、"XTerm" はそうしないからです。大規模なクライアントプログラムの一部として、グラフやその他の結果をさまざまなウィンドウに直接表示する IM スクリプトを想像してみてください。実際、これは多くのポストスクリプトビューアーや、多くのWebブラウザーでさえ、特別なサブプログラムからの出力を表示する方法です。つまり、そのサブプログラムに引き継がせ、提供されたサブウィンドウに直接描画させます。実験して、メールまたは IM ユーザーフォーラム を通じて、自分が何を思いついたかを私（および他の人）に知らせてください。

画像形式のコーダーとデリゲート

  magick -list delegate

入力デリゲートコマンドの例

<?xml version="1.0" encoding="UTF-8"?>
<delegatemap>
  <delegate decode="flip" command="magick '%i' -flip 'miff:%o'"/>
</delegatemap>