コマンドラインオプション

-adaptive-blur `radius`[x`sigma`]

ピクセルを適応的にぼかします。エッジの近くでは効果が減ります。

指定された半径と標準偏差 (sigma) のガウス演算子が使用されます。sigma が指定されていない場合は、デフォルトで 1 になります。

sigma の値は重要な引数であり、実際に行われるぼかしの量を決定します。

radius は、計算されたガウス分布を保持する配列のサイズを決定するためにのみ使用されます。整数である必要があります。指定されない場合、または 0 に設定されている場合、IM はガウス分布に意味のある結果を提供する最大の半径を計算します。

-adaptive-resize `geometry`

データ依存の三角測量を使用して画像のサイズを変更します。

ジオメトリ引数の詳細については、Image Geometry を参照してください。-adaptive-resize オプションは、デフォルトでデータ依存の三角測量になります。別の再サンプリングアルゴリズムを選択するには、-filter を使用します。ジオメトリ文字列にオフセットが存在する場合、オフセットは無視され、-gravity オプションは効果がありません。

-adaptive-sharpen `radius`[x`sigma`]

ピクセルを適応的にシャープ化し、エッジの近くで効果が大きくなります。

指定された半径と標準偏差 (sigma) のガウス演算子が使用されます。sigma が指定されていない場合は、デフォルトで 1 になります。

sigma の値は重要な引数であり、実際に行われるぼかしの量を決定します。

radius は、計算されたガウス分布を保持する配列のサイズを決定するためにのみ使用されます。これは整数である必要があります。指定されないか、ゼロに設定されている場合、IM はガウス分布に意味のある結果を提供する最大半径を計算します。

-adjoin

画像を 1 つのマルチ画像ファイルに結合します。

このオプションはデフォルトで有効になっています。画像シーケンスのすべての画像を指定された出力ファイルに保存しようとします。ただし、JPEG や PNG などの一部の形式では、1 つのファイルに複数の画像をサポートしていないため、その場合、ImageMagick は各画像を別々のファイルとして書き込む必要があります。そのため、複数の画像を書き込む必要がある場合は、各画像に異なる名前を付けるために、サフィックスの前に -scene 番号を追加して指定されたファイル名を変更します。

ファイル形式が 1 つのファイルに複数の画像を許可しているかどうか (たとえば、GIF、MIFF、TIFF) に関係なく、各画像を別々のファイルに書き込むようにするには、+adjoin を使用します。

出力ファイル名に C スタイルの整数形式文字列を含めると、+adjoin が自動的に有効になり、-scene 番号がファイル名のどこに置かれるかを指定するために使用されます。 '%d' や '%03d' などのこれらの文字列は、標準の printf()' C ライブラリ関数を使用したことがある人にはおなじみのものです。たとえば、コマンド

magick logo: rose: -morph 15 my%02dmorph.jpg

は、my00morph.jpg、my01morph.jpg、my02morph.jpg、...、my16morph.jpg という名前の 17 個の画像 (指定された 2 個と -morph によって作成された 15 個) のシーケンスを作成します。

要約すると、ImageMagick はすべての画像を 1 つのファイルに書き込もうとしますが、次のいずれかの条件が存在する場合は複数のファイルに保存します...

出力画像のファイル形式で複数の画像ファイルが許可されていない、
+adjoin オプションが指定されている、または
printf() 整数形式文字列 (例: "%d") が出力ファイル名に存在する。

-affine `s_x`,`r_x`,`r_y`,`s_y`[,`t_x`,`t_y`]

回転と拡大縮小を組み合わせた描画変換マトリックスを設定します。

このオプションは、後続の -draw または -transform オプションで使用する変換マトリックスを設定します。

マトリックスのエントリは、引用符で囲むか、スペースなしで、コンマで区切られた数値として入力されます。

内部的には、変換マトリックスには 3x3 の要素がありますが、そのうち 3 つは定数であるため入力から省略されます。元の画像の位置 (x、y) にあるピクセルの新しい (変換された) 座標 (x'、y') は、次のマトリックス方程式を使用して計算されます。

結果の画像のサイズは、変換されたソース画像を含む最小の長方形のサイズです。その後、パラメーター t_x と t_y によって画像ピクセルがシフトされ、画像領域から移動したピクセルは切り取られます。

変換マトリックスは左手ピクセル座標系に準拠しています。正の x および y 方向はそれぞれ右向きと下向きで、正の回転は時計回りです。

変換係数 t_x および t_y を省略すると、デフォルトで 0,0 になります。したがって、変換なしの回転とスケーリングには 4 つのパラメータで十分です。

x および y 方向の係数 s_x および s_y によるスケーリングは、次のようにして行われます。

詳細については、-transform および -distort メソッド 'Affineprojection を参照してください

-affine sx,0,0,sy

変位 (t_x、t_y) による変換は、次のように実行されます:

-affine 1,0,0,1,tx,ty

c = cos(a)、s = sin(a) とし、次の式を使用して、原点 (左上隅) を中心に時計回りに角度 a だけ回転します。

-affine c,s,-s,c

一連の -affine 変換の累積効果は、代わりに、個々の変換の行列の積に等しい行列を使用した単一の -affine 操作によって実現できます。

ほぼ特異な変換行列の検出が試みられます。行列の行列式の絶対値が十分に小さい場合は拒否されます。

-alpha `type`

画像のアルファ/マットチャネルを制御します。

既存のアルファチャネルデータを使用するかどうか、アルファチャネルを作成するかどうか、またはアルファチャネルに対して他の操作を実行するかどうかを示すフラグを画像に設定するために使用されます。以下のリストから引数 type を選択します。

activate: 画像の透明チャネルを有効にします。既存の透明チャネル (ただし、明示的にオフにされている) を明示的に保持する必要がある場合を除き、通常はこれではなく Set を使用する必要があります。
関連付け: アルファチャネルを画像に関連付けます。
背景: 完全に透明なピクセルを背景色に設定し、完全に透明なままにします。これにより、PNG などの一部の画像ファイル形式が小さくなります。透明ピクセルの RGB 値はより均一になり、圧縮率が向上するためです。
コピー: アルファ/マットチャネルを「オン」にしてから、画像のグレースケール強度をアルファチャネルにコピーし、グレースケールマスクを透明な形状のマスクに変換して、適切に色付けできるようにします。カラーチャネルは変更されません。
非アクティブ化: 画像の透明チャネルを無効にします。既存のデータを削除または変更せず、そのデータの使用をオフにするだけです。
分離: アルファチャネルを画像から分離します。
抽出: アルファチャンネルの値をすべてのカラーチャンネルにコピーし、画像の透明度を「オフ」にして、画像の形状のグレースケールマスクを生成します。アルファチャンネルのデータはそのまま残り、非アクティブ化されるだけです。これは「コピー」の逆です。
オフ: アルファチャンネルを無効にします。
オフの場合不透明: アルファチャンネルが完全に不透明な場合にのみ無効にします。
オン: アルファチャンネルを有効にします。
不透明: アルファ/マットチャンネルを有効にし、完全に不透明にします。
削除: 背景色の上に画像を合成します。
設定: アルファ/マットチャネルをアクティブにします。以前にオフにされていた場合は、チャネルも不透明にリセットされます。画像でアルファチャネルがすでにオンになっている場合は、効果はありません。
シェイプ: 「コピー」と同じですが、結果のシェイプマスクも現在の背景色で色付けされます。つまり、RGB カラーチャネルが適切なアルファシェイプに置き換えられます。
透明: アルファ/マットチャネルをアクティブにして、完全に透明にします。これにより、元の画像と同じサイズで元の RGB データはすべてそのままで、完全に透明な画像が効果的に作成されます。

旧式の +matte 操作は「-alpha Off」と同じでしたが、>-matte 操作は「-alpha Set」と同じであり、「-alpha On」と同じではないことに注意してください。

-annotate `degrees` `text`

画像にテキストで注釈を付ける

これは、画像にテキストで注釈を付ける場合に便利です。テキスト注釈をより正確に制御するには、-draw を使用します。

値 Xdegrees と Ydegrees はテキストに適用されるせん断を制御し、t_x と t_y は -gravity 設定を基準としたテキストの位置を指定するオフセットで、デフォルトでは画像の左上隅になります。

-annotate degrees または -annotate degreesxdegrees を使用すると、せん断されていないテキストの回転が生成されます。回転の方向は正で、degrees が正の場合は時計回りの回転になります。 (これは、画像では正の y 方向が慣例的に downward であると考えられることに気づけば、通常の数学的慣例に従います。)

画像内の位置 (x、y) にあるピクセルの新しい (変換された) 座標 (x'、y') は、次の行列方程式を使用して計算されます。

t_x と t_y を省略すると、デフォルトで 0 になります。これにより、テキストの左下が画像の左上隅になりますが、これはおそらく望ましくありません。この場合、-gravity オプションを追加すると、良い結果が得られます。

テキストは、UTF-8 でエンコードされた任意の文字シーケンスです。 text が '@mytext.txt' 形式の場合、テキストはファイル mytext.txt から読み取られます。ファイル内のテキストは文字どおりに解釈され、埋め込まれた書式設定文字は認識されません。

-antialias

フォントと線を描画するときに、アンチエイリアスピクセルのレンダリングを有効/無効にします。

デフォルトでは、オブジェクト (テキスト、線、ポリゴンなど) は描画時にアンチエイリアスされます。アンチエイリアスエッジピクセルの追加を無効にするには、+antialias を使用します。これにより、イメージに追加される色の数が、直接描画される色のみに減ります。つまり、このようなオブジェクトを描画するときに、混合色は追加されません。

-append

現在のイメージを垂直または水平に結合します。

このオプションは、現在のすべての画像を上から下に順番に結合して、1 つの長い画像を作成します。画像を左から右に積み重ねるには、+append を使用します。

幅が同じでない場合、幅の狭い画像は現在の -background の色設定でパディングされ、それらの相対的な位置は現在の -gravity の設定で制御できます。

画像間にスペースを追加する機能など、より柔軟なオプションが必要な場合は、-smush を使用します。

-attenuate `value`

画像にノイズを追加するときにノイズを軽減 (または強調) します。

設定されていない場合、値は 1.0 または最大ノイズ追加に相当します

-authenticate `password`

パスワードを使用して PDF を復号化します。

このオプションを使用して、Microsoft Crypto API (MSC API) を使用して暗号化された PDF を復号化するための password を指定します。MSC API を使用した暗号化はサポートされていません。

別の暗号化方法については、-encipher および -decipher を参照してください。

-auto-gamma

画像のガンマレベルを自動的に調整します。

これは、画像の平均値を計算し、計算された -gamma 調整を適用して、画像の平均カラーの値が 50% になるようにします。

つまり、単色の「グレー」画像は 50% グレーになります。

これは、極端に暗い部分や明るい部分がほとんどまたはまったくない実際の画像には適していますが、明るい空や暗い影が大量にある画像には適していません。また、図や漫画のような画像にも適していません。

これは、-channel 設定 (チャネル同期用の 'sync' フラグを含む) を使用して、どのカラー値を使用および変更するかを決定します。デフォルトの -channel 設定は 'RGB,sync' であるため、チャネルは同じガンマ値でまとめて変更され、カラーが保持されます。

-auto-level

イメージのカラーレベルを自動的に調整します。

これは「完璧な」イメージ正規化演算子です。イメージ内の正確な最小および最大のカラー値を見つけ、-level 演算子を適用して値を全範囲の値に引き伸ばします。

この演算子は、1 つの「アウトライダー」ピクセルが -level 操作の最小/最大値を不適切に設定することがあるため、通常、実際のイメージ、イメージスキャン、または JPEG 形式のイメージには使用されません。一方、カラールックアップテーブル、歪みマップ、またはその他の「数学的に」定義されたイメージを生成するために使用されるカラーストレッチグラデーションイメージには、この演算子が適しています。

この演算子は、-normalize、-contrast-stretch、および -linear-stretch 演算子と非常に似ていますが、これらの演算子に発生する可能性のある「ヒストグラムビニング」または「クリッピング」の問題はありません。つまり、-auto-level はこれらの演算子の完全または理想的なバージョンです。

-channel 設定 (チャネル同期用の特別な 'sync' フラグを含む) を使用して、どのカラー値を使用および変更するかを決定します。デフォルトの +channel 設定は 'RGB,sync' であるため、'sync' により、カラーチャネルが同じガンマ値で一緒に変更され、カラーが保持され、透明度が無視されます。

-auto-orient

画像の向きが表示に適したものになるように調整します (つまり、左上向きにします)。

この演算子は、EXIF 画像プロファイル設定 'Orientation' を読み取ってリセットし、画像を適切に 90 度回転して向きを調整し、正しく表示できるようにします。

この EXIF プロファイル設定は通常、デジタルカメラの重力センサーを使用して設定されますが、真下または真上を向いて撮影された写真には適切な値がない場合があります。また、この設定をリセットせずに方向を「修正」した画像は、再度「修正」されて誤った結果になる場合があります。EXIF プロファイルが以前に削除された場合、-auto-orient 演算子は何も行いません。

-auto-threshold `method`

画像のしきい値設定を自動的に実行します。

有効なメソッドは次のとおりです:

未定義: 0: メソッドが指定されていません (「OTSU」に相当)。
Kapur: 最大エントロピーしきい値設定。
OTSU: クラスターベースの画像しきい値設定。
三角形: 幾何学的しきい値設定方法。

計算されたしきい値は、 image プロパティとして返されます。代わりにデバイスに印刷するには、を使用します。

-average

画像セットを平均化します。

画像のサイズが同じでない場合はエラーが発生します。

-backdrop

画像を背景の中央に表示します。

この背景はワークステーションの画面全体を覆い、画像を表示している間、他の X ウィンドウのアクティビティを隠すのに役立ちます。背景の色は背景色として指定されます。色は、-fill オプションで説明されている形式を使用して指定されます。

-background `color`

背景色を設定します。

色は、-fill オプションで説明されている形式を使用して指定されます。デフォルトの背景色 (何も指定されていないか、画像内に見つからない場合) は白です。

-bench `iterations`

パフォーマンスを測定します。

iterations の指定回数分コマンド全体を繰り返し、ユーザー時間と経過時間を報告します。たとえば、次のコマンドとその出力について考えてみましょう。ベンチマークを -duration で変更して固定秒数実行し、-concurrent でベンチマークを並列実行します (OpenMP 機能が必要)。

$ magick logo: -resize 200% -bench 5 logo.png
Performance[1]: 5i 1.344ips 1.000e 3.710u 0:03.720
Performance[2]: 5i 1.634ips 0.549e 3.890u 0:03.060
Performance[3]: 5i 2.174ips 0.618e 3.190u 0:02.300
Performance[4]: 5i 1.678ips 0.555e 3.810u 0:02.980
Performance[4]: 5i 0.875657ips 6.880u 0:05.710

この例では、3 つのスレッドと 3.190 秒のユーザー割り当て時間を使用して、1 秒あたり 2.174 回の反復で 5 回の反復が完了し、合計経過時間は 2.300 秒でした。

-bias `value`{`%`}

画像の畳み込み時にバイアスを追加します。

このオプションは、-convolve の出力をシフトして、正と負の結果が指定されたバイアス値に相対的になるようにします。

これは、正の値だけでなく負の値も含む畳み込みを扱う ImageMagick の非 HDRI コンパイルにとって重要です。これは、ハイパスフィルターやエッジ検出を含む畳み込みの場合に特に当てはまります。出力バイアスがない場合、負の値はゼロでクリップされます。

HDRI コンパイル時設定で ImageMagick を使用する場合、-bias は必要ありません。これは、ImageMagick がカラー値の範囲 (0..QuantumRange) にクリップすることなく、負の結果を格納/処理できるためです。

High Dynamic-Range Images ページの ImageMagick の HDRI 実装に関する説明を参照してください。HDRI の詳細については、ImageMagick Usage ページまたはこの Wikipedia エントリを参照してください。

-bilateral-blur `width`{x`height`}{`+intensity-sigma`}{`+spatial-sigma`}

非線形でエッジを保持し、ノイズを低減する画像用スムージングフィルターです。各ピクセルの強度を、近くのピクセルの強度値の加重平均に置き換えます。この重みはガウス分布に基づいています。重みは、ピクセルのユークリッド距離だけでなく、放射測定の差 (色の強度、深度距離などの範囲差など) にも依存します。これにより、シャープなエッジが保持されます。

強度シグマは強度空間にあります。値が大きいほど、ピクセル近傍 (空間シグマを参照) 内のより遠い色が混合され、色がほぼ等しい領域が広くなります。

空間シグマは座標空間にあります。値が大きいほど、色が十分に近い限り、より遠いピクセルが互いに影響し合うことを意味します (強度シグマを参照)。近傍直径が 0 より大きい場合、空間シグマに関係なく近傍のサイズを指定します。それ以外の場合、近傍の直径は空間シグマに比例します。

強度と空間シグマのデフォルト値はそれぞれ 0.75*diameter と 0.25*diameter です。

-black-point-compensation

黒点補正を使用します。

-black-threshold `value`{`%`}

しきい値を下回るすべてのピクセルを黒くし、しきい値以上のすべてのピクセルは変更しません。

しきい値は、必要な -channel 値に対応する [0, QuantumRange] 内のパーセンテージまたは絶対整数値として指定できます。しきい値と結果の値の詳細については、-threshold を参照してください。

-blend `geometry`

指定された絶対値またはパーセントで、画像を別の画像にブレンドします。

ブレンドは、指定されたパーセンテージと各ピクセルの透明度に従って、画像を平均化します (「プラス」)。パーセンテージ値が 1 つだけ指定されている場合は、合成画像または「ソース」画像の重みが設定され、背景画像は正反対の重みが設定されます。つまり、-blend 30% は「ソース」画像の 30% を「デスティネーション」画像の 70% とマージします。したがって、これは -blend 30x70% と同等です。

-blue-primary `x`,`y`

青の色度プライマリポイントを設定します。

-blue-shift `factor`

月明かりの下で夜間のシーンをシミュレートします。係数 1.5 から開始します。

-blur `radius`

画像ノイズを減らし、詳細レベルを下げます。

指定された Sigma 値を使用して、画像をガウス分布または正規分布で畳み込みます。式は次のとおりです:

sigma 値は重要な引数であり、実際に発生するぼかしの量を決定します。

radius は、計算されたガウス分布を保持する配列のサイズを決定するためにのみ使用されます。整数である必要があります。指定されないか、ゼロに設定されている場合、IM はガウス分布に意味のある結果を提供する最大半径を計算します。

Radius が大きいほど、操作は遅くなります。ただし、Radius が小さすぎると、深刻なエイリアシング効果が発生する可能性があります。ガイドラインとして、Radius は Sigma の値の少なくとも 2 倍にする必要がありますが、3 倍にするとより正確な結果が得られます。

このオプションは、分布の分離特性を利用するという点で -gaussian-blur と異なります。ここでは、水平方向に 1 次元のガウスマトリックスを適用し、次に垂直方向にプロセスを繰り返します。

-virtual-pixel 設定は、画像外のピクセルを最終結果にぼかす方法を決定します。

-border `geometry`

画像を色の境界線で囲みます。

geometry 引数の size 部分を使用して幅と高さを設定します。ジオメトリ引数の詳細については Image Geometry を参照してください。オフセットは無視されます。

IM 6.7.8-8 以降、geometry 引数は次のように動作します:

value: 値は左/右と上/下の両方に追加されます
value-xx: value-x は左/右にのみ追加され、上/下は変更されません
xvalue-y: value-y は上/下にのみ追加され、左/右は変更されません
value-xxvalue-y: value-x は左/右と値yが上/下に追加されます
value-xx0: 値xは左/右にのみ追加され、上/下は変更されません
0xvalue-y: 値yは上/下にのみ追加され、左/右は変更されません
value%: 幅の値%が左/右に追加され、高さの値%が上/下に追加されます
value-xx%: 幅の値x%が左/右に追加され、上/下
xvalue-y%: value-y 高さの % が上/下と左/右に追加されます
value-x%xvalue-y%: value-x 幅の % が左/右に追加され、value-y 高さの % が上/下に追加されます
value-x%x0%: value-x 幅の % が左/右に追加され、上/下は変更されません
0%xvalue-y%: value-y 高さの % が上/下と左/右に追加されます変更なし

-bordercolor 設定を先頭に付けて境界線の色を設定します。

-border 操作は現在の -compose 設定の影響を受け、デフォルトの 'Over' 合成方法を使用しているものと想定します。このネット画像の中央に元の画像を重ねる前に、現在の -bordercolor で適切なサイズの色の画像を生成します。つまり、デフォルトの合成方法 'Over' では、透明な部分が現在の -bordercolor 設定に置き換えられる場合があります。

より多くの機能を持つ -frame オプションも参照してください。

-bordercolor `color`

境界線の色を設定します。

色は -fill オプションで説明されている形式を使用して指定します。

デフォルトの境界線の色は #DFDFDF、つまりこのグレーのシェードです。

-borderwidth `geometry`

境界線の幅を設定します。

-brightness-contrast `brightness`

画像の明るさやコントラストを調整します。

明るさとコントラストの値は、入力画像に変更を適用します。これらは絶対的な設定ではありません。明るさまたはコントラストの値が 0 の場合、変更はありません。値の範囲はそれぞれ -100 ～ +100 です。正の値は明るさまたはコントラストを上げ、負の値は明るさまたはコントラストを下げます。コントラストのみを制御するには、明るさを 0 に設定します。明るさのみを制御するには、コントラストを 0 に設定するか、そのままにしておきます。

-channel を使用して、明るさやコントラストの変更を適用するチャネルを制御することもできます。デフォルトでは、すべてのチャネルに同じ変換が適用されます。

明るさとコントラストの引数は、線形変換のオフセットと傾斜に変換され、-function polynomial "slope,offset" を使用して適用されます。

傾きは、コントラスト=-100 の 0 からコントラスト=+100 のほぼ垂直まで変化します。明るさ=0 でコントラスト=-100 の場合、結果は完全に中間グレーになります。明るさ=0 でコントラスト=+100 の場合、結果は中間グレーのしきい値に近づきますが、完全には達しません。つまり、線形変換は中間グレーで非常に急な垂直線になります。

この関数では、負の傾き、つまり画像を反転することはできません。実現可能なすべての傾きは、0 または正です。

オフセットは、明るさ=-100 の -0.5 から明るさ=0 の 0 から明るさ=+100 の +0.5 まで変化します。したがって、コントラスト=0 で明るさ=100 の場合、結果は完全に白になります。同様に、コントラスト=0 で明るさ=-100 の場合、結果は完全に黒になります。

引数の値の範囲は -100 から +100 なので、「%」記号を追加しても、省略した場合と変わりません。

-cache `threshold`

(このオプションは -limit オプションに置き換えられました)。

-canny `radius`

Canny エッジ検出器は、多段階アルゴリズムを使用して、画像内のさまざまなエッジを検出します。

しきい値の範囲は 0 から 100% です (例: -canny 0x1+10%+30%)。{+lower-percent} < {+upper-percent}。 {+upper-percent} を増やしても {+lower-percent} が同じままの場合、検出されるエッジコンポーネントは少なくなりますが、長さは同じになります。{+lower-percent} を増やしても {+upper-percent} が同じ場合、検出されるエッジコンポーネントの数は同じですが、長さは短くなります。デフォルトのしきい値が表示されます。

radius{xsigma} は、入力画像に適用されるガウスぼかしを制御して、ノイズを減らし、エッジを滑らかにします。

sigma の値は重要な引数であり、実際に発生するぼかしの量を決定します。

radius は、計算されたガウス分布を保持する配列のサイズを決定するためにのみ使用されます。これは整数である必要があります。指定されないか、ゼロに設定されている場合、IM はガウス分布に意味のある結果を提供する最大の半径を計算します。

-caption `string`

画像にキャプションを割り当てます。

このオプションは、このオプションが指定された後に読み込まれた画像のキャプションメタデータを設定します。メモリに既にある画像のキャプションを変更するには、「-set caption」を使用します。

キャプションには、Format and Print Image Properties にリストされている特別なフォーマット文字を含めることができます。これらの属性は、キャプションが最終的に個々の画像に割り当てられるときに展開されます。

string の最初の文字が @ の場合、画像のキャプションは文字列の残りの文字でタイトルが付けられたファイルから読み込まれます。ファイルから読み込まれたコメントはリテラルであり、埋め込まれた書式設定文字は認識されません。

キャプションのメタデータは画像自体には表示されません。それを表示するには、代わりに -annotate または -draw オプションを使用します。

たとえば、

-caption "%m:%f %wx%h"  bird.miff

は、MIFF:bird.miff 512x480 の画像キャプションを生成します (画像 bird.miff の幅が 512、高さが 480 であると仮定します)。

-cdl `filename`

色決定リストを使用して色補正します。

次に色補正コレクションの例を示します:

<?xml version="1.0" encoding="UTF-8"?>
<ColorCorrectionCollection xmlns="urn:ASC:CDL:v1.2">
  <ColorCorrection id="cc06668">
    <SOPNode>
      <Slope> 0.9 1.2 0.5 </Slope>
      <Offset> 0.4 -0.5 0.6 </Offset>
      <Power> 1.0 0.8 1.5 </Power>
    </SOPNode>
    <SATNode>
      <Saturation> 0.85 </Saturation>
    </SATNode>
  </ColorCorrection>
</ColorCorrectionCollection>

-channel `type`

後続の演算子が制限される画像カラーチャネルを指定します。

次から選択します: Red、Green、Blue、Alpha、Gray、 Cyan、Magenta、Yellow、Black、Opacity、Index、RGB、RGBA、CMYK、または CMYKA。

上記のチャネルは、カンマ区切りのリストとして指定することも、文字「R」、「G」、「B」、「A」、「O」、「C」、「M」、「Y」、「K」の連結として省略することもできます。

0 から 31 までの数字は、チャンネルを指定するためにも使用できます。0 から 5 は、次のようになります:

'0' は、次のようになります赤または Cyan

'1' は、次のようになります緑または Magenta

'2' は、次のようになります青または Yellow

'3' は、次のようになります Black

'4'等しいアルファまたは Opacity

'5' 等しい Index

たとえば、Red および Blue チャネルのみを選択するには、次のいずれかを使用できます:

-channel Red,Blue
-channel R,B
-channel RB
-channel 0,2

画像内に存在するすべてのチャネルは、特別なチャネルタイプ All を使用して指定できます。すべての演算子が「チャネル対応」であるわけではありませんが、一般的に「グレースケール」画像演算子である演算子は、この設定を理解します。個々の演算子のドキュメントを参照してください。

通常のチャネル選択に加えて、追加のフラグ「Sync」を指定できます。これはデフォルトでオンになっており、設定されている場合、このフラグを認識する演算子は、チャネルのクロスチャネル同期を実行する必要があります。指定されていない場合、ほとんどのグレースケール演算子は、各チャネル (-channel 設定の残りの部分で指定されているとおり) に画像処理操作を互いに完全に独立して適用します。

たとえば、-auto-level や -auto-gamma などの演算子の場合、カラーチャネルはまったく同じ方法で一緒に変更されるため、カラーは同期されたままになります。設定されていない場合、各チャネルは個別に独立して変更されるため、カラーの歪みが生じる可能性があります。

-morphology 'Convolve' メソッドと -compose 数学的メソッドは、'Sync' フラグも理解し、アルファチャネル (存在する場合) に応じてピクセルカラーの動作を変更します。つまり、完全に透明なカラーは最終結果に影響しないという理解のもとで、イメージ処理を変更します。

基本的に、デフォルトでは、演算子はカラーチャネルを同期して操作し、-channel 設定が変更されて 'Sync' フラグの影響が除去されない限り、透明度を特別なものとして扱います。各演算子がこれをどのように行うかは、その演算子の現在の実装によって異なります。現時点ではすべての演算子がこのフラグを理解するわけではありませんが、これは変更される予定です。

チャネルタイプの完全なリストを出力するには、-list channel を使用します。

デフォルトでは、ImageMagick は -channel を値 'RGBK,sync' に設定します。これは、オペレーターが透明度チャンネルを除くすべてのカラーチャンネルに作用し、すべてのカラーチャンネルがまったく同じ方法で変更されることを指定します (適用される操作によって異なります)。'plus' 形式の +channel は、値をこのデフォルトにリセットします。

-channel 設定の影響を受けるオプションには、次のものがあります。 -auto-gamma、-auto-level、-black-threshold、-blur、-clamp、-clut、-combine、-composite (数学的構成方法のみ)、-convolve、-contrast-stretch、-evaluate、-function、-fx、-gaussian-blur、-hald-clut、-motion-blur、-morphology、-negate、-normalize、-ordered-dither、-rotational-blur、-random-threshold、-range-threshold、-separate、-threshold、および -white-threshold。

警告: 一部の演算子は、+channel のデフォルト設定が有効な場合と、任意のユーザー定義の -channel 設定 (デフォルトと同等のものを含む) の場合で動作が異なります。これらの演算子は、新しい「Sync」フラグをまだ理解していません。

たとえば、-channel 設定が定義されていない場合、-threshold はデフォルトでしきい値処理の前に画像をグレースケール化します。これはまだ「同期」フラグで制御されていません。

また、-blur、-gaussian-blur などの一部の演算子は、「alpha」チャネルも -channel によって有効になっている場合、カラーチャネルの処理を変更します。通常、これは完全に透明な色が完全に透明として扱われるようにするために行われ、したがって、基になる「非表示」の色が最終結果に影響を与えません。通常は「ハロー」効果が発生します。ただし、新しい -morphology 畳み込み同等の演算子は「同期」フラグを認識し、デフォルトで透明度を正しく処理します。

画像内のアルファチャネルはオプションであるため、画像にアルファチャネルが存在しない場合に、一部の演算子は画像のカラーチャネルをグレースケールアルファマスクとして読み取ります。-channel 設定は、演算子にアルファチャネルを使用して操作を適用するように指示します。-clut 演算子は、この良い例です。

-channel-fx `expression`

1 つ以上の画像チャネルを交換、抽出、またはコピーします。

式は、1 つ以上のチャネル (ニーモニックまたは数値 (赤または 0、緑または 1 など)) で構成され、次のように特定の演算記号で区切られます。

<=>  exchange two channels (e.g. red<=>blue)
=>   copy one channel to another channel (e.g. red=>green)
=    assign a constant value to a channel (e.g. red=50%)
,    write new image with channels in the specified order (e.g. red, green)
;    add a new output image for the next set of channel operations (e.g. red; green; blue)
|    move to the next input image for the source of channel data (e.g. | gray=>alpha)

たとえば、画像の赤、緑、青のチャネルから 3 つのグレースケール画像を作成するには、次を使用します。

-channel-fx "red; green; blue"

演算記号のないチャネルは、分離を意味します (つまり、セミコロン)。

ここでは、sRGB 画像とグレースケール画像を取得し、グレースケール画像をアルファチャネルに挿入します。

magick wizard.png mask.pgm -channel-fx '| gray=>alpha' wizard-alpha.png

同様のコマンドを使用して読み取りマスクを定義します。

magick wizard.png mask.pgm -channel-fx '| gray=>read-mask' wizard-mask.png

この例では、画像のすべての不透明ピクセルの平均 RGB 値を計算します。

magick wizard-alpha.png -channel-fx "alpha=>read-mask" -channel rgb -format "%[fx:mean]\n" info:

2 つのメタチャネルを作成し、グレーピクセルのコピーをそこに配置してみましょう:

magick gray.pgm -channel-fx "gray=>meta, gray=>meta1" gray.tif

結果を TIFF 画像ファイルに保存することに注意してください。すべての形式がマルチスペクトル画像をサポートしているわけではありません。TIFF、MIFF、MPC、および FTXT はサポートしています。

チャネルの形態を追跡するには、-channel-fx オプションの前に -debug pixel を追加します。

-charcoal `factor`

木炭画をシミュレートします。

-chop `geometry`

画像の内部からピクセルを削除します。

ジオメトリ引数の詳細については、Image Geometry を参照してください。 geometry 引数の size 部分で指定される width と height は、削除する列と行の数を示します。geometry 引数の offset 部分は、存在する場合、-gravity 設定の影響を受けます。

-chop オプションは、行と列全体を削除し、残りのコーナーブロックを左と上に移動してギャップを閉じます。

内部のピクセルの行と列を削除できますが、通常は -gravity 設定とゼロオフセットを使用して、画像から 1 つのエッジを削除します。これを、画像の反対側から同じ数のピクセルを削除する -shave と比較してください。

-chop を使用すると、同じ geometry と -gravity 設定が指定された -splice の結果を効果的に元に戻すことができます。

-clahe `width`x`height`{%}{+}`number-bins`{+}`clip-limit`{!}

コントラスト制限適応ヒストグラム均等化。

画像は width ピクセルと height ピクセルのタイルに分割されます。% を追加すると、幅と高さを画像のサイズのパーセンテージとして定義できます。タイルのサイズは、保存する特徴のサイズよりも大きく、画像のアスペクト比を尊重する必要があります。! を追加すると、正確なタイル幅と高さを強制できます。number-bins は、タイルあたりのヒストグラムビンの数です (最小 2、最大 65536)。ヒストグラムビンの数は、1 つのタイルのピクセル数よりも小さくする必要があります。clip-limit は、コントラストの局所的な変更に対するコントラスト制限です。クリップ制限を 2 から 3 にするのが良い開始点です (例: -clahe 50x50%+128+3)。非常に大きな値を指定すると、ヒストグラム均等化によって必要な処理が実行され、ローカルコントラストが最大になります。値 1 を指定すると、元の画像になります。ビンの数とクリップ制限を省略すると、それぞれデフォルトで 128 とクリッピングなしになります。

-clamp

値が 0 未満の各ピクセルを 0 に設定し、値が量子範囲を超えるピクセルを量子範囲 (例: 65535) に設定します。それ以外の場合、ピクセル値は変更されません。

-clip

クリッピングパスが存在する場合は、それを適用します。

クリッピングパスが存在する場合は、後続の操作に適用されます。

たとえば、コマンドでは

magick cockatoo.tif -clip -negate negated.tif

クリッピングパス内のピクセルのみが否定されます。

-clip 機能には SVG サポートが必要です。SVG デリゲートライブラリが存在しない場合、オプションは無視されます。

後続の操作でクリッピングを無効にするには、+clip を使用します。

-clip-mask

このマスクで定義されたとおりに画像をクリップします。

現在の画像のアルファチャネルをマスクとして使用します。白い領域は、マスクが削除されるまで、後続の「画像処理演算子」によって変更されません。クリップマスクの黒い領域のピクセルは、演算子の要件に従って変更されます。

これは、長方形の -region を定義したり、3 つの画像 -composite 操作でマスク (3 番目) 画像のネガを使用したりすることに似ています (ただし、同じではありません)。

後続の操作でクリッピングを無効にするには、+clip-mask を使用します。

-clip-path `id`

8BIM プロファイルから名前付きパスに沿ってクリップします。

これは -clip と同じですが、画像に複数のパスがある場合に特定のクリップパスを選択する点が異なります。 ImageMagick は UTF-8 エンコードをサポートしています。名前付きパスが異なるエンコードになっている場合は、`iconv` を使用してクリップパス名をそのエンコードに変換してください。そうしないと、パス名が一致しません。

後続の操作でクリッピングを無効にするには、+clip-path を使用します。

-clone `index(s)`

1 つまたは複数の画像のクローンを作成します。

括弧内 (演算子が通常使用される場所) では、最後に「プッシュされた」画像シーケンスから画像のクローンを作成し、現在の画像シーケンスの末尾に追加します。括弧外 (推奨されません) では、現在の画像シーケンスから画像をクローンします。

シーケンス内のインデックスで画像を指定します。最初の画像はインデックス 0 です。負のインデックスは、シーケンスの末尾からの相対値です。たとえば、−1 はシーケンスの最後の画像を表します。画像の範囲はダッシュで指定します (例: 0−4)。複数のインデックスはスペースなしでコンマで区切ります (例: 0,2,5)。値 '0−−1 は、すべての画像を効果的に複製します。

+clone は、画像シーケンスの最後の画像のコピーを作成するだけなので、引数 '−1' を使用するのと同じです。

-clut

2 番目の画像の各対応するチャネルをカラールックuプロットテーブルとして使用して、最初の画像のチャネル値を置き換えます。

2 番目の (LUT) 画像は通常、各チャネルをどのように変更するかを示すヒストグラムマッピングを含むグラデーション画像です。通常、これは置換カラー値の 1 行または 1 列の画像です。1 行または 1 列より大きい場合は、左上から右下隅までの対角線から値が取得されます。

ルックアップは -interpolate 設定によってさらに制御されます。これは、ImageMagick でインストールされた品質 (Q) レベルで必要な全長ではない LUT に特に便利です。これに適した設定は 'bilinear' と 'catrom' です。Catom は、便利な 2 次連続性を返すことができます。

この演算子は、グレースケール画像を CLUT 画像の特定のカラーグラデーションに置き換えるのに特に適しています。

-channel 設定で定義されたチャネル値のみが置き換えられます。特に、デフォルトの -channel 設定は RGB であるため、-channel 設定を変更しない限り、透明度 (アルファ/マットチャネル) は影響を受けません。アルファチャネルが設定されると、-clut 演算子によって他のチャネルと同じように処理され、アルファ/マット値が元の画像のアルファ/マット値を使用して置き換えられることを意味します。

変更する画像またはルックアップ画像のいずれかに透明度が含まれていない (つまり、-alpha が「オフ」になっている) が、-channel 設定にアルファ置換が含まれている場合、その画像は置換アルファ値に使用されるグレースケールグラデーションを表すものとみなされます。つまり、グレースケール CLUT 画像を使用して既存の画像のアルファチャネルを調整したり、透明度を含む目的の色を含む CLUT の色を使用してグレースケール画像に色を付けたりすることができます。

3D カラーキューブの 2D 表現からフルカラー RGB 値のルックアップに従って色を置換する -hald-clut も参照してください。

-coalesce

GIF アニメーションシーケンスの各フレームの外観を完全に定義して、「フィルムストリップ」アニメーションを形成します。

-dispose メタデータに従って画像シーケンス内の各画像をオーバーレイし、アニメーションシーケンスの各ポイントでアニメーションの外観を再現します。すべての画像は同じサイズで、アニメーションが GIF アニメーションとして期待どおりに動作し続けるように、適切な GIF 処理設定が割り当てられている必要があります。このようなフレームは、高度に最適化された GIF オーバーレイ画像よりも簡単に表示および処理できます。

-layers メソッド 'optimize' を使用して処理した後、アニメーションを再最適化できますが、復元された GIF アニメーションの最適化が元の最適化よりも優れているという保証はありません。

-colorize `value`

最新の -fill 設定で指定された色を使用して、value で指定された量で画像を色付けします。

色付けの量をパーセントで指定します。カンマで区切られたカラー化値のリストを使用して、画像の赤、緑、青の各チャネルに個別のカラー化値を適用できます (例: -colorize 0,0,50)。

-colormap `type`

カラーマップタイプを定義します。

type は shared または private にすることができます。

このオプションは、デフォルトの X サーバービジュアルが PseudoColor または GrayScale の場合にのみ適用されます。詳細については、-visual を参照してください。デフォルトでは、共有カラーマップが割り当てられます。イメージは他の X クライアントと色を共有します。一部のイメージ色は近似される可能性があるため、イメージは意図したものと大きく異なる可能性があります。private を選択した場合、イメージ色は定義されたとおりに表示されます。ただし、イメージカラーマップがインストールされている場合、他のクライアントは technicolor になることがあります。

-colors `value`

イメージ内の優先色数を設定します。

イメージ内の実際の色数は、要求より少なくなることがありますが、それ以上になることはありません。これは色削減オプションであることに注意してください。 value で指定された色数よりも少ない固有の色を持つ画像では、重複した色や未使用の色が削除されます。既存のカラーパレットの順序は変更される場合があります。画像をカラーからグレースケールに変換する場合、色の数を減らす前に画像をグレーカラースペースに変換する方が効率的です。詳細については、color reduction algorithm を参照してください。

-color-matrix `matrix`

画像に色補正を適用します。

このオプションでは、彩度の変更、色相の回転、輝度からアルファへの変換、およびその他のさまざまな効果が可能です。可変サイズの変換マトリックスを使用できますが、通常は RGBA 画像には 5x5 マトリックスを使用し、CMYKA (またはオフセット付きの RGBA) には 6x6 マトリックスを使用します。このマトリックスは Adobe Flash で使用されるマトリックスに似ていますが、オフセットが 5 列目ではなく 6 列目にあること (CMYKA 画像をサポート) と、オフセットが正規化されている (Flash オフセットを 255 で割る) 点が異なります。

例として、オフセットを使用して画像にコントラストを追加するには、次のコマンドを試してください:

magick kittens.jpg -color-matrix \
  " 1.5 0.0 0.0 0.0, 0.0, -0.157 \
    0.0 1.5 0.0 0.0, 0.0, -0.157 \
    0.0 0.0 1.5 0.0, 0.0, -0.157 \
    0.0 0.0 0.0 1.0, 0.0,  0.0 \
    0.0 0.0 0.0 0.0, 1.0,  0.0 \
    0.0 0.0 0.0 0.0, 0.0,  1.0" kittens.png

-colorspace `value`

画像の色空間を設定します。

選択肢は次のとおりです:

CMY          CMYK         Gray         HCL
HCLp         HSB          HSI          HSL
HSV          HWB          Jzazbz       Lab
LCHab        LCHuv        LMS          Log
Luv          OHTA         OkLab        OkLCH
Rec601YCbCr  Rec709YCbCr  RGB          scRGB
sRGB         Transparent  xyY          XYZ
YCbCr        YCC          YDbDr        YIQ
YPbPr        YUV          Undefined

色空間の完全なリストを印刷するには、-list colorspace を使用します。

線形 RGB、CMYK、またはグレースケール色空間との間でより正確な色変換を行うには、-profile オプションを使用します。画像形式が特に指定されていない場合、ImageMagick は sRGB 色空間を想定します。色空間変換では、まずガンマ関数が削除されて線形 RGB が生成されます。

CMY
C=`QuantumRange`−R
M=`QuantumRange`−G
Y=`QuantumRange`−B
CMYK — CMY から始まる上記
K=min(C,Y,M)
C=`QuantumRange`*(C−K)/(`QuantumRange`−K)
M=`QuantumRange`*(M−K)/(`QuantumRange`−K)
Y=`QuantumRange`*(Y−K)/(`QuantumRange`−K)
グレー
グレー = 0.212656R+0.715158G+0.072186*B
HSB — 色相、彩度、明度。下向きの円錐のような形
H = 周囲の角度 (0 ～ 360 度)。H = 0 は赤。緑に向かって角度が増加
S = 軸から外側への距離
B = 下から上への軸に沿った距離。B = max(R,G,B); `intensity-like`
HSL — 色相、彩度、明度。両端から両端まで二重円錐のような形状で、最上部と最下部にピークがあります
H = 周囲の角度 (0 ～ 360 度)。H = 0 は赤。緑に向かって角度が増します
S = 軸から外側への距離
L = 下から上への軸に沿った距離。L = 0.5max(R,G,B) + 0.5min(R,G,B)。 `intensity-like`
HWB — 色相、白さ、黒さ
色相 (複雑な方程式)
白さ (複雑な方程式)
黒さ (複雑な方程式)
LAB
L (X、Y、Z に関連する複雑な方程式)
A (X、Y、Z に関連する複雑な方程式)
B (X、Y、Z に関連する複雑な方程式)
LinearGray
LinearGray = 0.298839R+0.586811G+0.114350*B
LOG
I1 (R の対数を含む複雑な方程式)
I2 (G の対数を含む複雑な方程式)
I3 (B の対数を含む複雑な方程式)
OHTA — 主成分を近似します変換
I1=0.33333R+0.33334G+0.33333*B; `intensity-like`
I2=(0.50000R+0.00000G−0.50000B)(`QuantumRange`+1)/2
I3=(−0.25000R+0.50000G−0.25000B)(`QuantumRange`+1)/2
Rec601Luma
グレー = 0.298839R+0.586811G+0.114350*B
Rec601YCbCr
Y=0.2988390R+0.5868110G+0.1143500*B; `intensity-like`
Cb=(−0.168736R-0.331264G+0.500000B)(`QuantumRange`+1)/2
Cr=(0.500000R−0.418688G−0.081312B)(`QuantumRange`+1)/2
Rec709Luma
グレー=0.212656R+0.715158G+0.072186*B
Rec709YCbCr
Y=0.212656R+0.715158G+0.072186*B; `intensity-like`
Cb=(−0.114572R−0.385428G+0.500000*B)+(`QuantumRange`+1)/2
Cr=(0.500000R−0.454153G−0.045847*B)+(`QuantumRange`+1)/2
sRGB
R ≤ .0.0031308 の場合、Rs=R/12.92、それ以外の場合は Rs=1.055 R ^ (1.0 / 2.4) - 0.055
G ≤ .0.0031308 の場合、Gs=B/12.92、それ以外の場合は Gs=1.055 R ^ (1.0 / 2.4) - 0.055
B ≤ .0.0031308 の場合、Bs=B/12.92、それ以外の場合、Bs=1.055 R ^ (1.0 / 2.4) - 0.055
XYZ
X=0.4124564R+0.3575761G+0.1804375*B
Y=0.2126729R+0.7151522G+0.072175 0*B
Z=0.0193339R+0.1191920G+0.9503041*B
YCC
Y=(0.298839R+0.586811G+0.114350*B) (複雑なスケーリングを使用) `intensity-like`
C1=(−0.298839R−0.586811G+0.88600*B) (複雑なスケーリングを使用)
C2=(0.70100R−0.586811G−0.114350*B) (複雑なスケーリングを使用)
YCbCr
Y=0.2988390R+0.5868110G+0.1143500*B; `intensity-like`
Cb=(−0.168736R−0.331264G+0.500000B)(`QuantumRange`+1)/2
Cr=(0.500000R−0.418688G−0.081312B)(`QuantumRange`+1)/2
YIQ
Y=0.298839R+0.586811G+0.114350*B; `intensity-like`
I=(0.59600R−0.27400G−0.32200B)(`QuantumRange`+1)/2
Q=(0.21100R−0.52300G+0.31200B)(`QuantumRange`+1)/2
YPbPr
Y=0.2988390R+0.5868110G+0.1143500*B; `intensity-like`
Pb=(−0.168736R−0.331264G+0.500000B)(`QuantumRange`+1)/2
Pr=(0.500000R−0.418688G−0.081312B)(`QuantumRange`+1)/2
YUV
Y=0.298839R+0.586811G+0.114350*B; `intensity-like`
U=(−0.14740R−0.28950G+0.43690B)(`QuantumRange`+1)/2
V=(0.61500R−0.51500G−0.10000B)(`QuantumRange`+1)/2

scRGB カラースペースには HDRI サポートが必要です。そうでない場合は、リニア RGB と同じように動作します。

マルチスペクトル画像を識別するには、Undefined カラースペースを使用します。

-color-threshold `start-color`-`stop-color`

指定された範囲内のすべての色が白に変更されたバイナリ画像を返します。他のすべての色は黒に変更されます。

-combine

+combine `colorspace`

1 つ以上の画像を 1 つの画像に結合します。

結合された画像のチャネル (以前は -channel で設定) は、シーケンス内の各画像のグレースケール値から順番に取得されます。デフォルトの -channel 設定 RGB の場合、これは最初の画像が Red チャネルに割り当てられ、2 番目が Green チャネルに割り当てられ、3 番目が Blue チャネルに割り当てられることを意味します。

このオプションは、チャネル設定が同じである限り、-separate の逆と考えることができます。したがって、次の例では、最終的な画像は元の画像のコピーになります。

magick original.png -channel RGB -separate sepimage.png
convert sepimage-0.png sepimage-1.png sepimage-2.png -channel RGB \
  -combine imagecopy.png

-comment `string`

画像にコメントを埋め込みます。

このオプションは、このオプションを指定した後に読み込まれた画像のコメントメタデータを設定します。すでにメモリ内にある画像のコメントを変更するには、「-set comment」を使用します。

コメントには、Format and Print Image Properties にリストされている特殊なフォーマット文字を含めることができます。これらの属性は、コメントが最終的に個々の画像に割り当てられるときに展開されます。

string の最初の文字が @ の場合、画像コメントは、文字列の残りの文字でタイトルが付けられたファイルから読み込まれます。ファイルから読み込まれたコメントはリテラルであり、埋め込まれたフォーマット文字は認識されません。

コメントメタデータは画像自体には表示されません。これを表示するには、代わりに -annotate または -draw オプションを使用します。

たとえば、

-comment "%m:%f %wx%h"  bird.miff

は、MIFF:bird.miff 512x480 の画像コメントを生成します (画像 bird.miff の幅が 512、高さが 480 であると仮定します)。

-compare

画像とその再構成の違いを数学的かつ視覚的に注釈付けします

これは、同じサイズの画像 2 枚に対する「compare」の変換バージョンです。構文は次のとおりですが、他のメトリックも使用できます。

magick image.png reference.png -metric RMSE -compare \  difference.png

メトリック値を取得するには、文字列形式「%[歪み]」を使用します。

magick image.png reference.png -metric RMSE -compare -format \
   "%[distortion]" info:

-complex `operator`

画像シーケンスに対して複雑な計算を実行します。次の演算子から選択します:

add
conjugate
divide
magnitude-phase
multiply
real-imaginary
subtract

オプションで、-define complex:snr=float とともに divide 演算子 SNR を指定します。

-compose `operator`

画像合成のタイプを設定します。

アルファ合成の詳細については、Alpha Compositing を参照してください。

この設定は、何らかの方法で 2 枚 (またはそれ以上) の画像を結合する画像処理演算子に影響します。これには、演算子 -compare、-composite、-layers 合成、-flatten、-mosaic、-layers 結合、-border、-frame、および -extent が含まれます。

これは、「composite」コマンドの主要オプションの 1 つでもあります。

-composite

2 つの画像とオプションのマスクに対してアルファ合成を実行します

最初の画像の「宛先」を取得し、現在の -compose 設定に従って 2 番目の「ソース」画像をオーバーレイします。「ソース」または「オーバーレイ」画像の位置は、-gravity および -geometry 設定に従って制御されます。

3 番目の画像が指定された場合、これは最初の「宛先」画像に対するグレースケールブレンディング「マスク」画像として扱われます。このマスクはソース画像とブレンドされます。ただし、「displace」合成方法では、マスクは代わりに別の Y 変位画像を提供するために使用されます。

-compose 方法で追加の数値引数またはフラグが必要な場合は、合成方法に適切に -set 'option:compose:args' を設定することでこれらを提供できます。

一部の -compose 方法では、オーバーレイ領域外の「宛先」画像を変更できます。デフォルトでは無効になっています。定義 -define 'compose:clip-to-self=true' を設定することで、これを有効にできます。

SVG 合成仕様では、色と不透明度の値は 0 から QuantumRange までの範囲である必要があります。このオプションを使用すると、この範囲外の値を許可できます: -set 'option:compose:clamp=false

-compress `type`

イメージを書き込むときに、type で指定されたピクセル圧縮を使用します。

選択肢は、None、BZip、Fax、Group4、JPEG、JPEG2000、Lossless、LZW、RLE、または Zip です。

圧縮タイプの完全なリストを出力するには、-list compress を使用します。

バイナリイメージを非圧縮形式で保存するには、+compress を指定します。デフォルトは、指定されたイメージファイルの圧縮タイプです。

LZW 圧縮が指定されているが、LZW 圧縮が有効になっていない場合、イメージデータは LZW デコーダーで読み取ることができる非圧縮 LZW 形式で書き込まれます。これにより、予想よりも大きい GIF ファイルが生成される可能性があります。

Lossless はロスレス JPEG を指し、JPEG ライブラリがこれをサポートするようにパッチされている場合にのみ使用できます。ロスレス JPEG の使用は一般に推奨されません。

ICO ファイルを書き込むときに、Zip 圧縮を指定して、イメージを PNG 形式でエンコードするように要求できます。

JNG ファイルを書き込むときに、アルファチャネルを PNG "IDAT" 形式でエンコードするように要求するには Zip 圧縮を指定し、JPG "JDAA" 形式でエンコードするように要求するには JPEG を指定します。

JPEG、PNG、MIFF、および MPEG エンコーダーで使用する圧縮レベルを設定するには、-quality オプションを使用します。クロマチャネルをダウンサンプリングするために JPEG、MPEG、および YUV エンコーダーで使用するサンプリング係数を設定するには、-sampling-factor オプションを使用します。

-connected-components `connectivity`

connected-components ラベル付けは、画像内の接続された領域を検出します。4 方向または 8 方向の接続から選択します。

-define connected-components:verbose=true を使用して、一意のラベルに関連付けられた統計情報を出力します。

-contrast

画像のコントラストを強めたり弱めたりします。

このオプションは、画像の明るい要素と暗い要素の間の強度差を強めます。画像を強化するには -contrast を使用し、画像のコントラストを弱めるには +contrast を使用します。

より顕著な効果を得るには、このオプションを繰り返します:

magick rose: -contrast -contrast rose_c2.png

-contrast-stretch `black-point`

画像のコントラストを強度値の範囲で強めます。

ストレッチの実行中、最大 black-point ピクセルをブラックアウトし、最大 white-point ピクセルをホワイトアウトします。または、パーセントを使用する場合は、最大 black-point % ピクセルをブラックアウトし、最大 white-point % ピクセルをホワイトアウトします。

ImageMagick 6.4.7-0 より前のバージョンでは、-contrast-stretch は最大 black-point ピクセルをブラックアウトし、最大 total pixels minus white-point ピクセルをホワイトアウトします。または、パーセントが使用されている場合は、最大 black-point % ピクセルをブラックアウトし、最大 100% minus white-point % ピクセルをホワイトアウトします。

-contrast-stretch 0 は、画像の最小値と最大値がそれぞれ 0 と QuantumRange に引き伸ばされるように画像を変更しますが、両端のバーンアウトやクリッピングによるデータの損失はありません。これは -normalize とは異なります。-normalize は -contrast-stretch 0.15x0.05% (または ImageMagick 6.4.7-0 より前のバージョンでは -contrast-stretch 2%x99%) に相当します。

内部的には、演算子はヒストグラムビンを作成し、そのビンを使用して画像を変更します。そのため、一部の色は、元々同じ「ビン」に入っていたのに、一緒にマージされることがあります。

デフォルトの +channel 設定が使用されている場合、色の整合性を保つために、すべてのチャネルが同じ量で同時に正規化されます。その他の -channel 設定を指定すると、RGB チャネルが個別に正規化されます。

数学的画像の「完全な」正規化については、-auto-level も参照してください。

この演算子は、再開発のために検討中です。

-convolve `kernel`

ユーザーが指定した畳み込みカーネルを使用して画像を畳み込みます。

kernel は、一番上の行から左から右に並べられた、コンマで区切られた整数のリスト (スペースなし) として指定される行列です。現在、奇数次元のカーネルのみがサポートされているため、指定された kernel のエントリ数は、3²=9、5²=25、7²=49 などである必要があります。

-convolve 演算子は -bias 設定をサポートすることに注意してください。このオプションは、畳み込みをシフトして、正と負の結果がユーザー指定のバイアス値に相対的になるようにします。これは、負の値と正の値を含む畳み込みを処理する ImageMagick の非 HDRI コンパイルにとって重要です。これは、ハイパスフィルターまたはエッジ検出を含む畳み込みの場合に特に当てはまります。出力バイアスがない場合、負の値はゼロでクリップされます。

HDRI コンパイル時設定で ImageMagick を使用する場合、ImageMagick はカラー値の範囲 (0..QuantumRange) にクリップすることなく負の結果を格納/処理できるため、-bias は必要ありません。High Dynamic-Range Images ページの ImageMagick の HDRI 実装に関する説明を参照してください。HDRI の詳細については、ImageMagick Usage ページまたはこの Wikipedia エントリを参照してください。

-copy `geometry` `offset`

イメージの 1 つの領域から別の領域にピクセルをコピーします。

-crop `geometry`{`@`}{`!`}

イメージの 1 つ以上の長方形領域を切り取ります。

ジオメトリ引数の詳細については、Image Geometry を参照してください。

geometry 引数の width と height は、切り取った後に残る画像のサイズを指定します。offset (存在する場合) の x と y は、切り取った画像の左上隅の元の画像に対する位置を指定します。削除する量を指定するには、代わりに -shave を使用します。

x および y オフセットが存在する場合、切り取り領域のピクセルで構成される単一の画像が生成されます。オフセットは、画像の左上隅を基準として下方向および右方向に測定された切り取り領域の左上隅の位置を指定します。-gravity オプションが NorthEast、East、または SouthEast グラビティとともに存在する場合、画像の右端から切り取り領域の右端までの左方向の距離が示されます。同様に、-gravity オプションが SouthWest、South、または SouthEast グラビティとともに存在する場合、下端間の距離は上方向に測定されます。

x および y オフセットが省略されている場合、入力画像全体をカバーする、指定されたジオメトリのタイルのセットが生成されます。指定されたジオメトリが入力画像のサイズを超える場合、右端のタイルと下のタイルは小さくなります。

@ をジオメトリ引数に追加すると、生成されたタイルの数に画像を均等に分割できます。

ジオメトリ引数に感嘆符フラグを追加すると、切り取られた画像の仮想キャンバスページサイズとオフセットは、ジオメトリ引数がビューポートまたはウィンドウであるかのように設定されます。つまり、キャンバスページサイズは指定したサイズとまったく同じに設定され、画像オフセットは切り取られた領域の左上隅を基準に設定されます。

切り取られた画像が仮想キャンバス上の実際の画像を「見逃した」場合、特別な 1 ピクセルの透明な「見逃した」画像が返され、「切り取りが失敗した」という警告が表示されます。

切り取り座標フレームが表示画像の左上隅に再配置されるように、画像をトリミングする前に +repage を実行する必要がある場合があります。同様に、切り取り後に +repage を使用して、残されるページオフセットを削除することもできます。これは、画像オフセットをサポートする PNG などの画像形式に書き込む場合に特に当てはまります。

-cycle `amount`

画像のカラーマップを量で移動します。

Amount は、各カラーマップエントリがシフトされる位置の数を定義します。

-debug `events`

デバッグプリントアウトを有効にします。

events パラメータは、ログに記録するイベントを指定します。これは、None、All、Trace、または次のドメインの 1 つ以上で構成されるコンマ区切りのリストのいずれかです: Accelerate、Annotate、Blob、Cache、Coder、Configure、Deprecate、Exception、Locale、Render、Resource、Security、TemporaryFile、Transform、X11、または User。

たとえば、キャッシュイベントと BLOB イベントをログに記録するには、次を使用します。

magick -debug "Cache,Blob" rose: rose.png

User ドメインは通常は空ですが、開発者は ImageMagick のプライベートコピーでユーザーイベントをログに記録できます。

デバッグメソッドの完全なリストを出力するには、-list debug を使用します。

-log オプションを使用して、デバッグ出力の形式を指定します。

+debug を使用して、すべてのログ記録をオフにします。

デバッグは、MAGICK_DEBUG environment variable を使用して設定することもできます。MAGICK_DEBUG 環境変数に許可される値は、-debug オプションの場合と同じです。

-decipher `filename`

-encipher によって以前に変換されたピクセルを解読して復元します。

filename で指定されたファイルからパスフレーズを取得します。

詳細については、Web ページ ImageMagick: Encipher or Decipher an Image を参照してください。

-deconstruct

画像間で変更された領域を検索

-coalesce で生成されるような、すべて同じサイズの一連の画像がある場合、2 番目以降の画像を、前の画像と比較して変化した領域のみの小さい画像に置き換えます。

結果の画像シーケンスは、アニメーションシーケンスを最適化するために使用できますが、アニメーションの一部が不透明から透明に変わる可能性がある GIF アニメーションでは正しく機能しません。

このオプションは、実際には -layers メソッド 'compare-any' と同等です。

-define `key`{`=value`}`...`

コーダと画像処理操作を制御するために一般的に使用される特定のグローバル設定を追加します。

このオプションは、コーダとデコーダが画像データの読み取りと書き込み時に使用する 1 つ以上の定義を作成します。定義は、通常提供されるものを超えて、画像ファイル形式のコーダモジュールや画像処理操作を制御するために一般的に使用されます。定義された設定は、-verbose 情報 ("info:" 出力形式) に "Artifacts" としてリストされます。

定義に value がない場合、その名前でフラグの空の値の定義が作成されます。これは、オン/オフオプションを制御するために使用されます。以前に作成された定義を削除するには、+define key を使用します。既存の定義をすべて削除するには、+define "*" を使用します。

同じ「アーティファクト」設定は、-set "option:key" "value"オプションを使用して定義することもできます。このオプションでは、定義値で Format and Print Image Properties も使用できます。

option と key は大文字と小文字を区別しません (デコーダー内で使用するために小文字に変換されます)。一方、value は大文字と小文字を区別します。

このような設定はグローバルスコープであり、すべてのイメージと操作に影響します。

magick bilevel.tif -define ps:imagemask eps3:stencil.ps

値の前に registry: を付けて、イメージレジストリの属性を設定します。たとえば、作業ファイルを配置する一時パスを設定するには、次を使用します:

-define registry:temporary-path=/data/tmp

-delay `ticks`

一時停止後に次の画像を表示します。

このオプションは、画像シーケンスのアニメーションを制御するのに役立ちます。次の画像が表示されるまでに、ticks/ticks-per-second 秒経過する必要があります。デフォルトでは、画像シーケンスの表示間に遅延はありません。デフォルトの 1 秒あたりのティック数は 100 です。

> を使用して、現在の値が指定された遅延を超える場合に画像遅延 only を変更します。< は、現在の値が指定された遅延よりも小さい場合に画像遅延 only を変更します。たとえば、30> を指定し、画像遅延が 20 の場合、画像遅延は変更されません。ただし、イメージ遅延が 40 または 50 の場合、遅延は 30 に変更されます。指定された遅延を引用符で囲むと、< または > がシェルによってファイルリダイレクトとして解釈されるのを防ぐことができます。

-delete `indexes`

インデックスで指定されたイメージをイメージシーケンスから削除します。

シーケンス内のインデックスでイメージを指定します。最初のイメージはインデックス 0 です。負のインデックスはシーケンスの最後からの相対値です。たとえば、-1 はシーケンスの最後のイメージを表します。イメージの範囲をダッシュで指定します (例: 0-4)。インデックスはコンマで区切ります (例: 0,2)。+delete を使用すると、現在のイメージシーケンスの最後のイメージが削除されます。-delete 0--1 を使用すると、イメージシーケンス全体が削除されます。

永続レジストリからイメージを削除することもできます (例: -delete registry:checkers)

-density `width`

デバイスにレンダリングするためのイメージの水平解像度と垂直解像度を設定します。

このオプションは、ラスター画像をエンコードするときに保存する画像解像度、または Postscript、PDF、WMF、SVG などのベクター形式をラスター画像にレンダリング (読み取り) するときに使用するキャンバス解像度を指定します。画像解像度は、出力デバイスまたはラスター画像にレンダリングするときに適用する測定単位を提供します。デフォルトの測定単位は、1 インチあたりのドット数 (DPI) です。代わりに -units オプションを使用して、1 センチメートルあたりのドット数を選択することもできます。

デフォルトの解像度は 72 ドット/インチで、これは 1 ピクセルあたり 1 ポイントに相当します (Macintosh および Postscript 標準)。コンピューターの画面は通常 72 または 96 ドット/インチですが、プリンターは通常 150、300、600、または 1200 ドット/インチをサポートします。

ファイル形式でサポートされている場合、このオプションを使用して、保存されている画像解像度を更新できます。Photoshop は、独自の埋め込みプロファイルから画像解像度を保存および取得することに注意してください。このプロファイルが画像から削除されない場合、Photoshop は標準ファイルヘッダーで指定された画像解像度を無視して、以前の解像度を使用して画像を引き続き処理します。

-density オプションは attribute を設定し、基になるラスター画像を変更しません。このオプションは、ピクセルに適用されるスケールを調整することで、デスクトップパブリッシングの目的でレンダリングサイズを調整するために使用できます。画像のピクセル数を変更して、同じ物理寸法 (インチまたはセンチメートル) にするには、-resample オプションを使用します。

-depth `value`

画像の深度。

色深度は、各ピクセルのチャネルあたりのビット数です。たとえば、RGB を使用して深度を 16 にする場合、赤、緑、青の各チャネルは 0 から 2^16-1 (65535) の範囲になります。このオプションを使用して、GRAY、RGB、CMYK などの深度が不明な RAW 画像形式の深度を指定したり、読み込んだ後に画像の深度を変更したりできます。デフォルトでは、ピクセル深度を減らすと、上位ビットが切り捨てられます。代わりに -dither FloydSteinberg を使用して、量子化誤差を隣接するピクセルに分配します。

+depth を使用して、深度をデフォルト値に戻します。

-descend

ウィンドウ階層を降順で進んで画像を取得します。

-deskew `threshold{%}`

画像をまっすぐにします。ほとんどの画像では、しきい値を 40% にするとうまくいきます。

-set option:deskew:auto-crop true | false を使用して、画像を自動的にトリミングします。

-despeckle

画像内の斑点を減らします。

-direction `type`

テキストを右から左または左から右にレンダリングします。RAQM デリゲートライブラリと complex text layout が必要です。

-displace `horizontal-scale`{%}{!}

変位マップで定義されたとおりに画像ピクセルをシフトします。

このオプションでは、「オーバーレイ」画像とオプションで「マスク」画像が変位マップとして使用され、オーバーレイ領域の各ポイントで「背景」画像のどの部分が表示されるかのルックアップを変位するために使用されます。変位マップは、透過する光の方向を変えて、その背後にある元の「背景」画像を歪んだビューで表示する「レンズ」とよく似ています。

変位マップの完全なグレー領域は、画像の変位をゼロにします。黒い領域は、ルックアップポイントの指定された最大の負の変位を生成し、白い領域はルックアップの最大の正の変位を生成します。

変位されるのは「背景」の参照であり、画像自体の変位ではないことに注意してください。そのため、変位マップの「白」を含む領域では、参照ポイントが正の量だけ「シフト」され、正しい位置から右/下方向に宛先画像のコピーが生成されます。つまり、画像は負の左/上方向に「シフト」されたように見えます。これを理解することは、変位マップの仕組みを理解する上で非常に重要です。

指定された引数は、特定のマップが生成できるピクセル単位の最大変位量を定義します。変位スケールが十分に大きい場合は、変位マップ自体の境界をはるかに超えた「背景」画像の部分を参照することもできます。つまり、オーバーレイ領域の外側にある元の画像の一部をオーバーレイ領域に非常に簡単にコピーできます。

'%' フラグは、オーバーレイ画像のサイズを基準にして変位スケールを設定します (100% = 画像の幅/高さの半分)。'!' を使用すると、パーセンテージ引数が、代わりに宛先画像のサイズを参照するように切り替わります。これらのフラグは、IM v6.5.3-5 で追加されました。

通常、単一のグレースケール変位マップが提供され、指定されたスケーリング値を使用して、変位が発生する可能性のある単一の方向 (ベクトル) が決定されます (正または負)。ただし、通常 mask として使用される 3 番目の画像も指定すると、composite image は水平 X 変位に使用され、mask image は垂直 Y 変位に使用されます。これにより、X 方向と Y 方向に完全に異なる変位値を定義でき、scale 境界内の任意のポイントを参照できます。つまり、各ピクセルは他の近くのピクセルを参照できるため、単純な 1 次元ベクトル変位ではなく、複雑な 2 次元変位が生成されます。

または、IM v6.4.4-0 以降では、2 つの個別の画像を提供する代わりに、オーバーレイ画像の「赤」チャネルを使用して水平または X 変位を指定し、「緑」チャネルを使用して垂直または Y 変位を指定できます。

IM v6.5.3-5 以降、オーバーレイイメージ内のアルファチャネルは、宛先イメージの透明度のマスクとして使用されます。ただし、オーバーレイ領域外の領域は影響を受けません。

-display `host:display[.screen]`

接続する X サーバーを指定します。

このオプションは、この X サーバーからイメージまたはフォントを取得するために convert で使用されます。X(1) を参照してください。

-dispose `method`

作成中または読み込まれている画像の GIF 破棄画像設定を定義します。

レイヤー破棄方法は、アニメーションの現在の「フレーム」の表示が終了した後 (「遅延」期間後)、アニメーションの次のフレームがディスプレイにオーバーレイされる前に、表示されている各画像を変更する方法を定義します。

有効な方法は次のとおりです:

未定義: 0: 破棄が指定されていません ('none' と同等)。
なし: 1: 破棄せず、次のフレーム画像をオーバーレイするだけです。
背景: 2: 背景色でフレーム領域をクリアします。
前: 3: このフレームオーバーレイの前の画像にクリアします。

上記の数値を使用することもできます。これは、GIF 形式が上記の設定を表すために内部的に使用するものです。

破棄方法の完全なリストを出力するには、-list dispose を使用します。

+dispose を使用して設定をオフにし、読み込まれる画像のレイヤー処理方法がリセットされないようにします。

-set 'dispose' メソッドを使用して、メモリにすでに存在する画像の画像処理方法を設定します。

-dissimilarity-threshold `value`

サブイメージマッチの最大 RMSE (デフォルト 0.2)。

-dissolve `src_percent`[x`dst_percent`]

指定されたパーセントで画像を別の画像に溶解します。

合成画像の不透明度に指定されたパーセントを掛けて、メイン画像の上に合成します。 src_percent が 100 より大きい場合、メインイメージの溶解を開始し、'200' の値で透明になります。両方のパーセンテージが指定されている場合は、各イメージが指定されたパーセンテージまで溶解されます。

溶解パーセンテージは加算されないことに注意してください。2 つの不透明なイメージを '50,50' で溶解すると、75% の透明度が生成されます。2 つのイメージを 50% + 50% でブレンドするには、溶解値 '50,100' を使用する必要があります。

-distort `method arguments`

指定された method と必要な arguments を使用して、イメージを歪めます。

arguments は、カンマまたはスペースで区切られた浮動小数点数のリストを含む単一の文字列です。浮動小数点値の数と意味は、使用されている歪み method によって異なります。

次の歪みタイプから選択します:

方法	説明
ScaleRotateTranslate	まず、指定された「中心」を中心に拡大縮小および回転し、その「中心」を新しい場所に移動して、画像を歪めます。これは、「アフィン」タイプの歪みを指定する代替方法ですが、せん断効果はありません。また、小さな画像を回転および移動して、大きな背景 (つまり 2 次元アニメーション) に並べるのに適した方法でもあります。
アフィン	少なくとも 3 セット以上の制御点 (以下に定義) のリストを移動して、画像を線形に歪ませます。理想的には、3 セットまたは 12 個の浮動小数点値を指定して、それらの 3 つの点に従って画像を線形に拡大縮小、回転、傾斜、および移動できるようにします。関連する「AffineProjection」および「SRT」歪みも参照してください。
RigidAffine	RigidAffine (ユークリッド変換とも呼ばれます) は Affine に似ていますが、歪みを 4 つの引数 (S、R、Tx、Ty) に制限し、Sy = Sx、Ry = -Rx とすることで、歪みはスケール、回転、および平行移動のみになります。スキューはありません。最低 2 つのコントロールポイントペアが必要です。
AffineProjection	指定されたアフィンマトリックス (6 つの事前計算された係数) を使用して画像を線形に歪ませ、アフィン方程式のセットを形成してソース画像を宛先画像にマッピングします。詳細とこれらの係数の意味については、-affine 設定を参照してください。
BilinearForward	双線形歪み。最低 4 セットの座標ペア、または 16 個の値 (下記参照) が指定されます。歪みの後、線がまっすぐに表示されない場合がありますが、座標間の距離は一定のままです。
パースペクティブ	パースペクティブは、4 セット以上の制御点のリスト (下記で定義) を使用して画像を歪ませます。制御点が 4 セット (16 個) を超えると、最小二乗法が使用され、より正確な歪みが得られます (画像登録およびパノラマ効果用)。4 セット未満の場合は、「アフィン」線形歪みになります。
PerspectiveProjection	8 つの事前計算された係数のセットに基づいて「パースペクティブ」歪みを実行します。これらの係数は、「パースペクティブ」歪みの -verbose 出力を確認するか、自分で計算することで取得できます。最後の 2 つのパースペクティブスケーリング係数がゼロの場合、残りの 6 つは転置された「アフィンマトリックス」を表します。
多項式	対応する制御点のセットを使用して、N 次 2D「多項式」歪みを実行します。多項式の次数によって、必要な制御点の最小数が決定されます。次数 1 は -distort Affine と同じです。次数 1.5 は -distort BilinearReverse と同じです。通常は 2 次歪みに使用します。+distort 多項式はありません。
円弧	画像を円周上の指定された角度で円弧にします (極座標マッピングのバリエーション)。結果の画像は常に、結果の画像に最も合うようにサイズ変更されます (+distort を使用した場合と同様)。その際、ユーザーが指定した引数を使用して、元の画像のスケールとアスペクト比を可能な限り維持しようとします。「円弧」された画像の全体的なアスペクト比を変更するには、4 つの引数すべてが必要になります。
極座標	「円弧」に似ていますが、画像の完全な直交座標から極座標へのマッピングを行います。つまり、入力画像の高さは半径の制限にマッピングされ、幅は角度の制限の間で折り返されます。
DePolar	「Polar」歪みと同じ引数と意味を使用しますが、逆の極座標から直交座標への歪みを生成します。
Barrel	Helmut Dersch で定義されている 4 つの係数 (A、B、C、D) に基づいて、放射状レンズ歪みを補正するのに適した樽型または糸巻き型歪みを実行します。つまり、写真では、直線を再びまっすぐにします。
BarrelInverse	これは、「Barrel」と非常によく似ており、引数のセットと引数の処理は同じです。ただし、ラジアル多項式の逆関数を使用するため、関数が形成されます。これは「バレル」歪みの逆ではなく、単に異なるバレルのようなラジアル歪み方法であることに注意してください。
Shepards	逆二乗距離補間法 (Shepards Method) を使用して、指定されたリストのコントロールポイント (任意の数) を歪めます。制御点は、実際には、指定された制御点の周囲で画像を「局所的に」移動させます (制御点付近の領域の外観と回転は保持されます)。最良の結果を得るには、角、端、および画像のその他の不変部分の位置を「固定」して、それらの移動を防止するために、追加の制御点を追加する必要があります。

歪み方法の完全なリストを出力するには、-list distort を使用します。

上記の「Affine」、「Perspective」、「Shepards」などの歪み方法の多くは、指定された画像内のこれらの点を宛先画像でどのように歪ませるかを定義する制御点のリストを使用します。4 つの浮動小数点値の各セットは、ソース画像の座標を表し、その直後に宛先画像の座標が続きます。これにより、次のような値のリストが生成されます。として...

U₁,V₁ X₁,Y₁ U₂,V₂ X₂,Y₂ U₃,V₃ X₃,Y₃ ... U_n,V_n X_n,Y_n

ここで、ソースイメージの U,V は、宛先イメージの X,Y にマップされます。

たとえば、'perspective' 歪みを使用してイメージをワープするには、少なくとも 4 セットの座標、つまり 16 個の数値のリストが必要です。組み込みの "rose:" イメージの遠近法の歪みを次に示します。読みやすく理解しやすいように、4 セットの座標ペアをグループ化するためにスペースが使用されていることに注意してください。

magick rose:  -virtual-pixel black \
  -distort Perspective '0,0,0,0  0,45,0,45  69,0,60,10  69,45,60,35' \
   rose_3d_rotated.gif"

歪みに必要な数よりも多くの座標ペアが指定されている場合、歪み方法は、指定されたすべての座標ペアに対して最適な結果を生成するように「最小二乗法」で適合されます。理想的なポイント数よりも少ないポイント数が指定された場合、歪みは通常、より少ない数の座標を処理できるより単純な形式の歪み (通常は線形の「Affine」歪み) にフォールバックします。

より多くの座標を使用すると、画像登録ツールを使用して、重なり合う画像内で一致する座標ペアを見つけ、歪みの「適合」を改善できます。もちろん、座標ペアが間違っていると「適合」が悪くなることもあります。常に注意することをお勧めします。

色は、EWA 再サンプリングと呼ばれる特殊な手法を使用して、円筒形再サンプリング -filter に従ってソース画像から取得されます。これにより、特に出力で画像が小さくなる (縮小される) 場合に非常に高品質の結果が生成されます。これは、「perspective」歪みを使用する場合に非常に一般的です。たとえば、ここでは無限にタイル張りされた「平面」を地平線まで表示しています。

magick -size 90x90 pattern:checkerboard -normalize -virtual-pixel tile \
  -distort perspective  '0,0,5,45  89,0,45,46  0,89,0,89  89,89,89,89' \
   checks_tiled.jpg

地平線を含む無限にタイル張りされた遠近法の画像は、圧縮されて「地平線」に近い個々のピクセルを生成するピクセルの数が多いため、非常に遅くなる可能性があることに注意してください。 'point' の特別な -filter 設定を指定することで、EWA の再サンプリングをオフにできます (代わりにスーパーサンプリングを使用する予定の場合は推奨)。

最後の例の「空」のように、画像が無効なピクセルを生成する場合、-distort はこれらのピクセルに対して現在の -mattecolor 設定を使用します。これらのピクセルを表示したくない場合は、地面の残りの部分と一致するように色を設定します。

出力画像のサイズは、デフォルトでは入力画像と同じになります。つまり、歪んだ画像の一部が「歪んだ空間」の表示領域外にある場合、その部分は切り取られて失われます。ただし、演算子のプラス形式 (+distort) を使用すると、演算子は (可能であれば) 画像のレイヤー化のために正しい「仮想キャンバス」オフセットを維持しながら、歪んだ画像全体を表示しようとします。このオフセットは、不要であれば +repage を使用して削除する必要がある場合があります。

-verbose 設定を設定すると、-distort は内部係数と歪みに相当する -fx を出力しようとします。これは専門家による調査やデバッグの目的で使用されます。これはすべての歪みに対して使用できるわけではありません。

代わりに、特別な "-define distort:viewport={geometry_string}" 設定を指定して、歪んだ画像空間の生成された「ビューポート」画像のサイズとオフセットを指定することもできます。

"-define distort:scale=scale_factor" を設定すると、歪んだ画像の表示内容を変更せずに、出力画像 (ビューポートなど) がその係数で拡大縮小されます。これは、画像を「スーパーサンプリング」して高品質の結果を得るため、または画像をパンおよびズームするために使用できます (適切なビューポートの変更、または歪み後の切り取りとサイズ変更を使用)。

「-define resample:verbose=1」を設定すると、EWA (楕円加重平均) 再サンプリングアルゴリズムによって作成された円筒形フィルタールックアップテーブルが出力されます。このテーブルでは、2 乗半径ルックアップ値が使用されることに注意してください。これは通常、EWA 再サンプリングのデバッグにのみ使用されます。

-distribute-cache `port`

分散ピクセルキャッシュサーバーを起動します。

-dither `method`

オプションによって一般的な減色が適用された場合、または特定の形式で保存する場合に自動的に、Riemersma または Floyd-Steinberg 誤差拡散ディザを画像に適用します。これはデフォルトで有効になっています。

ディザリングは、隣接するピクセルに 2 つ以上の色を配置して、目には画像の元の色に近い色が再現されるようにします。これにより、画像を再現するために必要な色の数は減りますが、色のパターンのレベルは低くなります。誤差拡散ディザリングでは、画像に任意の色のセット (生成された色またはユーザー定義の色) を使用できます。

ディザリングはデフォルトでオンになっています。オフにするには、設定のプラス形式 +dither を使用します。これにより、テキストやグラフィックのエイリアシングなしで PostScript もレンダリングされます。ディザリングを無効にすると、多くの場合 (常に無効になるわけではありませんが)、処理が高速化され、色数が少なくなりますが、画像の色付けは漫画のような感じになります。通常、色のグラデーションがある領域では「色のバンディング」効果が発生します。

減色演算子 -colors、-monochrome、-remap、および -posterize は、作成された減色セットを使用して画像にディザリングを適用します。これらの演算子は、GIF:、XBM: などの色サポートが制限された形式で画像を保存するときに、自動減色の一部としても使用されるため、このような場合にもディザリングを使用できます。

または、-random-threshold を使用して、完全にランダムなディザを生成することもできます。または、-ordered-dither を使用して、特定のカラーマップではなく均一なカラーマップを使用して、しきい値マップされたディザパターンを適用します。

たとえば、"-define dither:diffusion-amount=35% を使用して、Floyd-Steinberg ディザの量を制御します。

-draw `string`

1 つ以上のグラフィックプリミティブを使用してイメージに注釈を付けます。

このオプションを使用して、1 つ以上のグラフィックプリミティブを使用してイメージに注釈を付けたり装飾したりします。プリミティブには、図形、テキスト、変換、ピクセル操作が含まれます。

図形プリミティブ:

点: x,y
線: x0,y0 x1,y1
長方形: x0,y0 x1,y1
丸い長方形: x0,y0 x1,y1 wc,hc
円弧: x0,y0 x1,y1 a0,a1
楕円: x0,y0 rx,ry a0,a1
円: x0,y0 x1,y1
折れ線: x0,y0 ... xn,yn
ポリゴン: x0,y0 ... xn,yn
ベジェ: x0,y0 ... xn,yn
パス: 仕様
画像: 演算子 x0,y0 w,h ファイル名

テキストプリミティブ:

テキスト: x0,y0 文字列

テキスト重力プリミティブ:

重力: 北西、北、北東、西、中心、東、南西、南、または南東

テキストグラビティプリミティブはテキストの配置にのみ影響し、他のプリミティブとは相互作用しません。これは、表示される -draw オプションに範囲が制限されることを除けば、-gravity コマンドラインオプションを使用するのと同じです。

変換プリミティブ:

回転: 度
平行移動: dx,dy
スケール: sx,sy
skewX: 度
skewY: 度

ピクセル操作プリミティブ:

色: x0,y0 方式
マット: x0,y0 方式

シェイププリミティブは、前の -fill 設定で指定された色で描画されます。塗りつぶされていないシェイプの場合は、-fill none を使用します。オプションで、-stroke および -strokewidth 設定を使用して、ストローク (シェイプの「アウトライン」) を制御できます。

point プリミティブは、ピクセルプレーン内の単一の point、つまり、整数座標の順序付きペア x、y で指定されます。 (point プリミティブは 1 つのピクセルのみに関係するため、-stroke または -strokewidth の影響を受けません。)

line プリミティブには開始点と終了点が必要です。

rectangle プリミティブは、左上隅と右下隅の 2 つの点によって指定されます。

roundRectangle プリミティブは、rectangle と同じコーナーポイントを取り、その後に削除する丸いコーナーの幅と高さを指定します。

circle プリミティブは、ディスク (塗りつぶしあり) または円 (塗りつぶしなし) を作成します。中心と周囲 (境界) 上の任意のポイントを指定します。変換を使用すると、円のエッジ座標を計算する必要がなくなり、半径を直接指定できます。

magick -size 100x60 xc: -stroke SeaGreen  -fill PaleGreen -strokewidth 2 -draw 'translate 50,30 circle 0,0 25,0' circle.gif

arc プリミティブは、楕円セグメントを指定された長方形に内接させるために使用されます。arc には、rectangle (上記参照) に使用される 2 つのコーナーと、セグメントの円弧の開始角度と終了角度 (例: 130,30 200,100 45,90) が必要です。生成された開始点と終了点は線分で結合され、楕円の結果として生じた部分が塗りつぶされます。

ellipse を使用して、部分的 (または全体) な楕円を描画します。中心点、水平および垂直の「半径」(楕円の semi-axes)、開始角度と終了角度を度単位で指定します (例: 100,100 100,150 0,360)。

polyline および polygon プリミティブでは、周囲を定義するために 3 つ以上の点が必要です。polyline は、単に最終点が開始点までストロークされていない polygon です。塗りつぶされていない場合は、polygonal line です。-stroke 設定が none (デフォルト) の場合、polyline は polygon と同じです。

coordinate は、スペースまたはオプションのコンマで区切られた 2 つの整数です。

たとえば、100,100 を中心として 150,150 まで広がる円を定義するには、次を使用します:

-draw 'circle 100,100 150,150'

Bezier プリミティブはスプライン曲線を作成し、その形状を定義するために 3 つ以上の点を必要とします。最初と最後の点は knots で、これらの点は曲線によって取得されますが、中間の座標は control points です。2 つの制御点が指定されている場合、各エンドノットとそれに続く対応する制御点の間の線によって、その端での曲線の接線方向が決まります。1 つの制御点が指定されている場合、エンドノットから 1 つの制御点までの線によって、各端での曲線の接線方向が決まります。3 つ以上の制御点が指定されている場合、追加の制御点が組み合わせて機能し、曲線の中間形状が決まります。複雑な曲線を描画するには、path プリミティブを使用するか、各連続セグメントの開始ノットと終了ノットを繰り返して複数の 4 点ベジェセグメントを描画することを強くお勧めします。たとえば、次のようになります:

-draw 'bezier 20,50 45,100 45,0 70,50'
-draw 'bezier 70,50 95,100 95,0 120,50'

path は、moveto (新しい現在のポイントを設定)、lineto (直線を描画)、curveto (ベジェ曲線を描画)、arc (楕円または円弧)、closepath (最後の moveto に線を描画して現在のシェイプを閉じる) の各要素で定義されるオブジェクトのアウトラインを表します。複合パス (つまり、サブパスを含むパスで、それぞれが 1 つの moveto とそれに続く 1 つ以上の線または曲線操作で構成される) を使用すると、オブジェクトで donut holes などの効果を実現できます (Paths を参照してください)。

image を使用して、イメージを別のイメージと合成します。イメージキーワードの後に、合成演算子、イメージの場所、イメージサイズ、およびファイル名を指定します:

-draw 'image SrcOver 100,100 225,225 image.jpg'

画像サイズに 0,0 を使用できます。これは、画像ヘッダーにある実際の寸法を使用することを意味します。それ以外の場合は、指定された寸法にスケールされます。使用可能なアルファ合成方法の詳細については、Alpha Compositing を参照してください。

「dissolve」などの引数を必要とする「特別な拡張合成演算子」は、現在 -draw image オプションでは使用できません。

text を使用して、画像にテキストで注釈を付けます。テキスト座標の後に文字列を続けてください。文字列にスペースが埋め込まれている場合は、一重引用符または二重引用符で囲みます。

たとえば、次の例では、bird.miff というタイトルの画像に Works like magick! で注釈を付けます。

-draw "text 100,100 'Works like magick!'"

画像にテキストで注釈を付ける別の便利な方法については、-annotate オプションを参照してください。

rotate プリミティブは、メイン画像の原点を中心に後続のシェイププリミティブとテキストプリミティブを回転させます。

-draw "rotate 45 text 10,10 'Works like magick!'"

translate プリミティブは、後続のシェイププリミティブとテキストプリミティブを変換します。

scale プリミティブは、これらを拡大縮小します。

skewX プリミティブと skewY プリミティブは、メイン画像または領域の原点を基準にこれらを傾斜させます。

変換により、現在のアフィンマトリックスが変更されます。このマトリックスは、-affine オプションで定義された初期アフィンマトリックスから初期化されます。変換は -draw オプション内で累積されます。初期アフィンマトリックスは影響を受けません。このマトリックスは、別の -affine オプションの出現によってのみ変更されます。別の -draw オプションが出現すると、現在のアフィンマトリックスは初期アフィンマトリックスから再初期化されます。

color プリミティブを使用して、ピクセルの色を塗りつぶし色に変更します (-fill を参照)。ピクセル座標の後にメソッドを使用します:

point
replace
floodfill
filltoborder
reset

ターゲットピクセルを、座標で指定したピクセルと見なします。point メソッドは、ターゲットピクセルの色を変更します。replace メソッドは、ターゲットピクセルの色に一致するすべてのピクセルの色を変更します。Floodfill は、ターゲットピクセルの色に一致する隣接ピクセルの色を変更しますが、filltoborder は、境界色ではない隣接ピクセルの色を変更します。最後に、reset はすべてのピクセルの色を変更します。

matte を使用して、ピクセルのマット値を透明に変更します。ピクセル座標の後にメソッドを指定します (メソッドの説明については、color プリミティブを参照してください)。point メソッドは、ターゲットピクセルのマット値を変更します。replace メソッドは、ターゲットピクセルの色に一致するすべてのピクセルのマット値を変更します。 Floodfill は、ターゲットピクセルの色と一致し、隣接しているピクセルのマット値を変更します。一方、filltoborder は、境界色 (-bordercolor) ではない隣接ピクセルのマット値を変更します。最後に、reset はすべてのピクセルのマット値を変更します。

プリミティブの色、フォント、フォント境界ボックスの色は、それぞれ -fill、-font、-box で設定できます。オプションはコマンドラインの順序で処理されるため、これらのオプション before と -draw オプションを必ず使用してください。

数字で始まる文字列は引用符で囲む必要があります (例: 1.png ではなく '1.png' を使用します)。

描画プリミティブは Magick Vector Graphics 形式に準拠します。

描画にはアルファチャネルが必要です。アルファチャネルがない場合は、すべて不透明なアルファチャネルが暗黙的に作成されます。

-duplicate `count,indexes`

画像を 1 回以上複製します。

シーケンス内のインデックスで、複製する画像の数と画像を指定します。最初の画像はインデックス 0 です。負のインデックスはシーケンスの最後からの相対値です。たとえば、-1 はシーケンスの最後の画像を表します。画像の範囲はダッシュで指定します (例: 0-4)。インデックスはコンマで区切ります (例: 0,2)。現在の画像シーケンスの最後の画像を複製するには、+duplicate を使用します。

-edge `radius`

画像内のエッジを検出します。

-emboss `radius`{x`sigma`

画像をエンボスします。

-encipher `filename`

-decipher で後で解読できるようにピクセルを暗号化します。

filename で指定されたファイルからパスフレーズを取得します。

詳細については、Web ページ ImageMagick: Encipher or Decipher an Image を参照してください。

-encoding `type`

テキストエンコードを指定します。

次から選択します

AdobeCustom     AdobeExpert
AdobeStandard   AppleRoman
BIG5            GB2312
Latin 2         None
SJIScode        Symbol
Unicode         Wansung

-endian `type`

イメージのエンディアン (MSB または LSB) を指定します。

エンディアンタイプの完全なリストを出力するには、-list endian オプションを使用します。

+endian を使用すると、エンディアンを指定しない状態に戻ります。

-enhance

デジタルフィルターを適用して、ノイズの多い画像を強調します。

-equalize

画像のチャンネルごとにヒストグラム均等化を実行します。

すべてのチャンネルで同時にヒストグラム均等化を実行するには、画像を HSL、OHTA、YIQ、YUV などの他の色空間に変換してから、適切な強度のようなチャンネルを均等化してから、RGB に戻します。

たとえば HSL を使用すると、次のようになります: ... -colorspace HSL -channel lightness -equalize -colorspace sRGB ...

YIQ、YUV、OHTA では赤チャネルを使用します。たとえば、OHTA は主成分変換で、ほとんどの情報を最初のチャネルに配置します。次のようになります: ... -colorspace OHTA -channel red -equalize -colorspace sRGB ...

-evaluate `operator value`

算術式、関係式、または論理式を評価して、チャネルピクセルを変更します。

(複数のパラメータを持つ関数については、-function 演算子を参照してください。より複雑な計算が必要な場合は、-fx 演算子を参照してください。)

各 operator の動作を次のリストにまとめます。簡潔にするために、以下で参照される「ピクセル」の数値はそのピクセルの対応するチャネルの値であり、「正規化されたピクセル」はその数値を最大値 (インストール依存) QuantumRange で割ったものです。 (正規化されたピクセルが使用される場合、他の計算に従って、QuantumRange を掛けてフルレンジに復元されます。)

`operator`	要約 (詳細は下記を参照)
Abs	ピクセルに `value` を加算し、絶対値を返します。
加算	ピクセルに `value` を加算します。
AddModulus	`QuantumRange` を法としてピクセルに `value` を加算します。
And	`value` を含むピクセルのバイナリ AND です。
Cos、Cosine	周波数 `value` のピクセルに 50% のバイアスを加えてコサインを適用します。
除算	ピクセルを `value` で除算します。
Exp	e を底とする指数関数
指数	e を底とする指数関数
InverseLog	正規化されたピクセルに逆スケール対数を適用します。
左シフト	ピクセル値を `value` ビット左にシフトします (つまり、ピクセルを 2^value 倍します)。
対数	正規化されたピクセルにスケールされた対数を適用します。
最大	ピクセルを最大値 `value` に設定し、現在のピクセルを `value` に設定します (つまり、現在 `value` 未満のピクセルを `value` に設定します)。
平均	`value` を加算し、2 で割ります。
中央値	画像シーケンスから中央値を選択します。
最小	ピクセルを `value` の最小値と現在のピクセル `value` に設定します (つまり、現在 `value` より大きいピクセルを `value` に設定します)。
乗算	ピクセルに `value` を乗算します。
または	ピクセルと `value` のバイナリ OR です。
Pow	正規化されたピクセルを `value` 乗します。
RightShift	ピクセル値を `value` ビット右にシフトします (つまり、ピクセルを 2^value で割ります)。
RMS	ピクセルを二乗し、`value` を加算します。
RootMeanSquare	ピクセルを二乗し、`value` を追加します。
設定	ピクセルを `value` に設定します。
Sin、Sine	周波数 `value` のピクセルに 50% のバイアスを加えた正弦を適用します。
減算	ピクセルから `value` を減算します。
XOR	ピクセルと `value.` のバイナリ XOR

ガウスノイズ
インパルスノイズse
ラプラシアンノイズ
乗法ノイズ	(これらは対応する -noise 演算子と同等です。)
ポアソンノイズ
均一ノイズ

しきい値	`value` より大きいしきい値ピクセル。
ThresholdBlack	`value` 以下のゼロ値にしきい値ピクセル。
ThresholdWhite	`value` を超える最大値にしきい値ピクセル。

指定された関数は、画像内の以前に設定された各 -channel にのみ適用されます。必要に応じて、計算結果は [0, QuantumRange] の範囲に収まるように切り捨てられます。画像の透明度チャネルは「アルファ」値 (0 = 完全に透明) として表されるため、たとえば、アルファチャネルの Divide を 2 倍すると、画像は半透明になります。パーセント記号 '%' を追加して、値を QuantumRange のパーセンテージとして指定します。

-evaluate 演算子の完全なリストを出力するには、-list evaluate を使用します。

Add、Subtract、および Multiply メソッドの結果は、適切な引数を持つ -level または +level 演算子を使用して、カラー値の全範囲を線形に変更することでも得られます。ただし、-level は透明度を「マット」値 (0 = 不透明) として扱い、-evaluate は「アルファ」値で動作することに注意してください。

AddModulus は ImageMagick 6.4.8-4 以降で追加され、QuantumRange を法とする加算を提供します。したがって、結果のピクセル値が区間 [0, QuantumRange] 外にならない限り、Add と同等です。

Exp or Exponential は ImageMagick 6.6.5-1 以降で追加され、正規化されたピクセル値で動作します。 Exp と一緒に使用される value は、減少する指数関数を生成するために負である必要があります。負でない値は常に 1 より大きい結果を生成するため、区間 [0, QuantumRange] の外側になります。式は次のように表されます。

exp(value ×u)

たとえば -function polynomial "2 0 0" を使用して入力画像を 2 乗すると、減衰ガウス関数が結果として得られます。

Log は ImageMagick 6.4.2-1 で追加され、正規化されたピクセル値で機能します。これは scaled ログ関数です。Log と一緒に使用される value は、ログ関数のグラフの曲率を調整する scaling factor を提供します。正規化された値に適用される式uは以下のとおりです。

log(value ×u+ 1) / log(value + 1)

Pow は ImageMagick 6.4.1-9 で追加され、正規化されたピクセル値で機能します。Pow は -gamma 演算子に関連していることに注意してください。たとえば、-gamma 2は-evaluate pow 0.5、つまり「平方根」関数と同等です。-gamma で使用される値は、Pow で使用される値の逆数です。

Cosine と Sine は IM v6.4.8-8 で追加され、画像の値を (コ) 正弦波関数に従って値に変換します。同義語の Cos と Sin も使用できます。出力は 50% バイアスされ、それぞれの色値の範囲に収まるように 50% 正規化されます。value は関数の period (その周波数) のスケーリングであり、入力色範囲で生成される「波」の数を決定します。たとえば、value が 1 の場合、有効期間は単に QuantumRange ですが、value が 2 の場合、有効期間は half または QuantumRange です。

0.5 + 0.5 × cos(2 πu× value)。

評価値をクランプするには、-set 'option:evaluate:clamp=true を使用します。

evaluate の複数値バージョンである -function 演算子も参照してください。

-evaluate-sequence `operator`

一連の画像に対して算術式、関係式、または論理式を評価することで、チャネルピクセルを変更します。シーケンス内のすべての画像が同じカラースペースにあることを確認してください。そうでない場合、予期しない結果が生じる可能性があります。たとえば、コマンドラインに -colorspace sRGB を追加します。

-evaluate-sequence 演算子の完全なリストを出力するには、-list evaluate を使用します。

-exit

この時点で処理を停止します。

このオプションの後は、これ以上のオプションは処理されません。スクリプトで、オプションを処理しているパイプラインを実際に閉じることなく、magick コマンドを強制的に終了させるのに役立ちます。また、暗黙的な出力画像の代わりに magick コマンドラインの最後のオプションとしてこのオプションを使用して、画像の書き込みを完全に防止することもできます。注意: NULL: コーダでも、少なくとも 1 つの画像が必要です。そうしないと、'書き込み' されません。このオプションでは、画像はまったく必要ありません。

-extent `geometry`

画像のサイズとオフセットを設定します。

画像を拡大すると、塗りつぶされていない領域は背景色に設定されます。画像を配置するには、geometry 指定でオフセットを使用するか、-gravity 設定を前に付けます。背景と画像をどのように合成するかを指定するには、-compose を使用します。

次のコマンドは、JPEG 画像を 800x600 ディスプレイに収まるように縮小または拡大します。入力画像のアスペクト比が正確に 4:3 でない場合、画像は 800x600 の黒いキャンバスの中央に配置されます:

magick input.jpg -resize 800x600 -background black -compose Copy \
  -gravity center -extent 800x600 -quality 92 output.jpg

このコマンドは、比率を指定して使用することもできます。画像がその比率になっていない場合は、その比率に合わせて切り取られます。-gravity 設定では、期待どおりの効果が得られます。

次のコマンドは、JPEG 画像を 4:3 の比率になるように切り取ります:

magick input.jpg -extent 4:3 -quality 92 output.jpg

< を追加すると、画像が指定サイズより小さい場合にのみパディングし、画像が大きい場合は切り取りません (つまり、何も行いません)。> を追加すると、画像が指定サイズより大きい場合にのみ切り取り、画像が小さい場合は拡張しません (つまり、何も行いません)。

ジオメトリ引数の詳細については、Image Geometry を参照してください。

-extract `geometry`

画像から指定領域を抽出します。

このオプションは、非常に大きな RAW 画像のサブ領域を抽出する場合に最も役立ちます。以下の 2 つのコマンドは同等であることに注意してください:

magick -size 16000x16000 -depth 8 -extract 640x480+1280+960 \
  image.rgb image.png",
convert -size 16000x16000 -depth 8 'image.rgb[640x480+1280+960]' \
  image.rgb image.png"

オフセットを省略すると、次のように指定寸法に縮小されます:

magick -size 16000x16000 -depth 8 -extract 640x480 \
  image.rgb image.png

画像は代わりに指定された寸法に縮小されます。これは、次と同等です:

magick -size 16000x16000 -depth 8 -resize 640x480 image.rgb image.png

ジオメトリ引数の詳細については、Image Geometry を参照してください。

-family `fontFamily`

テキストのフォントファミリを設定します。

この設定は、ImageMagick がテキストのレンダリングに使用するフォントファミリを提案します。ファミリが見つかった場合は、それが使用されます。そうでない場合は、デフォルトのフォント (例: 「Arial」) または類似していることが判明しているファミリが代用されます (例: 「System」が要求されたが見つからない場合、「Courier」が使用される可能性があります)。ファミリは CSS スタイルのフォントリストにすることができます。

フォントに影響するその他の設定については、オプション -font、-pointsize、-stretch、-style、および -weight を参照してください。

-features `distance`

指定された距離について、画像内の各チャネルのテクスチャ測定特徴 (共起マトリックス) を 4 つの方向 (水平、垂直、左および右の対角線) ごとに表示します。

Angular Second Moment       Sum Entropy
Contrast                    Entropy
Correlation                 Difference Variance
Sum of Squares Variance     Difference Entropy
Inverse Difference Moment   Information Measure of Correlation 1
Sum Average                 Information Measure of Correlation 2
Sum Variance                Maximum Correlation Coefficient

-fft

順方向離散フーリエ変換 (DFT) を実装します。

このオプションは、ImageMagick 6.5.4-3 で新しく追加されました (Windows ユーザーの場合は、ImageMagick 6.6.0-9 で動作します)。このオプションは、画像を通常 (空間) 領域から周波数領域に変換します。周波数領域では、画像はさまざまな振幅の複素正弦波の重ね合わせとして表されます。画像の x 座標と y 座標は、それぞれ x 方向と y 方向に沿った可能な周波数であり、ピクセルの強度値は正弦波の振幅に対応する複素数です。たとえば、Fourier Transform、Discrete Fourier Transform、Fast Fourier Transform を参照してください。

このオプションの出力として、単一の画像名が提供されます。ただし、出力結果には 2 つのコンポーネントが含まれます。指定された画像形式がマルチフレーム画像をサポートしているかどうかに応じて、2 フレーム画像または 2 つの個別の画像のいずれかになります。出力結果が 2 つになる理由は、周波数領域では複素数を使用して画像が表され、複素数は直接視覚化できないためです。したがって、複素数値は自動的に 2 つのコンポーネントの画像表現に分離されます。最初のコンポーネントは複素数の大きさで、2 番目のコンポーネントは複素数の位相です。たとえば、Complex Numbers を参照してください。

大きさと位相のコンポーネント画像は、色を制限したり画像を圧縮したりしない画像形式を使用して指定する必要があります。したがって、MIFF、TIF、PFM、EXR、および PNG が、使用が推奨される画像形式です。PNG を除くこれらの形式はすべて、マルチフレーム画像をサポートしています。したがって、たとえば、

magick image.png -fft fft_image.miff

は、大きさ画像を fft_image.miff[0] として生成し、位相画像を fft_image.miff[1] として生成します。同様に、

magick image.png -fft fft_image.png

振幅画像を fft_image-0.png として、位相画像を fft_image-1.png として生成します。この表現が好みであれば、コマンドラインで -fft の後に +adjoin を含めることで、他の形式のいずれかで 2 つの出力画像を生成するように強制できます。

入力画像は任意のサイズにすることができますが、正方形で偶数サイズでない場合は、入力画像の幅または高さの大きい方と偶数ピクセル数に自動的にパディングされます。パディングは入力画像の下部および/または右側に行われます。結果として出力される振幅画像と位相画像は、このサイズで正方形になります。パディングの種類は -virtual-pixel 設定に依存します。

両方の出力コンポーネントのダイナミックレンジは [0, QuantumRange] 内に収まるため、HDRI を有効にする必要はありません。位相値は名目上 0 から 2*π の範囲ですが、ダイナミックレンジ全体に及ぶようにスケーリングされます。 (最初の数回のリリースでは、HDRI 以外の画像はスケーリングされていましたが、HDRI はスケーリングされていませんでした)。マグニチュード画像はスケーリングされていないため、通常は非常に小さな値が含まれます。そのため、画像は通常完全に黒く表示されます。詳細を表示するには、マグニチュード画像は通常、対数関数を使用してスペクトルと呼ばれるものに拡張されます。対数関数は、明るい値と比較して暗い値をさらに強調するために使用されます。これは、たとえば次のように実行できます。

magick fft_image.miff[0] -contrast-stretch 0 \
  -evaluate log 1000 fft_image_spectrum.png"

ここで、-contrast-stretch 0 または -auto-level のいずれかを使用して、最初に画像をフルダイナミックレンジにスケーリングします。-evaluate ログの引数は、通常、スペクトルで引き出したい詳細の量に応じて 100 ～ 10,000 の間で指定されます。値が大きいほど、詳細がより目立ちます。ただし、詳細が多すぎると、重要な特徴が隠れてしまう可能性があります。

-fft を使用するには、FFTW デリゲートライブラリが必要です。

+fft を使用すると、複素数値フーリエ変換の実数成分と虚数成分である 2 つの出力画像が生成されます。

ただし、実数成分と虚数成分には負の値が含まれる可能性があるため、IM を HDRI 対応で構成する必要があります。この場合、実数成分と虚数成分の結果には、負の値と小数部の両方をクリップしたり小数部を切り捨てたりせずに保持する形式である MIFF、TIF、PFM、または MPC 形式を使用する必要があります。MIFF または TIF のいずれかを使用する場合は、-define quantum:format=32 を追加して、これらの画像タイプがクリップなしで HDRI モードで適切に動作するようにする必要があります。

+fft から得られる実数成分と虚数成分の画像も、振幅成分と位相成分の画像について上で説明したのと同じパディングにより、正方形で均一な寸法の画像になります。

ImageMagick の HDRI 実装については、ページ High Dynamic-Range Images の説明を参照してください。HDRI の詳細については、ImageMagick Usage ページ、Fred's Fourier Processing With ImageMagick page、またはこの Wikipedia エントリを参照してください。

デフォルトでは、FFT は正規化されます (IFT は正規化されません)。 FFT を明示的に正規化し、IFT を非正規化するには、「-define fourier:normalize=forward」を使用します。

-fill `color`

グラフィックプリミティブを塗りつぶすときに使用する色。

このオプションは、色名、16 進数の色、または数値の RGB、RGBA、HSL、HSLA、CMYK、または CMYKA 指定を受け入れます。色引数を適切に指定する方法については、Color Names を参照してください。

シェルによって「#」または括弧が解釈されないように、色指定を引用符で囲みます。

たとえば、

-fill blue
-fill "#ddddff"
-fill "rgb(255,255,255)"

詳細については、-draw を参照してください。詳細。

色名の完全なリストを印刷するには、-list color オプションを使用します。

-filter `type`

イメージのサイズ変更や変形を行うときは、この type のフィルターを使用します。

このオプションは、-resize や -distort などの操作中にイメージのサイズ変更操作に影響を与えるために使用します。たとえば、次のような単純なサイズ変更フィルターを使用できます:

Point       Hermite       Cubic
Box         Gaussian      Catrom
Triangle    Quadratic     Mitchell
CubicSpline

CubicSpline フィルターのフィルタリングのサポートサイズを指定するには、-define filter:lobes={2,3,4} を使用します。

Bessel および Sinc フィルターも提供されています (より高速な SincFast 同等の形式も提供されています)。ただし、これらのフィルターは、フィルターのサポートサイズにクリップされる無限フィルターであるため、単独では通常役に立ちません。エキスパート設定 (以下を参照) 以外では、直接使用することはお勧めしません。

代わりに、これらの特殊フィルタ関数は、通常、-filter 設定で定義されるウィンドウ関数によってウィンドウ化されます。つまり、これらの関数を使用すると、関係するオペレータに適した「ウィンドウ化」フィルタが定義されます。ウィンドウ化フィルタには次のものが含まれます:

Lanczos       Hamming       Parzen
Blackman      Kaiser        Welsh
Hanning       Bartlett      Bohman

また、Lagrange という特殊な自己ウィンドウ化フィルタも用意されており、現在の「サポート」または「ローブ」エキスパート設定に応じて、その機能を自動的に再調整します (以下を参照)。

このオプションでフィルタを選択しない場合、カラーマップされた画像、マットチャネルのある画像、または画像が拡大されている場合、フィルタはデフォルトで Mitchell になります。それ以外の場合、フィルタはデフォルトで Lanczos になります。

サイズ変更フィルタの完全なリストを出力するには、-list filter オプションを使用します。

これらのエキスパート設定を使用して、画像を拡大縮小する際のフィルターの動作を変更できます (-define および -set も参照)。-

-define filter:blur=`factor`	フィルター (およびそのウィンドウ) の X 軸をスケールします。ぼかしには > 1.0、鮮明には < 1.0 を使用します。これは、ガウスフィルターおよびガウスライクフィルターのシンプルフィルターでのみ使用してください。そうしないと、期待どおりの結果が得られない場合があります。
-define filter:support=`radius`	フィルターサポート半径を設定します。フィルターの大きさを定義し、フィルターされた再サンプリングプロセスの速度を直接定義します。すべてのフィルターには、デフォルトの「推奨」サポートサイズがあります。`Lagrange` やウィンドウフィルターなどの一部のフィルターは、この値に応じて調整されます。シンプルフィルターの場合、この値は何も行わないか (再サンプリング速度は遅くなります)、フィルター関数を不利な方法でクリップします。
-define filter:lobes=`count`	Sinc/Bessel フィルターに使用するローブの数を設定します。これはフィルターの「サポート」範囲を指定する別の方法で、特に画像の歪みに使用する場合、ウィンドウフィルターにより適するように設計されています。
-define filter:sigma=`value`	`Gaussian` フィルターを定義するために使用される「シグマ」値。デフォルトのシグマ値は「`0.5`」です。これは `Gaussian` にのみ影響し、フィルターの「サポート」を縮小しません (ただし、拡大する場合があります)。非常に小さなぼかしを生成するために使用できますが、小さなサポート設定を使用することでフィルターがピクセルを「失う」ことはありません。'`0.707`' の大きな値 ('1/sqrt(2)' の値) も一般的な設定です。
-define filter:b=`b-spline_factor`
-define filter:c=`keys_alpha_factor`	`Cubic`、`Catrom`、`Mitchel`、`Hermite` などのキュービックフィルター、および `Parzen` キュービックウィンドウ関数に使用される値を再定義します。値の 1 つだけが定義されている場合、もう 1 つは「キュービックキー」フィルターを生成するように設定されます。値の意味は、Mitchell-Netravali の研究論文で定義されています。
-define filter:kaiser-beta=`value`	Kaiser ウィンドウ関数の一部として使用される「アルファ」値。デフォルト値は「6.5」です。Kaiser ウィンドウ関数にのみ影響し、他の属性には影響しません。 ImageMagick v6.7.6-10 より前では、このオプションは「filter:alpha」と呼ばれていました (非常に古い「zoom」プログラムからの継承)。関数をより現代的な学術研究の用途に合わせ、より明確に割り当てられるように変更されました。
-define filter:kaiser-alpha=`value`	この値に 'PI' を掛けると「kaiser-beta」と同等になり、その設定を上書きします。これは Kaiser ウィンドウ関数にのみ影響し、他の属性には影響しません。
-define filter:filter=`filter_function`	この関数を重み付けフィルターとして直接使用します。これにより、`Blackman` などのウィンドウ関数を、通常のウィンドウ関数としての使用ではなく、リサンプリングフィルターとして直接使用できるようになります。ウィンドウ関数が定義されていない場合、ウィンドウ関数は `Box` に設定されます。`Sinc` または `Jinc` をフィルターとして直接指定しても同じことが行われます。
-define filter:window=`filter_function`	IIR (無限インパルス応答) フィルター `Sinc` および `Jinc` は、指定されたフィルターを使用してウィンドウ処理されます (定義されたサポート範囲でゼロに下げられます)。これにより、これらの IIR フィルターのウィンドウ処理関数として使用するフィルター関数を指定できます。定義されたフィルターの多くは、実際にはこれらの IIR フィルターのウィンドウ処理関数です。一般的な選択肢は `Box` です (これは、ウィンドウ処理関数を実質的にオフにします)。
-define filter:win-support=`radius`	代わりに、ウィンドウ処理関数をこのサイズにスケーリングします。これにより、サポートウィンドウが呼び出し元の演算子に実際に提供されているものよりも大きい場合、ウィンドウ処理 (または自己ウィンドウ処理 Lagrange フィルター) が機能します。ただし、フィルターは指定された実際のサポートサイズにクリップされます。設定されていない場合は、通常のフィルターサポートサイズと同じになります。
-define filter:verbose=`1`	これにより、IM は最終的な内部フィルタ選択に関する情報を標準出力に出力します。これには、使用されているフィルタ設定に関するコメント付きヘッダーと、フィルタの重みを簡単にグラフ化できるデータが含まれます。ただし、一部のフィルタは他のフィルタに基づいて内部的に定義されていることに注意してください。たとえば、`Lanczos` フィルタは `SincFast` ウィンドウ付き `SincFast` フィルタに基づいて定義され、`Mitchell` は特定の「B」および「C」設定を持つ一般的な `Cubic` ファミリフィルタとして定義されます。

たとえば、8 ローブの Jinc ウィンドウ付き Sinc フィルター (Genseng フィルター?) を取得するには、次のようにします:

magick image.png \
  -filter sinc \
  -set filter:window=jinc \
  -set filter:lobes=8 \
  -resize 150% image.jpg"

または、4 ローブの未加工のウィンドウなし Sinc フィルター:

magick image.png \
  -set filter:filter=sinc \
  -set filter:lobes=4 \
  -resize 150% image.jpg"

未加工のウィンドウ関数のデータを抽出するには、これを 'Box' フィルターと組み合わせます。たとえば、'Welch パラボリックウィンドウ関数です。

magick null: -define filter:filter=Box \
  -define filter:window=Welch \
  -define filter:support=1.0 \
  -define filter:verbose=1 \
  -resize 2 null: > window_welch.dat
gnuplot
  set grid
  plot \"window_welch.dat\" with lines

エキスパートオプションの使用は、サイズ変更フィルターの仕組みを研究し理解している画像処理のエキスパート向けに提供されています。この知識と、関係する実際のフィルターの定義を理解していない場合、エキスパート設定を使用すると、イメージのサイズ変更に悪影響を与える可能性が高くなります。

-flatten

これは、-layers メソッド「flatten」の単純なエイリアスです。

-flip

mirror image を作成します

スキャンラインを垂直方向に反射します。イメージは上下逆さまにミラーリングされます。

-floodfill {`+-`}`x`{`+-`}`y` `color`

指定されたオフセットでイメージを色で塗りつぶします。

塗りつぶしは、重力の影響を受けない、指定された「シードポイント」から始まります。指定された color 引数の -fuzz 色距離内で一致する、その「シードポイント」に接続された色は、現在の -fill 色に置き換えられます。

「シードポイント」のピクセル自体が指定された color (-fuzz による) と一致しない場合は、何も行われないことに注意してください。

この演算子は、「シードポイント」で一致する色を直接読み取る、より一般的な塗りつぶしよりも、-opaque オプションに似ています。この形式の塗りつぶしについては、-draw とその「カラー塗りつぶし」描画方法を参照してください。

-flop

mirror image を作成します。

画像を垂直に鏡映したのと同じように、走査線を水平方向に反射します。

-font `name`

画像にテキストで注釈を付けたり、ラベルを作成したりするときに使用するフォントを設定します。

フォントの完全なリストを印刷するには、-list font オプションを使用します (6.3.6 より前のバージョンでは、「font」ではなく「type」を使用します)。

上記の定義済みリストで指定されたフォントに加えて、特定のソースからフォントを指定することもできます。たとえば、Arial.ttf は TrueType フォントファイル、ps:helvetica は PostScript フォント、x:fixed は X11 フォントです。

フォントに影響するその他の設定については、オプション -family、-stretch、-style、および -weight を参照してください。

明示的なフォントファイル名またはコレクションを指定するには、@ を先頭に付けたフォントパスを指定します (例: @arial.ttf)。フォントコレクションのフォントフェースインデックスを指定できます (例: @msgothic.ttc[1])。

-foreground `color`

メニューの前景色を定義します。"、"表示

色は、-fill オプションで説明されている形式を使用して指定されます。

デフォルトの前景色は黒です。

-format `type`

画像形式の種類。

mogrify ユーティリティで使用する場合、このオプションは任意の画像を指定した画像 format に変換します。ImageMagick でサポートされている画像形式の種類の一覧については、-list format を使用してください。

デフォルトでは、ファイルは元の名前で書き込まれます。ただし、ファイル名の拡張子がサポートされている形式と一致する場合、拡張子は -format で指定された画像形式の種類に置き換えられます。たとえば、形式の種類として tiff を指定し、入力画像ファイル名が image.gif の場合、出力画像ファイル名は image.tiff になります。

-format `expression`

出力フォーマットされた画像の特性。

このオプションの引数の指定方法については、Format and Print Image Properties を参照してください。

-frame `geometry`

画像を境界線またはベベルフレームで囲みます。

境界線の色は、-mattecolor コマンドラインオプションで指定します。

ジオメトリ引数の詳細については、Image Geometry を参照してください。geometry 引数の size 部分は、イメージの寸法に追加される追加の幅と高さの量を示します。geometry 引数にオフセットが指定されていない場合、追加される境界は単色になります。オフセット x および y が存在する場合、境界の幅と高さが分割され、厚さ x ピクセルの外側のベベルと厚さ y ピクセルの内側のベベルが形成されることを指定します。負のオフセットはフレーム引数としては意味がありません。

-frame オプションは、現在の -compose 設定の影響を受け、これがデフォルトの 'Over' 構成方法を使用していると想定します。現在の -bordercolor 設定で適切なサイズのイメージを生成し、現在の -mattecolor に近い 4 つの異なる色のフレームを描画します。次に、元の画像がこの画像の中央に重ねられます。つまり、デフォルトの合成方法である「Over」では、透明な部分が現在の -bordercolor 設定に置き換えられる場合があります。

画像合成は -gravity オプションの影響を受けません。

-frame

インポートされた画像に X ウィンドウフレームを含めます。

-function `function` `parameters`

チャネル値に関数を適用します。

この演算子は、指定された引数に基づいて計算を実行し、画像で以前に設定された各 -channel のカラー値を変更します。計算結果の処理方法の詳細については、-evaluate を参照してください。

これは -evaluate 演算子の複数引数バージョンと考えることができます。(ImageMagick 6.4.8−8 で追加されました。)

ここで、parameters は数値のコンマ区切りリストです。値の数は、どの function が選択されているかによって異なります。function は次から選択します:

Polynomial
Sinusoid
Arcsin
Arctan

-function 演算子の完全なリストを出力するには、-list function を使用します。説明は後述します。

多項式

Polynomial 関数は、次数の降順で並べられた多項式の係数である任意の数のパラメータを取ります。つまり、

-function Polynomial an,an-1,...a1,a0

と入力すると、

an un + an-1 un-1 + ··· a1 u + a0,

で示される多項式関数が呼び出されます。ここで、uはピクセルの元の正規化されたチャネル値です。

Polynomial 関数は、-evaluate 演算子の Set (constant 多項式) および Add、Divide、Multiply、Subtract (一部の linear 多項式) の代わりに使用できます。-level 演算子もチャネルに線形に影響します。いくつかの対応関係を以下に示します。

-evaluate 値の設定-function 多項式値(定数関数。チャンネルが RGB の場合は値×100% グレーを設定します。)-evaluate 値の加算-function 多項式 1、値-evaluate 値の減算-function 多項式 1、−値-evaluate 値の乗算-function 多項式値、0+レベル黒% x 白%-function 多項式 A、B(コントラストを減らします。ここで、A=(白-黒)/100、B=黒/100 です。)

Polynomial 関数は、多項式を使用して任意の連続曲線を任意の精度でフィッティングできるため、非常に汎用性があります。

正弦波

Sinusoid 関数は、周波数、位相シフト、振幅、バイアスを設定することで、チャネル値を正弦波的に変化させるために使用できます。これらの値は、次のように 1 ～ 4 つのパラメータとして指定されます。

-function Sinusoid freq,[phase,[amp,[bias]]]

ここで、phase は度数です。(関数のドメイン [0,1] は、0 ～ freq×360 度に対応します。) その結果、ピクセルの正規化されたチャネル値が元々uである場合、結果として得られる正規化された値は

amp * sin(2*π* (freq * u + phase / 360)) + bias

で与えられます。たとえば、次の式は、0.9 で始まり 0.9 で終わり (それぞれu=0 および 1 の場合)、.7−.2=.5 と .7+.2=.9 の間で 3 回振動する曲線を生成します。

-function Sinusoid 3,-90,.2,.7

amp と bias のデフォルト値はどちらも .5 です。phase のデフォルト値は 0 です。

Sinusoid 関数は、振幅、位相、バイアスを変更できるようにすることで、-evaluate 演算子の Sin と Cos を一般化します。対応は次のとおりです。

-evaluate Sin freq-function Sinusoid freq,0-evaluate Cos freq-function Sinusoid freq,90

ArcSin

ArcSin 関数は、正弦波の逆曲線を生成し、円筒形の歪みマップや変位マップを生成するために使用できます。曲線は、入力値と出力値の範囲の両方に対して調整できます。

-function ArcSin width,[center,[range,[bias]]]

すべての値は、正規化されたカラー値 (黒の場合は 0.0、白の場合は 1.0) で指定されます。デフォルトでは、入力値 (width) と出力値 (width) については、0.0 から 1.0 までの全範囲をカバーする値になります。 '1.0,0.5,1.0,0.5'

range/π * asin( 2/width * ( u - center ) ) + bias

ArcTan

ArcTan 関数は、指定された傾斜値を使用して中心を通る、無限遠の限界値から滑らかに交差する曲線を生成します。これらの値はすべて、引数によって調整できます。

-function ArcTan slope,[center,[range,[bias]]]

デフォルトは '1.0,0.5,1.0,0.5' です。

range/π * atan( slope*π * ( u - center ) ) + bias

-fuzz `distance`{`%`}

この distance 内の色は等しいとみなされます。

多数のアルゴリズムがターゲットカラーを検索します。デフォルトでは、カラーは正確である必要があります。このオプションを使用して、RGB 空間でターゲットカラーに近いカラーを一致させます。たとえば、-trim を使用してイメージのエッジを自動的にトリミングしたいが、イメージがスキャンされており、ターゲットの背景色がわずかに異なる可能性がある場合などです。このオプションを使用すると、これらの違いを考慮できます。

distance は絶対強度単位にするか、% を追加して最大強度のパーセンテージ (255、65535、または 4294967295) にすることができます。

+fuzz を使用して、ファズ値を 0 にリセットします。

-fx `expression`

イメージまたはイメージチャネルに数式を適用します。

expression の最初の文字が @ の場合、式は文字列の残りの文字でタイトルが付けられたファイルから読み取られます。

このオプションの詳細については、FX, The Special Effects Image Operator を参照してください。

-gamma `value`

ガンマ補正のレベル。

2 つの異なるワークステーションに表示される同じカラーイメージは、ディスプレイモニターの違いにより異なって見える場合があります。この色の違いを調整するには、ガンマ補正を使用します。適切な値は 0.8 から 2.3 までです。ガンマが 1.0 未満の場合、イメージは暗くなり、ガンマが 1.0 を超える場合、イメージは明るくなります。ピクセル量子サイズが 8 ビット (量子範囲 0 ～ 255) しかない場合、イメージのガンマを大幅に調整すると、イメージ情報の一部が失われる可能性があります。

ガンマは、べき乗法則、つまり pow(pixel,1/gamma) またはpixel^(1/gamma) に従って、ピクセルごとにイメージのチャネル値を調整します。ここで、pixel は正規化された色値または 0 ～ 1 の色値です。たとえば、gamma=2 の値を使用することは、イメージの平方根を取ることと同じです。

使用+gamma valueイメージのピクセルを実際に調整せずに、イメージのガンマレベルを設定します。このオプションは、イメージのガンマが既知であるが、イメージ属性として設定されていない場合 (PNG イメージなど) に便利です。ディスプレイガンマの逆数である「ファイルガンマ」を書き込みます。たとえば、イメージが sRGB で、PNG gAMA チャンクを書き込む場合は、次を使用します。

magick input.png +gamma .45455 output.png

(0.45455 は 1/2.2)

ガンマ調整は -level 演算子でも使用できます。

-gaussian-blur `radius`

ガウス演算子を使用してイメージをぼかします。

指定された Sigma 値を使用して、ガウス分布または正規分布でイメージを畳み込みます。式は次のとおりです:

sigma の値は重要な引数であり、実際に発生するぼかしの量を決定します。

radius は、計算されたガウス分布を保持する配列のサイズを決定するためにのみ使用されます。整数である必要があります。指定されないか、ゼロに設定されている場合、IM はガウス分布に意味のある結果を提供する最大の半径を計算します。

半径 Radius が大きいほど、操作は遅くなります。ただし、Radius が小さすぎると、深刻なエイリアシング効果が発生する可能性があります。ガイドラインとして、Radius は Sigma の値の少なくとも 2 倍である必要がありますが、3 倍にするとより正確な結果が得られます。

これは、完全な 2 次元畳み込みを使用して隣接するピクセルの加重平均を生成するという点で、より高速な -blur 演算子とは異なります。

-virtual-pixel 設定は、画像本体の外側にあるピクセルを最終結果にぼかす方法を決定します。

-geometry `geometry`

画像の推奨サイズと位置を設定します。

ジオメトリ引数の詳細については、Image Geometry を参照してください。

-gravity `type`

その他のさまざまな設定とオプションの現在の重力の提案を設定します。

選択肢には、NorthWest、North、NorthEast、West、Center、East、SouthWest、South、SouthEast があります。-list gravity を使用すると、ImageMagick インストールで使用可能な -gravity 設定の完全なリストが表示されます。

選択した方向によって、テキストまたはサブイメージを配置する場所が指定されます。たとえば、Center の重力は、テキストをイメージ内の中央に配置するように強制します。デフォルトでは、イメージの重力は undefined です。グラフィックプリミティブの詳細については、-draw を参照してください。 -draw のテキストプリミティブのみが -gravity オプションの影響を受けます。

-gravity オプションは、-geometry 設定や、-crop オプションなどの geometry を引数として取るその他の設定またはオプションと組み合わせて使用されます。

-gravity 設定が、オフセットを指定する geometry 引数を持つ別のオプションまたは設定の前にある場合、オフセットは通常、-gravity 引数によって示されるイメージ内のポイントに適用されます。したがって、たとえば次のコマンドでは、ファイル image.png の寸法が 200x100 であるとします。-region の引数によって指定されるオフセットは (-40,+20) です。-gravity の引数は Center で、これはイメージの中間点 (100,50) を示します。オフセット (-40,20) がそのポイントに適用され、(100-40,50+20)=(60,70) となるため、指定された 10x10 領域はそのポイントに配置されます。(さらに、-gravity は、ピクセル座標 (60,70) の centered である領域自体に影響します。(ジオメトリ引数の詳細については、Image Geometry を参照してください。)

magick image.png -gravity Center -region 10x10-40+20 \
  -negate output.png

composite のオプションとして使用される場合、-gravity は合成画像内で画像が引き寄せられる方向を示します。

montage のオプションとして使用する場合、-gravity はタイル内で画像が引かれる方向を指定します。この目的のデフォルトの引力は Center です。

+gravity を使用して、引力をデフォルト値に戻します。

-grayscale `method`

画像をグレースケールに変換します。

これにより、-intensity のいずれかの方法を使用して、指定された画像をグレースケール画像に変換します。

たとえば、画像を (線形) Rec709Luminance グレースケールに変換するには、次のように入力します:

magick in.png -grayscale Rec709Luminance out.png

これは次のコードと同等です:

magick in.png -colorspace LinearGray out.png

同様に、画像を (非線形) Rec709Luma グレースケールに変換するには、次のように入力します:

magick in.png -grayscale Rec709Luma out.png

これは次のコードと同等です:

magick in.png -colorspace Gray out.png

「カラースペース」強度メソッドは、画像の現在のカラースペースに関係なく、同じ結果を生成します。ただし、「数学的」強度メソッドは、画像が現在使用している現在のカラースペースに依存します。

この操作では -intensity メソッドを使用しますが、-intensity 設定は使用または設定しないため、その設定を使用する可能性のある他の操作には影響しません。

-green-primary `x,y`

緑の色度原点。

-hald-clut

Hald カラールックアップテーブルを画像に適用します。

Hald カラールックアップテーブルは、2 次元にマッピングされた 3 次元カラーキューブです。HALD: プレフィックスを使用して作成します (例: HALD:8)。Hald 画像に任意のカラー変換を適用してから、このオプションを使用して画像に変換を適用できます。

magick image.png hald.png -hald-clut transform.png

このオプションは、Gimp または Photoshop を使用して Hald CLUT 画像に色補正を行い、その後 ImageMagick スクリプトを使用して複数の画像に適用する便利な方法を提供します。

表現は通常の RGB カラースペースのみであり、表現されたハーフカラーキューブイメージの補間ルックアップにはカラー値のトリプレット全体が使用されることに注意してください。このため、操作は -channel 設定の影響を受けず、イメージの透明度やアルファ/マットチャネルを調整または変更することもできません。

個々のカラーチャネルのカラー値の置き換えを提供する -clut も参照してください。通常はより単純なグレースケールイメージが含まれます。例: グレースケールからカラーへの置き換え、またはヒストグラムマッピングによる変更。

-help

使用方法の説明を印刷します。

-highlight-color `color`

イメージを比較するときは、この色でピクセルの違いを強調します。

-hough-lines `width`x`height`{`+threshold`}

画像内の直線を識別します (例: -hough-lines 9x9+195)。

バイナリエッジ抽出画像でハフ線検出器を使用して、見つかった直線の位置を特定し、描画します。

このプロセスでは、バイナリエッジ画像内のすべての白いピクセルについて、考えられるすべての方向 (角度は 0 から 179 まで、1 度単位) と画像の中心からコーナーまでの距離 (1 ピクセル単位) を累積します。このカウントは、角度と距離の累積マトリックスに格納されます。累積のサイズは 180x(対角線/2) になります。次に、アキュムレータでカウントのピークを検索し、ピークの位置を通常の x、y 入力画像空間の傾きと切片に変換します。アルゴリズムは、傾き/切片を使用して、画像の境界にクリップされたエンドポイントを見つけます。線は、指定されたエンドポイントから描画されます。カウントは、線の長さの尺度です。

WxH 引数は、ハフアキュムレータのピークを見つけるためのフィルタサイズを指定します。しきい値は、カウントがしきい値より小さい線を除外します。

-background を使用して、線が描画される背景の色を指定します。デフォルトは黒です。

-fill を使用して、線の色を指定します。デフォルトは黒です。

-stroke および -strokewidth を使用して、線の太さを指定します。デフォルトは黒で、線幅はありません。

出力イメージにサフィックス .mvg を使用すると、エンドポイントとカウントをリストしたテキストファイルを作成できます。

-define hough-lines:accumulator=true を使用すると、ラインイメージに加えてアキュムレータイメージも返されます。

-iconGeometry `geometry`

アイコンのジオメトリを指定します。

オフセットがジオメトリ指定に存在する場合、オフセットは -geometry オプションと同じ方法で処理され、負のオフセットは X11 スタイルを使用して処理されます。

ジオメトリ引数の詳細については、Image Geometry を参照してください。

-iconic

X Windows のアイコンモードで起動」、「animate」、「display」

-identify

画像の形式と特性を識別します。

この情報はデフォルトで印刷されます:

画像シーン番号 (ゼロでない場合)
画像名
画像形式
画像サイズ
仮想ページオフセット
色深度
カラースペース
ファイルサイズ (バイト単位)
イメージの識別に費やされたユーザー時間
イメージの識別にかかった時間

識別する属性をカスタマイズするには、-format を使用します。

-colors も指定されている場合は、画像内の固有色の合計と減色エラー値が出力されます。これらの値の説明については、color reduction algorithm を参照してください。

このオプションの前に -verbose を指定した場合、画像統計、プロファイル、画像ヒストグラムなど、大量の画像プロパティが表示されます。

-ift

逆離散フーリエ変換 (DFT) を実装します。

このオプションは、ImageMagick 6.5.4-3 で新しく追加されました (Windows ユーザーの場合は、ImageMagick 6.6.0-9 で動作します)。このオプションは、振幅と位相の 2 つの画像を周波数領域から通常領域または空間領域の 1 つの画像に変換します。たとえば、Fourier Transform、Discrete Fourier Transform、および Fast Fourier Transform を参照してください。

たとえば、-fft の結果を格納するために使用される画像形式に応じて、次のいずれかを使用します

magick fft_image.miff -ift fft_image_ift.png

または

magick fft_image-0.png fft_image-1.png -ift fft_image_ift.png

-fft または +fft の前の元の画像が正方形でなかったり、寸法が定まっていなかったりすると、パディングが導入されるため、結果の画像を切り取る必要がある場合があります。パディングは、画像の右側または下側にあります。

-ift を使用するには、FFTW デリゲートライブラリが必要です。

+ift (HDRI が有効) を使用して、周波数領域から実数と虚数の画像のペアを通常の (空間) 領域内の単一の画像に変換します。

デフォルトでは、IFT は正規化されません (FFT は正規化されます)。IFT を明示的に正規化し、FFT を非正規化するには、「-define fourier:normalize=inverse」を使用します。

-illuminant `method`

基準光源。A、B、C、D50、D55、D65、E、F2、F7、または F11 から選択します。

-immutable

画像を不変にします。

-implode `factor`

画像ピクセルをセンター。

-insert `index`

最後の画像を画像シーケンスに挿入します。

このオプションは、現在の画像シーケンスの最後の画像を取得し、指定されたインデックスに挿入します。負のインデックスが使用される場合、挿入位置は、最後の画像がシーケンスから削除される前に計算されます。したがって、-insert -1 では画像シーケンスは変更されません。

+insert オプションは -insert -1 と同等です。つまり、最後の画像を現在の画像シーケンスの最後に挿入します。したがって、これは画像シーケンスの順序には影響しません。

-intensity `method`

ピクセルから強度値を生成するメソッド。

ImageMagick には、赤、緑、青のピクセルコンポーネントを含む画像から、何らかの目的で単一のグレースケール値を決定する必要がある場合に使用されるメソッドが多数用意されています。通常、Rec709Luma 式が使用されます。これは、画像を -colorspace gray に変換するときに使用される式と同じです。

現在提供されている次の式は、ピクセル値を最初に線形 RGB または非線形 sRGB カラースペースに変換してから、最終的なグレースケール値を計算するために適用されます。

Rec601Luma: 0.298839R' + 0.586811G'+ 0.114350B'
Rec601Luminance: 0.298839R + 0.586811G + 0.114350B
Rec709Luma: 0.212656R' + 0.715158G' + 0.072186B'
Rec709Luminance: 0.212656R + 0.715158G + 0.072186B
明るさ: max(R', G', B')
明度: (min(R', G', B') + max(R', G', B')) / 2.0

上記の R、G、B 値は画像の線形 RGB 値であり、R'、G'、B' は sRGB であることに注意してください非線形値。

これらの強度方法は本質的に数学的であり、それが何であるか、または画像が現在どの色空間を使用しているかに関係なく、画像のそれぞれの R、G、B チャネルの現在の値を使用します。

平均: (R' + G' + B') / 3.0
MS: (R'^2 + G'^2 + B'^2) / 3.0
RMS: sqrt( (R'^2 + G'^2 + B'^2) / 3.0 )

これらの方法は、2 つのカラー画像間のグレースケール差分画像の生成 (-compose 'Difference' 合成を使用) などの他の目的にもよく使用されます。

例「MS」（平均二乗）設定は、色誤差の比較を最小限に抑えるのに適しています。一方... たとえば、「RMS」（平均二乗根）メソッドは、色差画像から色ベクトル距離を計算するのに適しています。これは、-fuzz ファクター色比較設定の色のみのコンポーネントに相当します。

-intensity 設定を設定せずに、上記のグレースケール式の 1 つを画像に直接適用する -grayscale も参照してください。

-colorspace gray 画像変換でも現在の強度設定が使用されますが、上記の関数を適用する前に、常に適切な sRGB または線形 RGB 色空間に画像が変換されます。

使用可能なピクセル強度設定メソッドの完全なリストを印刷するには、-list intensity を使用します。

-intensity 設定の影響を受ける演算子は次のとおりです:

-adaptive-blur
-adaptive-sharpen
-black-threshold
-clut (when mapping greyscale CLUT image to alpha channel if set by -channels)
-colors for gray colorspace
-compose {LightenIntensity, DarkenIntensity, CopyOpacity, CopyBlack}
-contrast-stretch
-distort {ErodeIntensity, DilateIntensity}
-normalize
-random-threshold
-range-threshold
-selective-blur
-shade
-threshold
-tint
-white-threshold

-intent `type`

画像の色を管理する場合は、このタイプのレンダリングインテントを使用します。

このオプションを使用して、画像のカラー管理操作に影響します (-profile を参照)。次のインテントから選択します: Absolute, Perceptual, Relative, Saturation。

デフォルトのインテントは、sRGB カラースペースの場合は Perceptual、RGB およびグレーカラースペースの場合は undefined です。

レンダリングインテントの完全なリストを印刷するには、-list intent を使用します。

-interlace `type`

インターレーススキームのタイプ。

次の中から選択します:

none
line
plane
partition
JPEG
GIF
PNG

このオプションは、RGB や YUV などの RAW 画像形式のインターレーススキームのタイプを指定するために使用されます。

None はインターレースしないことを意味します (RGBRGBRGBRGBRGBRGB...)。

Line はスキャンラインインターレースを使用します (RRR...GGG...BBB...RRR...GGG...BBB...)。

Plane はプレーンインターレースを使用します (RRRRRR...GGGGGG...BBBBBB...)。

Partition はプレーンに似ていますが、異なるプレーンが個別のファイルに保存されます (例: image.R、image.G、image.B)。

interlaced PNG、GIF、または progressive JPEG イメージを作成するには、Line または Plane を使用します。

インターレーススキームの完全なリストを印刷するには、-list interlace を使用します。

-interline-spacing `value`

2 つのテキスト行間のスペース。

-interpolate `type`

浮動小数点または実数値に基づいて色を検索するときに使用するピクセル色補間方法を設定します。

整数以外の浮動小数点値を使用してピクセルの色を検索する場合、通常はソースイメージで定義されたピクセル色の間に収まります。この設定により、そのポイントを囲むピクセルの色から色を決定する方法が決まります。つまり、2 つまたは 4 つの異なる色のピクセルの間にあるポイントの色を決定する方法です。

平均: 周囲の 4 ピクセルの平均色
平均 4: 周囲の 4 ピクセルの平均色
平均 9: 周囲の 9 ピクセルの平均色
平均 16: 周囲の 16 ピクセルの平均色
背景
バイリニア: ピクセルの二重線形補間（デフォルト）
ブレンド
catrom: 周囲の 16 ピクセルのバイキュービックスパインをフィッティング
整数: 左上のピクセルの色（床関数）
メッシュ: 領域を 2 つの平坦な三角形補間に分割
最近傍: ルックアップポイント (丸め関数)
スプライン: 直接スプライン曲線 (色がぼやけます)

これは、-distort、-implode、-transform、-fx などの歪み演算子にとって最も重要です。

補間方法の完全なリストを出力するには、-list interpolate を使用します。

画像の境界外の位置のルックアップを制御するには、-virtual-pixel も参照してください。

-interpolative-resize `geometry`

補間を使用してサイズを変更します。-interpolate 設定を参照してください。

-interword-spacing `value`

2 つの単語間のスペース。

-integral

画像内の値 (ピクセル値) の合計を計算します。

-kerning `value`

2 つの文字間のスペース。

-kmeans `colors`{x`iterations`}{+`tolerance`}

Kmeans (反復) 色削減 (例: -kmeans 5x300+0.0001)。色は必要な色数です。初期色は色量子化を使用して検出されます。反復は反復の停止数です (デフォルト = 300)。収束は反復間の色の変化の停止しきい値です (デフォルト = 0.0001)。反復または許容値のいずれかに達すると、処理が終了します。色を初期化するには -define kmeans:seed-colors=color-list を使用します。ここで、color-list はシード色のセミコロンで区切られたリストです (例: -define kmeans:seed-colors="red;sRGB(19,167,254);#00ffff)。色リストは色量子化をオーバーライドします。空でない色リストは色数をオーバーライドします。割り当てられていない初期色には、画像からランダムな色が割り当てられます。

-kuwahara `radius`

エッジ保持ノイズ削減フィルター。

radius は sigma よりも重要です。sigma が省略されている場合は、radius から sigma=radius-0.5 として自動的に計算されます。sigma は、追加のスムージング制御を提供します。

-label `name`

画像にラベルを割り当てます。

このオプションを使用して、画像が読み込まれたときまたは作成されたときに、画像に特定のラベルを割り当てます。-set 操作を使用して、すでに読み込まれた画像のラベルを再割り当てできます。TIFF、PNG、MIFF などの画像形式では、画像とともにラベル情報を保存できます。

イメージを PostScript ファイルに保存する場合、イメージに割り当てられたラベルは、PostScript イメージの上に印刷されるヘッダー文字列として使用されます。

特殊なフォーマット文字を埋め込むことで、イメージのファイル名、タイプ、幅、高さ、またはその他のイメージ属性を含めることができます。パーセントエスケープコードの詳細については、Format and Print Image Properties を参照してください。

たとえば、

-label "%m:%f %wx%h"  bird.miff

は、読み込まれたときに幅が 512、高さが 480 である「bird.miff」画像に MIFF:bird.miff 512x480 の画像ラベルを割り当てます。代わりに +label オプションを使用した場合は、画像に存在する既存のラベルが使用されます。空の文字列を割り当てると、画像からすべてのラベルを削除できます。

ラベルは画像に描画されませんが、Label タグまたは同様のメカニズムを介して画像データストリームに埋め込まれます。ラベルを画像自体に表示したい場合は、-draw オプションを使用するか、画像モンタージュの作成の最終処理中に使用します。

string の最初の文字が @ の場合、画像ラベルは文字列の残りの文字でタイトルが付けられたファイルから読み取られます。ファイル内のラベルはリテラルであり、埋め込まれた書式設定文字は認識されません。

-lat `width`

ローカル適応しきい値を実行します。

周囲のウィンドウのピクセルの値に基づいて、各ピクセルを適応的にしきい値化します。現在のピクセルがこの平均とオプションの offset を加えた値よりも明るい場合は白になり、そうでない場合は黒になります。オフセットが正の場合、スキャンされたドキュメントに見られるようなピクセル値の小さな変化は無視できます。オフセットが負の場合、これらの小さな変化に対する感度が高くなります。

これは、不均一な背景を持つイメージをしきい値化するためによく使用されます。これは、小さなウィンドウの平均色がローカル背景色であり、そこから前景色を分離するという仮定に基づいています。

-layers `method`

イメージレイヤーまたはアニメーションフレームのセットを形成する複数のイメージを処理します。

オーバーレイされた「画像レイヤー」のセット、GIF 処理アニメーション、または完全に「結合された」アニメーションシーケンスのいずれかを表す、順序付けられた画像シーケンスに対してさまざまな画像操作方法を実行します。

メソッド	説明
compare-any	2 番目のフレーム以降のフレームを、2 つの画像間のすべての違いを含む最小の長方形に切り取ります。GIF -dispose メソッドは考慮されません。
	これは -deconstruct 演算子とまったく同じであり、特にアニメーションで '`Previous`' や '`Background`' などのレイヤー処理メソッドが使用されている場合は、アニメーションの通常の動作は保持されません。
compare-clear	'`compare-any`' と同じですが、2 番目のフレームで透明になる不透明ピクセルの境界まで切り取ります。これは、次のフレームのピクセルをマスクまたは消去するために必要な最小の画像です。
compare-overlay	'`compare-any`' と同じですが、カラーピクセルを重ね合わせた結果として、次の画像に追加の色を追加するピクセルまで切り取ります。これは、色を追加または変更するための最小の単一の重ね合わせ画像です。
	これは、-compose アルファ合成方法 '`change-mask`' と一緒に使用して、オーバーレイする必要があるピクセルだけに画像を削減できます。
coalesce	-coalesce 演算子の呼び出しに相当します。現在の画像シーケンスに設定されているレイヤー処理方法を適用して、表示する必要があるように完全に定義されたアニメーションシーケンスを形成します。GIF アニメーションを「フィルムストリップ」のようなアニメーションに効果的に変換します。
合成	アルファ 2 つのイメージリストを「`null:`」イメージで区切って合成します。最初に宛先イメージリスト、最後にソースイメージが続きます。各リストのイメージは、1 つのリストが完了するまで合成されます。セパレータイメージリストとソースイメージリストは削除されます。
	-geometry オフセットは、各リストの最初の画像の仮想キャンバスサイズに応じて、-gravity に従って調整されます。通常の -composite 操作とは異なり、キャンバスオフセットは各画像の最終的な合成位置にも追加されます。
	画像リストの 1 つに画像が 1 つしか含まれていない場合、その画像は、リストがどちらであるかに関係なく、他の画像リストのすべての画像に適用されます。この場合、保持されるのはリストの画像メタデータです。
dispose	これは '`coalesce`' に似ていますが、レイヤーの破棄方法が適用された後、次のサブフレーム画像がオーバーレイされる前のアニメーションの外観を示します。これは、GIF -dispose メソッドを適用した結果の 'dispose' 画像です。これにより、開発中の特定のアニメーションで何が問題になっているかを確認できます。
flatten	現在の -background 色を使用して最初の画像の仮想キャンバスと同じサイズのキャンバスを作成し、-compose で各画像をそのキャンバスに順番に配置。そのキャンバスの外側にある画像はクリップされます。最終画像の仮想キャンバスオフセットはゼロになります。
	これは通常、準備されたすべての画像レイヤーを最終画像に重ね合わせる、最終的な「画像レイヤー化」操作の 1 つとして使用されます。
	単一の画像の場合、この方法は、仮想キャンバスを実際のピクセルで塗りつぶしたり、不透明な色を下に置いて画像から透明度を削除したりするためにも使用できます。
マージ	「フラット化」メソッドと同じですが、指定されたすべての画像レイヤーを結合して、クリッピングや余分なスペースなしで画像全体を収容できる大きさの新しいレイヤー画像を作成します。新しい画像の仮想オフセットは、このオフセットが負であっても、新しいレイヤーの位置を保持します。最初の画像の仮想キャンバスサイズは保持されます。
	負のオフセットを持つ画像レイヤーを正しく処理できる画像ファイル形式はほとんどないため、処理には注意が必要です。+repage を使用してこの操作メソッドに従うと、レイヤーオフセットが削除され、オーバーレイされたすべての画像の位置が相互に保持された画像が作成されますが、必ずしも指定した場所とまったく同じになるとは限りません。
	以下の「trim-bounds」も参照してください。これは密接に関連していますが、「flatten」を行って画像を結合することはありません。
モザイク	「flatten」メソッドと同じですが、最初の画像の初期キャンバスサイズを正の方向にのみ拡張して、すべての画像レイヤーを保持します。ただし、仮想キャンバスは定義により原点に「ロック」されるため、負のオフセットを持つ画像レイヤーは上端と左端でクリップされます。これが問題になる可能性がある場合は、「merge」または「trim-bounds」を参照してください。
	この方法は、最終的なキャンバスサイズを知らなくても、さまざまなオフセットを使用して個々の画像をレイアウトするためによく使用されます。結果の画像は、「フラット化」と同様に仮想オフセットを持たないため、任意の画像ファイル形式で保存できます。
最適化	いくつかの一般的な手法を使用して、結合されたアニメーションを GIF アニメーションに最適化します。これは現在、「`optimize-frame`」と「`optimize-transparency`」の両方の方法を適用するためのショートカットですが、開発される他の最適化方法を含めるように拡張される可能性があります。
optimize-frame	結合されたアニメーションを GIF アニメーションに最適化します。使用する最適なレイヤー処理方法を選択しようとすることで、フレームあたりのピクセル数を可能な限り減らし、結果が適切にアニメーション化され続けるようにします。
	最適な最適化が見つかる保証はありません。ただし、これを実行できる適度に高速な GIF 最適化アルゴリズムはありません。ただし、これは他のほとんどの GIF フレームオプティマイザーよりも優れているようです。
optimize-plus	'`optimize-frame`' と同じですが、アニメーションの最終的な外観やタイミングを変更せずに、アニメーションに追加のフレームを追加することで全体的な最適化を改善しようとします。フレームが追加されるのは、ピクセルのクリアと、1 つのアニメーションフレームから次のフレームへの新しい追加ピクセルのオーバーレイを分離しようとするためです。これによって最適化が改善されない場合 (次のフレームのみ)、以前の通常の '`optimize-frame`' 手法の結果に戻ります。
	廃棄スタイルの変更によって、後のフレームの最適化が悪化する可能性がありますが、その可能性は低いです。つまり、通常の '`optimize-frame`' 手法よりも優れているという保証はありません。ただし、一部のアニメーションでは、最終的なアニメーションサイズが大幅に改善されます。
optimize-transparency	GIF アニメーションの場合、結果のアニメーションが現在の -fuzz 係数を超えて変化しない場合は、サブフレームオーバーレイイメージ内の任意のピクセルを透明に置き換えます。
	これにより、最後のフレームの現在の配置イメージを繰り返す複数の色のパターンではなく、1 つの (透明) 色の領域が大きくなるため、既存のフレーム最適化 GIF アニメーションを、より小さなファイルサイズに圧縮できるようになります。
remove-dups	重複する連続イメージを削除 (および時間遅延をマージ) して、結合されたアニメーションのレイヤーオーバーレイを簡素化します。
	通常、これはアニメーション全体で一定の時間遅延を使用した結果、または大きなアニメーションが小さなサブアニメーションに分割された結果です。重複したフレームは、フレーム最適化方法の一部として使用することもできます。
remove-zero	すべての画像に時間遅延がゼロでない限り、時間遅延がゼロの画像を削除します (適切な時間指定のアニメーションでない場合は、警告が発行されます)。
	GIF アニメーションでは、このような画像は通常、実際にユーザーに表示されるフレーム間の部分的な中間更新を提供するフレームです。これらのフレームは通常、GIF アニメーションのフレーム最適化を改善するために追加されます。
トリム境界	現在の画像シーケンス内のすべての画像の境界を見つけ、オフセットを調整して、すべての画像が最小の正のキャンバスに収まるようにします。画像データは変更または結合されず、個々の画像の仮想キャンバスサイズとオフセットのみが変更または結合されます。すべての画像に同じキャンバスサイズが与えられ、正のオフセットが与えられますが、互いの相対位置は同じままです。最小のキャンバスサイズの結果、少なくとも 1 つの画像がそのキャンバスのすべての端に接します。ただし、それらの端に接する画像データは透明である可能性があります。
	結果は、すべての画像が別々に保持されている点を除いて、'merge' の後に +repage オプションを使用した場合とほぼ同じです。'trim-bounds' を使用した後に 'flatten' を使用すると、同じ結果が得られます。

レイヤータイプの完全なリストを出力するには、-list layers を使用します。

演算子 -coalesce、-deconstruct、-flatten、および -mosaic は、上記のメソッドの別名にすぎず、将来廃止される可能性があります。-page、-repage 演算子、-compose 設定、および GIF -dispose および -delay 設定も参照してください。

-level `black_point`{,`white_point`}{`%`}{,`gamma`}

画像チャンネルのレベルを調整します。

コンマで区切られた 1 つ、2 つ、または 3 つの値を指定します: black-point、white-point、gamma (例: 10,250,1.0 または 2%,98%,0.5)。黒点と白点の範囲は 0 から QuantumRange、つまり 0 から 100% です。白点が省略された場合は、コントラストの変化を中央にするため (QuantumRange - black_point) に設定されます。文字列のどこかに % 記号がある場合、黒点と白点の両方がフルカラー範囲のパーセンテージです。Gamma は値の -gamma 調整を行います。省略された場合は、デフォルトの 1.0 (ガンマ補正なし) と見なされます。

通常の使用法 (-level) では、画像の値が引き伸ばされ、元の画像の指定された 'black_point' の値はゼロ (または黒) に設定され、指定された 'white_point' の値は QuantumRange (または白) に設定されます。これにより、画像のコントラストを直接調整できます。次に、結果画像の 'gamma' が調整されます。

ImageMagick v6.4.1-9 以降では、演算子のプラス形式 (+level) を使用するか、引数リストの任意の場所に特殊な '!' フラグを追加すると、演算子はレベル調整の逆を実行します。つまり、元の画像のゼロまたは QuantumRange の値 (それぞれ黒と白) が指定されたレベル値に調整され、画像内のコントラストを除去または圧縮できます。 'gamma' は、画像のコントラストを落とすためのレベル調整が行われる前に調整されます。

現在の -channel 設定で定義されたチャネルのみが調整され (デフォルトは RGB カラーチャネルのみ)、この演算子の効果を制限できます。

透明度チャネルは、'マット' 値 (0 は不透明) として扱われ、'アルファ' 値 (0 は透明) としては扱われないことに注意してください。

-level-colors {`black_color`}{,}{`white_color`}

ダッシュで区切られた色を使用して、画像のレベルを調整します。

この関数は -level とまったく同じですが、各カラーチャネルの値は指定された 'black_color' および 'white_color' の色によって決まります (-fill オプションで説明)。

これは、-level-colors に指定された色がそれぞれ '黒' および '白' になるようにマッピングされ、他のすべての色はその変更に合わせて線形に調整 (またはクリップ) されることを意味します。各チャネルは、指定された色のチャネル値を使用して個別に調整されます。

一方、演算子のプラス形式 (+level-colors) は、画像の色「黒」と「白」をそれぞれ指定された色にマッピングし、画像のグラデーション (コントラストを弱めた) の色合いをそれらの色に反映します。これは、プレーンなグレースケール画像を、指定された色のグラデーションを使用した画像に変換するためにも使用できます。

単一の色をその色の前または後にコンマ区切りで指定すると、それぞれ「黒」または「白」のポイントが置き換えられます。ただし、コンマ区切りが指定されていない場合は、指定された色が黒と白の両方のカラーポイントに使用され、演算子は画像をその色を中心にしきい値処理するか (- 形式)、すべての色をその色に設定します (+ 形式)。

-limit `type value`

ピクセルキャッシュリソース制限を設定します。

width、height、area、memory、map、disk、file、thread、throttle、または time から選択します。

file の値はファイル数です。その他の制限はバイト数です。メモリ、マップ、領域、およびディスクリソース制限の引数を SI プレフィックス (例: 100MB) で定義します。

デフォルトでは、制限は 768 ファイル、3GB のイメージ領域、1.5GiB のメモリ、3GiB のメモリマップ、および 18.45EB のディスクです。これらの制限は、この情報が利用可能な場合、コンピューターで使用可能なリソースに応じて調整されます。いずれかの制限に達すると、ImageMagick は何らかの方法で失敗しますが、可能な場合は補償アクションを実行しようとします。たとえば、次の例ではメモリが制限されます:

-limit memory 32MiB -limit map 64MiB

-list resource を使用して現在の制限を一覧表示します。たとえば、当社のシステムでは次の制限が表示されます:

-> identify -list resource
Resource limits:
  Width: 100MP
  Height: 100MP
  Area: 25.181GB
  Memory: 11.726GiB
  Map: 23.452GiB
  Disk: unlimited
  File: 768
  Thread: 12
  Throttle: 0
  Time: unlimited

中間画像を保持するためのピクセルストレージの要求は、-limit 設定とシステムがリソース要求を尊重するかどうかに応じて、メモリ内プール、メモリマップファイルプール、ディスクプール (この順序) の 3 つのリソースカテゴリのいずれかによって満たされます。指定されたプールに割り当てられたピクセルストレージの合計サイズが対応する制限に達すると、要求は次のプールに渡されます。さらに、area 制限を超える要求は自動的にディスクに割り当てられます。

ImageMagick がリソース制限をどのように利用するかを説明するために、一般的な画像リソース要求について考えてみましょう。まず、ImageMagick はメモリにピクセルを割り当てようとします。リソース要求が memory 制限を超えるか、システムが要求を尊重しない場合、要求は拒否される可能性があります。メモリ要求が尊重されない場合、ピクセルはディスクに割り当てられ、ファイルはメモリマップされます。ただし、割り当て要求が map 制限を超えると、リソース割り当てはディスクに行われます。いずれの場合も、リソース要求が area 制限を超えると、ピクセルは自動的にディスクにキャッシュされます。ディスクにハード制限がある場合、プログラムは失敗します。

ほとんどの場合、リソース制限について心配する必要はありません。ImageMagick は適切なデフォルトを選択し、ほとんどの画像はコンピュータリソースに負担をかけません。制限が役立つのは、サイズの大きい画像を処理する場合や、ImageMagick が使用可能なメモリのすべてまたはほとんどを消費する可能性がある共有システムで処理する場合です。この場合、ImageMagick ワークフローは他のプロセスを遅くするか、極端な場合にはシステムを停止させます。このような状況では、制限を設定すると、ImageMagick ワークフローがコンピュータの他の同時使用を妨げないことが保証されます。たとえば、インターネットからアップロードされた画像を処理する Web インターフェイスがあるとします。ImageMagick が 10MiB のメモリを超えないようにするには、領域制限を 10MiB に設定するだけです。

-limit area 10MB

これで、大きな画像が処理されるたびに、ピクセルはメモリではなくディスクに自動的にキャッシュされます。もちろん、これは大きな画像の処理が通常非常に遅いことを意味します。これは、メモリ内のピクセル処理がディスク上よりも桁違いに高速になる可能性があるためです。 Web サイトのユーザーが誤って巨大な画像をアップロードして処理する可能性があるため、ディスク制限も設定する必要があります:

-limit area 10MB -limit disk 500MB

ここで、ImageMagick は、画像が 500 MB を超えるディスクストレージを必要とする場合に処理を停止します。

コマンドラインリソース制限オプションに加えて、environment variables を使用してリソースを設定できます。環境変数 MAGICK_AREA_LIMIT、MAGICK_DISK_LIMIT、MAGICK_FILE_LIMIT、MAGICK_MEMORY_LIMIT、MAGICK_MAP_LIMIT、MAGICK_THREAD_LIMIT、MAGICK_TIME_LIMIT をそれぞれ設定して、画像領域、ディスク領域、開いているファイル、ヒープメモリ、メモリマップ、実行スレッド数、最大経過時間 (秒単位) の制限を設定します。

security policies を基準として制限を制限できますが、制限を緩和することはできません。

好奇心旺盛なユーザーは、コマンドに -debug cache を追加して、生成された出力からピクセルキャッシュへの参照を探し、ピクセルキャッシュがどのように割り当てられ、リソースがどのように消費されたかを調べることができます。上級の Linux/Linux ユーザーは、その出力を grep memory|open|destroy|disk にパイプして、より読みやすいふるい分けを行うことができます。

ImageMagick のリソースの使用の詳細については、Architecture ページのセクションキャッシュストレージとリソース要件を参照してください。

-linear-stretch `black-point`

彩度ストレッチによる線形。

これは -contrast-stretch と非常によく似ており、「ヒストグラムビン」を使用して、ストレッチする必要がある色値の範囲を決定します。ただし、その後、-level 演算子を使用してそれらの色を引き伸ばします。

そのため、最初の決定では「ビニング」の丸め効果が発生する可能性がありますが、画像の色はヒストグラムビンを使用するのではなく、数学的に引き伸ばされます。これにより、演算子の精度が向上します。

ただし、-linear-stretch が「0」の場合は何も行われませんが、「1」の場合は色の範囲がほぼ完全に引き伸ばされることに注意してください。

数学的画像の「完全な」正規化については、-auto-level も参照してください。

この演算子は再開発のために検討中です。

-linewidth

後続の描画操作の線幅。

-liquid-rescale `geometry`

シームカービングを使用してイメージのサイズを変更します。

ジオメトリ引数の詳細については、Image Geometry を参照してください。

-list `type`

さまざまなオプションまたは設定でサポートされている引数のリストを出力します。次のリストタイプから選択します:

Align
Alpha
Boolean
Cache
Channel
Class
ClipPath
Coder
Color
Colorspace
Command
Complex
Compose
Compress
Configure
DataType
Debug
Decoration
Delegate
Direction
Dispose
Distort
Dither
Endian
Evaluate
FillRule
Filter
Font
Format
Function
Gravity
Intensity
Intent
Interlace
Interpolate
Kernel
Layers
LineCap
LineJoin
List
Locale
LogEvent
Log
Magic
Method
Metric
Mime
Mode
Morphology
Module
Noise
Orientation
PixelIntensity
Policy
PolicyDomain
PolicyRights
Preview
Primitive
QuantumFormat
Resource
SparseColor
Statistic
Storage
Stretch
Style
Threshold
Type
Units
Validate
VirtualPixel

これらのリストは、ImageMagick のバージョンによって異なります。使用可能なすべての "-list" 引数の完全なリストを取得するには、"-list list" を使用します:

magick identify -list list

-log `string`

デバッグログの形式を指定します。

このオプションは、-debug オプションがアクティブなときに出力されるログの形式を指定します。

特別なフォーマット文字を埋め込むことで、次のコンポーネントを表示できます:

%d: ドメイン
%e: イベント
%f: 関数
%l: 行
%m: モジュール
%p: プロセスID
%r: 実CPU時間
%t: 実時間
%u: ユーザーCPU時間
%%: パーセント記号
\n: 改行
\r: 復帰

例:

magick -debug coder -log "%u %m:%l %e" in.gif out.png

デフォルトの動作では、すべてのコンポーネントが印刷されます。

-loop `iterations`

GIF アニメーションに Netscape ループ拡張機能を追加します。

反復回数を 0 に設定すると、アニメーションが無限に繰り返されます。それ以外の場合は、アニメーションが最大 iterations 回繰り返されます。

-lowlight-color `color`

画像を比較するときに、この色を使用してピクセルの違いを強調しないようにします。

-magnify

ピクセルアートのスケーリングを使用して、画像のサイズを 2 倍または 3 倍にします。 -define magnify:method=method で代替のスケーリング方法を指定します。次の方法から選択します: eagle2X, eagle3X, eagle3XB, epb2X, fish2X, hq2X, scale2X, scale3X, xbr2X。デフォルトは scale2X です。

-map `type`

この type を使用して画像を表示します。

次の Standard Colormap タイプから選択します:

best
default
gray
red
green
blue

X server は選択した Standard Colormap をサポートしている必要があります。サポートしていない場合はエラーが発生します。タイプとして list を使用し、display はカラーマップタイプのリストを top-to-bottom の順序で検索して、1 つが見つかるまで検索します。標準カラーマップを作成する方法の 1 つについては、xstdcmap(1) を参照してください。

-map `components`

ピクセルマップ。

マップの有効なコンポーネントは次のとおりです:

r: 赤のピクセルコンポーネント
g: 緑のピクセルコンポーネント
b: 青のピクセルコンポーネント
a: アルファピクセルコンポーネント (0 は透明)
o: 不透明度ピクセルコンポーネント (0 は不透明)
i: グレースケール輝度ピクセルコンポーネント
c: シアンピクセルコンポーネント
m: マゼンタピクセルコンポーネント
y: イエローピクセルコンポーネント
k: ブラックピクセルコンポーネント
p: パッドコンポーネント (常に 0)

これらのコンポーネントは、必要な数だけ任意の順序で指定できます (例: bgr)。コンポーネントを繰り返すこともできます (例: rgbr)。

-mattecolor `color`

-frame オプションで使用する色を指定します。

色は、-fill オプションで説明されている形式を使用して指定されます。

デフォルトのマットカラーは #BDBDBD (グレーの濃淡) です。

-maximum

画像シーケンスの最大強度を返します。

周囲のすべてのピクセルから「最大」値を選択します。

これは、同じ名前の method からのレガシーオプションです。

-median `geometry`

画像に中央値フィルターを適用します。

周囲のすべてのピクセルから「中間」の値を選択します。

これは、同じ名前の method からのレガシーオプションです。

-mean-shift `width`x`height`{`+distance`{%}

画像ノイズ除去および色削減/セグメンテーション (例: -mean-shift 7x7+10%)。

widthxheight はウィンドウサイズ、distance は 0 ～ 1 または 0 ～ 100% の範囲で測定された色距離です

平均シフトアルゴリズムは反復的であるため、ウィンドウサイズが大きいほど遅くなります。各ピクセルについて、そのピクセルを中心とするウィンドウ内のすべてのピクセルを取得し、ピクセルを囲む radius=sqrt((width-1)(height-1)/4) の外側にあるピクセルを除外します。それらのピクセルから、現在の平均値から指定された 2 乗の色距離内にあるピクセルを見つけます。次に、それらの座標と新しい平均値から新しい x、y 重心を計算します。この新しい x、y 重心が新しいウィンドウの中心として使用されます。このプロセスは収束するまで反復され、最終的な平均値を使用して元のピクセル値を置き換えます。このプロセスを次のピクセルに対して繰り返し、画像内のすべてのピクセルを処理します。RGB ではなく他の色空間を使用すると、結果が向上します。同等の結果が得られると思われる YIQ、YUV、または YCbCr をお勧めします。

-metric `type`

type で指定されたメトリックに従って、イメージ間の差異の測定値を STDERR に出力します。

次から選択:

AE: 絶対エラー数、異なるピクセル数 (ファズの影響なし)
DSSIM: 構造的相違度指数
FUZZ: 平均色距離
MAE: 平均絶対エラー (正規化)、平均チャネルエラー距離
MEPP: ピクセルあたりの平均エラー (正規化された平均エラー、正規化されたピーク誤差)
MSE: 平均誤差の二乗、チャネル誤差の二乗の平均
NCC: 正規化された相互相関
PAE: ピーク絶対値 (正規化されたピーク絶対値)
PHASH: sRGB および HCLp カラースペースの知覚ハッシュ。-define phash:colorspaces=colorspace,colorspace,... で代替カラースペースを指定します
PSNR: ピーク信号対雑音比
RMSE: 二乗平均平方根 (正規化された二乗平均平方根)
SSIM: 構造類似性指数

-fuzz 係数を使用して、'AE' (異なるピクセルの絶対数) を制御します (わずかな量しか変化していないピクセルは無視します)。'PAE' を使用して、すべてのピクセルを '類似' にするために必要な -fuzz 係数のサイズを見つけます。'MAE' は、約半分のピクセルを類似させるために必要な係数を決定します。

MEPP メトリックは、1 回の比較実行から 3 つの異なるメトリック (「MAE」、「MAE」正規化、および「PAE」正規化) を返します。

SSIM および DSSIM メトリックは、次の定義に従います: -define compare:ssim-radius、-define compare:ssim-sigma、-define compare:ssim-k1、および -define compare:ssim-k2。

メトリックの完全なリストを出力するには、-list metric オプションを使用します。

-minimum

画像シーケンスの最小強度を返します。

周囲のすべてのピクセルから「最小」値を選択します。

これは、同じ名前の method からのレガシーオプションです。

-mode `geometry`

各ピクセルを近傍の \'主な色\' にします。'

-mode `value`

操作モード。

次のスタイルから value を選択します: Frame, Unframe, or Concatenate

ImageMagick インストールで使用可能な -mode 引数のリストを表示するには、-list オプションを 'Mode' 引数とともに使用します。

-modulate `brightness`[,`saturation`,`hue`]

画像の brightness、saturation、hue を変更します。

引数は、変化のパーセンテージとして指定します。値が 100 の場合は変化なしを意味し、値が欠落している場合は 100 とみなされます。

brightness は画像全体の明るさの乗数です。0 は純粋な黒、50 は半分の明るさ、200 は 2 倍の明るさを意味します。意味を反転するには、前後の画像に -negate を使用します。

saturation は画像内の色の量を制御します。たとえば、0 はグレースケール画像を生成しますが、200 などの大きな値は非常にカラフルな「漫画のような」色を生成します。

hue 引数は、指定された量だけ画像内の色を「回転」させます。たとえば、50 は反時計回りに 90 回転し、赤の色合いを紫にマッピングします。値が 0 または 200 の場合、画像は完全に 180 度回転します。値 300 を使用すると 360 度回転しますが、元の画像は変更されません。

たとえば、色の明るさを 20% 上げ、色の彩度を 10% 下げ、色相を変更しない場合は、-modulate 120,90 を使用します。

'option:modulate:colorspace' の -set 属性を使用して、調整する色空間を指定します。HCL、HCLp、HSB、HSI、HSL (デフォルト)、HSV、HWB、または LCH (LCHab) から選択します。たとえば、

magick image.png -set option:modulate:colorspace hsb -modulate 120,90 modulate.png

-moments

画像のモーメントと知覚ハッシュを報告します。

-monitor

進行状況を監視します。

-monochrome

画像を白黒に変換します。

-morph `frames`

画像シーケンスをモーフィングします。

画像ピクセルとサイズの両方が線形補間され、現在の画像リスト内のすべての画像にわたって、1 つの画像から次の画像への変形の外観が得られます。追加された画像は、-blend 合成と同等です。frames 引数は、各画像の間に補間する画像の数を決定します。

-morphology

-morphology `method` `kernel`

画像にモルフォロジー法を適用します。

IM Usage Examples, Morphology を参照してください。

-mosaic

-layers メソッド「モザイク」の単純なエイリアス

-motion-blur `radius`

モーションブラーをシミュレートします。

指定された半径、標準偏差 (シグマ)、角度でブラーします。指定された角度は、画像がブラーされる角度です。これは、オブジェクトがどこから来ているのかを人々が考える方向です。

ブラーは均一に分布していないため、動きに明確な移動方向の感覚が与えられます。

-virtual-pixel 設定は、画像外のピクセルを最終結果にぼかす方法を決定します。

-name

画像に名前を付けます。

-negate

各ピクセルをその補色に置き換えます。

画像の赤、緑、青の強度が打ち消されます。白は黒になり、黄色は青になります。画像のグレースケールピクセルのみを打ち消すには、+negate を使用します。

-noise `geometry`

画像にノイズを追加または削減します。

ノイズピーク除去フィルタの主な機能は、エッジ情報を失うことなく、また望ましくない構造を作成せずに、画像内のオブジェクトを滑らかにすることです。このアルゴリズムの中心的な考え方は、ピクセルがノイズであると判明した場合、ピクセルウィンドウ内でそのピクセルをその次の隣接ピクセルに置き換えることです。ピクセルがノイズとして定義されるのは、このピクセルがピクセルウィンドウ内で最大または最小である場合のみです。

ノイズを削減するときに近傍の幅を指定するには、-noise radius を使用します。これは、-statistic NonPeak 操作を使用するのと同じであり、優先して使用する必要があります。

画像にノイズを追加するには、+noise に続いてノイズ type を使用します。次のノイズタイプから選択します。

Gaussian
Impulse
Laplacian
Multiplicative
Poisson
Random
Uniform

追加されるノイズの量は、-attenuate 設定で制御できます。設定されていない場合、値は 1.0 または最大ノイズ追加に相当します。

Random は、画像にノイズを追加するのではなく、画像をノイズで置き換えることに注意してください。画像にランダムノイズを追加する場合は、Uniform を使用します。

ノイズの完全なリストを出力するには、-list noise オプションを使用します。

また、制御値を使用して画像に追加されるノイズの量を指定できる -evaluate ノイズ関数も参照してください。

-normalize

画像のコントラストを強度値の範囲で増加します。

強度値は、可能な値の範囲全体をカバーするように拡張されます。その際、最大 2% のピクセルがブラックアウトされ、最大 1% のピクセルがホワイトアウトされます。

ImageMagick 6.4.7-0 以降、-normalize は -contrast-stretch 2%x1% と同等です。(このバージョンより前は、-contrast-stretch 2%x99% と同等でした)。

詳細については、-contrast-stretch を参照してください。数学的に生成された画像に適した「完全な」正規化については、-auto-level も参照してください。

この演算子は再開発のために検討中です。

-opaque `color`

この色を画像内の塗りつぶし色に変更します。

color 引数は、-fill オプションで説明されている形式を使用して定義されます。-fuzz 設定を使用すると、指定された色に類似した色を一致させて置き換えることができます。

+opaque を使用して、ターゲット色と一致しないピクセルをペイントします。

-transparent 演算子は -opaque とまったく同じですが、一致する色を現在の -fill 色設定ではなく透明度に置き換えます。これを確実に実行できるようにするために、新しい透明色に対して「-alpha set」に従って画像でアルファチャネルが有効になっていることも確認し、アルファチャネル処理を有効にするために -channel を変更する必要はありません。

-ordered-dither `threshold_map`{,`level`...}

指定された定義済みの順序付きディザ threshold map と、色チャネルごとに指定された数の levels を含む均一なカラーマップを使用して画像をディザリングします。

次の標準しきい値マップから選択できます:

threshold   1x1   Threshold 1x1 (non-dither)
checks      2x1   Checkerboard 2x1 (dither)
o2x2        2x2   Ordered 2x2 (dispersed)
o3x3        3x3   Ordered 3x3 (dispersed)
o4x4        4x4   Ordered 4x4 (dispersed)
o8x8        8x8   Ordered 8x8 (dispersed)
h4x4a       4x1   Halftone 4x4 (angled)
h6x6a       6x1   Halftone 6x6 (angled)
h8x8a       8x1   Halftone 8x8 (angled)
h4x4o             Halftone 4x4 (orthogonal)
h6x6o             Halftone 6x6 (orthogonal)
h8x8o             Halftone 8x8 (orthogonal)
h16x16o           Halftone 16x16 (orthogonal)
c5x5b       c5x5  Circles 5x5 (black)
c5x5w             Circles 5x5 (white)
c6x6b       c6x6  Circles 6x6 (black)
c6x6w             Circles 6x6 (white)
c7x7b       c7x7  Circles 7x7 (black)
c7x7w             Circles 7x7 (white)

threshold は、画像の単純な 50% しきい値を生成しました。これを level と一緒に使用すると、-posterize と同等のことが実行され、イメージが基本的な原色に縮小されます。

checks パターンは、3 レベルのチェッカーボードディザパターンを生成します。つまり、グレースケールが、黒一色、白一色、中間色のパターンから、黒と白のチェッカーボードパターンになります。

イメージの順序付きディザリングとハーフトーン処理用に、個人用またはシステム用の XML ファイルで独自の threshold map を定義できます。構成ファイルの詳細については、Resources を参照してください。

定義されているしきい値の完全なリストを印刷するには、-list threshold オプションを使用します。

この時点では、すべてのカラーチャネルに同じしきい値ディザリングマップが使用され、オフセット印刷効果を作成するために、異なるチャネルのマップをオフセットまたは回転する試みは行われないことに注意してください。また、マップは単純なしきい値レベルであるため、ハーフトーンマップと円マップは、カラー領域のエッジに沿って不完全な円を作成します。また、すべての効果は、円を滑らかに見せるためのアンチエイリアシングなしで、純粋にオン/オフのブール効果です。大きなドットは、作成後に少しぼかしを加えることで見栄えを良くすることができます。

-orient `image orientation`

デジタルカメラ画像の方向を指定します。

これは設定であることに注意してください。これは方向メタデータを設定するだけで、画像を変更するものではありません。

許可されている方向と、画像の方向を変更する方法の EXIF コードと説明は次のとおりです:

未定義: タグなし: 未定義
左上: 1: 何もしない
右上: 2: 水平に反転
右下: 3: 180 度回転
左下: 4: 反転垂直
左上: 5: 90 度回転して水平に反転 (転置)
右上: 6: 90 度回転
右下: 7: 90 度回転して垂直に反転 (横方向)
左下: 8: 270 度回転

方向の完全なリストを出力するには、-list orientation オプションを使用します。

-page `geometry`

より大きな仮想キャンバス上の画像のサイズと位置を設定します。

ジオメトリ引数の詳細については、Image Geometry を参照してください。

便宜上、media を使用してページサイズを指定できます (下記参照)。その後、他の geometry 引数と同様にオフセットを追加できます (例: -page Letter+43+43)。

PostScript ページの寸法 (widthxheight) をドット/インチで指定するか、TEXT ページをピクセルで指定するには、media を省略形として使用します。用紙サイズの選択肢は次のとおりです: 4x6、5x7、7x9、8x10、9x11、9x12、10x13、10x14、11x17、4A0、2A0、a0、a1、a2、a3、a4、a4small、a5、a6、a7、a8、a9、a10、archa、archb、archC、archd、arche、b0、b1、b10、b2、b3、b4、b5、b6、b7、b8、b9、 c0、c1、c2、c3、c4、c5、c6、c7、csheet、dsheet、esheet、executive、flsa、flse、folio、halfletter、isob0、isob1、isob10、isob2、 62、isob4、isob5、isob6、isob7、isob8、isob9、jisb0、jisb1、jisb2、jisb3、jisb4、jisb5、jisb6、ledger、legal、letter、lettersmall、monarch、quarto、 tabloid。72DPI でのピクセル単位の対応するサイズを決定するには、次のコマンドを使用します。

magick xc: -format "%[papersize:a4]" info:

このオプションは、GIF89 や MNG などのオフセットをサポートするマルチイメージ形式に書き込むときにサブイメージを配置するためにも使用されます。この目的で使用する場合、オフセットは常にキャンバスの左上隅から測定され、-gravity オプションの影響を受けません。GIF または MNG イメージを配置するには、-page{+-}x{+-}y (例: -page +100+200) を使用します。MNG ファイルに書き込む場合、幅と高さがゼロでないシーケンスの最初のイメージの前に表示される -page オプションによって、MHDR チャンクに書き込まれる幅と高さの値が定義されます。それ以外の場合、MNG の幅と高さは、シーケンス内のすべてのイメージを含む境界ボックスから計算されます。GIF89 ファイルを書き込む場合、その寸法を決定するために境界ボックス方式のみが使用されます。

PostScript ページの場合、画像のサイズは -geometry と同じですが、ページの lower left-hand corner に対して {+-}xoffset{+-}y offset で相対的に配置されます。たとえば、画像をページ内で中央に配置するには、-page 612x792 を使用します。画像のサイズが PostScript ページを超える場合は、ページに収まるように縮小されます。-page オプションのデフォルトの重力は NorthWest です。つまり、-gravity オプションが NorthWest 以外の値で指定されていない限り、正の x と y offset は、ページの左上隅から右方向と下方向に測定されます。

TEXT 画像のデフォルトのページ寸法は 612x792 です。

このオプションは -density と組み合わせて使用されます。

+page を使用して、画像のページ設定を削除します。

ページサイズの完全なリストを印刷するには、-list pagesize オプションを使用します。

-paint `radius`

油絵をシミュレートします。

各ピクセルは、radius で幅が指定された円形の近傍内で最も頻繁に使用される色に置き換えられます。

-path `path`

ディスク上のこのパスに画像を書き込みます。

-pause `seconds`

アニメーションループ間の一時停止

アニメーションを繰り返す前に、指定した秒数だけ一時停止します。

-pause `seconds`

スナップショット間の一時停止

次のスナップショットを撮る前に、指定した秒数だけ一時停止します。

-perceptible `epsilon`

値が |epsilon| 未満の各ピクセルを -epsilon または epsilon (いずれか近い方) に設定します。それ以外の場合は、ピクセル値は変更されません。

-ping

イメージ番号、ファイル名、イメージの幅と高さ、イメージがカラーマップされているかどうか、イメージ内の色数、イメージ内のバイト数、イメージの形式 (JPEG、PNM など) などのイメージ特性を効率的に判別します。正確なイメージプロパティを確保するには、+ping を使用します。

-pointsize `value`

PostScript、OPTION1、または TrueType フォントのポイントサイズ。

-polaroid `angle`

ポラロイド写真をシミュレートします。

+polaroid を使用して、-15 度から +15 度までのランダムな角度でイメージを回転させます。

-poly `"wt,exp ..."`

多項式の加重和に従って複数の画像を結合します。各画像に対して、1 つの浮動小数点加重 (係数) と 1 つの浮動小数点多項式指数 (累乗) がコンマ区切りのペアとして表されます。

加重は通常、-1 から 1 の間の分数にする必要があります。ただし、非 HDRI モードで白黒にクランプされないようにするには、加重の合計は 1 または少なくとも 0 から 1 の間にする必要があります。

指数は正、負、または 0 のいずれかです。負の指数は、1 を対応する正の指数で乗じた画像で割った値に相当します。0 の指数は、画像が何であっても、常に量子範囲で白にスケーリングされた 1、つまり wt*white を生成します。

形式は次のとおりです: output = wt1*image1^exp1 + wt2*image2^exp2 ...

簡単な使用例は次のとおりです:

すべての重みが 1 になり、すべての指数が 1 である場合の各画像の重み付き合計。重みがすべて 1/(画像の数) に等しい場合、これは -evaluate-sequence mean と同等です。
重みが等しく (クランプを回避するために合計が 1 になる)、指数が 2 である場合の 2 つ以上の画像の平方の合計。

画像の 1 つに xc:somecolor を使用し、必要な重みと指数を 0 に指定するだけで、式に定数色を追加できることに注意してください。

同様に、画像の 1 つに適切な重みと指数を 0 に指定して null: (または xc:white) を使用するだけで、式に白を追加できます。

-posterize `levels`

画像をチャネルごとに限られた数のカラーレベルに減らします。

levels の値を非常に低くすると (たとえば 2、3、4)、最も目に見える効果が得られます。

-precision `value`

印刷する有効桁の最大数を設定します。

-preview `type`

画像プレビュータイプ。

このオプションを使用して、画像のプレビュー操作に影響します (例: magick file.png -preview Gamma Preview:gamma.png)。次のプレビューから選択します:

AddNoise
Blur
Brightness
Charcoal
Despeckle
Dull
EdgeDetect
Gamma
Grayscale
Hue
Implode
JPEG
OilPaint
Quantize
Raise
ReduceNoise
Roll
Rotate
Saturation
Segment
Shade
Sharpen
Shear
Solarize
Spiff
Spread
Swirl
Threshold
Wave

プレビューの完全なリストを印刷するには、-list preview オプションを使用します。

デフォルトのプレビューは JPEG です。

-print `string`

文字列を解釈してコンソールに印刷します。

-process `command`

カスタム画像フィルターを使用して画像を処理します。

コマンド引数の形式は "module arg1 arg2 arg3 ... argN" です。ここで、module は呼び出すモジュールの名前 (例: "Analyze") で、arg1 arg2 arg3 ... argN はプロセスモジュールに渡す任意の数の引数です。

-profile `filename`

イメージ内の ICM、IPTC、または汎用プロファイルを管理します。

-profile filename を使用すると、ICM (ICC カラー管理)、IPTC (ニュースワイヤー情報)、または汎用プロファイルがイメージに追加されます。

指定されたプロファイルを削除するには、+profile profile_nameを使用します。 ImageMagick は標準のファイル名グロビングを使用するため、ワイルドカード式を使用して複数のプロファイルを削除できます。ここでは、XMP プロファイルを除くすべてのプロファイルを画像から削除します: +profile "!xmp,*"。

magick identify -verbose を使用すると、イメージファイルに含まれるプロファイルを確認できます。すべてのプロファイル (およびコメント) を削除するには、-strip を使用します。

プロファイルを抽出するには、-profile オプションは使用しません。代わりに、ファイルを APP1, 8BIM, ICM, や IPTC などのイメージフォーマットに書き込むだけです。

たとえば、Exif データ (APP1 プロファイルの JPEG ファイルに保存されている) を抽出するには、次を使用します。

変換精度を上げるには、-define precision:highres-transform=true を設定します。高精度の変換は符号なしではなく浮動小数点であるため、パフォーマンスがわずかに低下することに注意してください。

magick cockatoo.jpg profile.exif

元のイメージにプロファイルが既に含まれているかどうかによって結果が変わる場合があることに注意してください。また、-profile は「演算子」（「設定」ではなく）であるため、コマンドラインで順番に遭遇するたびに変換が行われることに注意してください。たとえば、次の例では、元の画像がプロファイル付きの CMYK である場合、CMYK-CMYK-RGB 変換が行われます。

magick CMYK.tif -profile "CMYK.icc" -profile "RGB.icc" RGB.tiff

さらに、ICC プロファイルは必ずしも対称ではないため、追加の変換手順によって望ましくない結果が生じる可能性があります。CMYK プロファイルは、3->4 および 4->3 チャネルマッピングを伴うため、非常に非対称であることがよくあります。

-quality `value`

JPEG/MIFF/PNG 圧縮レベル。

JPEG および MPEG 画像形式の場合、品質は 1 (最低画像品質、最高圧縮) から 100 (最高品質、最低圧縮) です。デフォルトでは、入力画像の推定品質が判別できる場合はその品質が使用され、判別できない場合は 92 が使用されます。品質が 90 以上の場合、クロマチャネルはダウンサンプリングされません。クロマダウンサンプリングの係数を指定するには、-sampling-factor オプションを使用します。

JPEG-2000 画像形式の場合、品質は非線形方程式を使用して Jasper ライブラリで必要な圧縮率にマッピングされます。この非線形方程式は、JPEG v1 形式によって提供される品質を大まかに近似することを目的としています。デフォルトの品質値は 100 で、非可逆圧縮を要求します。品質が 75 の場合、16:1 圧縮を要求します。

MNG および PNG 画像形式の場合、品質値によって zlib 圧縮レベル (品質 / 10) とフィルタータイプ (品質 % 10) が設定されます。デフォルトの PNG「品質」は 75 で、これはアダプティブ PNG フィルタリングを使用した圧縮レベル 7 を意味します。ただし、画像にカラーマップがある場合は、PNG フィルタリングなしの圧縮レベル 7 を意味します。

圧縮レベル 0 (品質値が 10 未満) の場合、ハフマンのみの戦略が使用されます。これは最も高速ですが、必ずしも最も悪い圧縮ではありません。

フィルタタイプが 4 以下の場合、指定された PNG フィルタタイプがすべてのスキャンラインに使用されます:

0: なし
1: サブ
2: アップ
3: 平均
4: Paeth

フィルタタイプが 5 の場合、次の場合に適応フィルタリングが使用されます:品質が 50 より大きく、画像にカラーマップがない場合、フィルタリングは使用されません。

フィルタタイプが 6 の場合、minimum-sum-of-absolute-values による適応フィルタリングが使用されます。

出力が MNG の場合のみ、フィルタタイプが 7 の場合は、LOCO カラー変換 (ピクセル内差分) と minimum-sum-of-absolute-values による適応フィルタリングが使用されます。

フィルタタイプが 8 の場合、zlib Z_RLE 圧縮戦略 (または圧縮レベルが 0 の場合は Z_HUFFMAN_ONLY 戦略) が適応 PNG フィルタリングとともに使用されます。

フィルタタイプが 9 の場合、PNG フィルタリングなしで zlib Z_RLE 圧縮戦略 (または圧縮レベルが 0 の場合は Z_HUFFMAN_ONLY 戦略) が使用されます。

圧縮は常にロスレスであるため、品質設定は PNG および MNG イメージの外観やシグネチャには影響しません。

-quality オプションを使用して、圧縮レベル、戦略、および PNG フィルタタイプのすべての組み合わせを取得できるわけではありません。より正確な制御を行うには、代わりにそれぞれ PNG:compression-level=N、PNG:compression-strategy=N、および PNG:compression-filter=N 定義を使用できます。-define を参照してください。定義の値は、-quality オプションの値よりも優先されます。

詳細については、PNG 仕様を参照してください。

MIFF および TIFF 画像形式の場合、quality/10 は Zip/BZip 圧縮レベルで、0 (圧縮率は最も低いが最速) から 9 (圧縮率は最も高いが最遅) までの範囲です。圧縮は常にロスレスであるため、画像の外観には影響しません。

BPG 画像形式の場合、quality/2 は実際の BPG 圧縮レベル (範囲は 0 から 51) です。

-quantize `colorspace`

この色空間を使用して色を減らします。

この設定は、-colors などの演算子によって画像に必要な色の数を整理して減らすために使用される色空間を定義します (後でディザリングするため)。GIF や PNG8 などの色数が制限された画像ファイル形式に画像を保存する場合も、色の削減が自動的に行われることに注意してください。

-quiet

すべての警告メッセージを抑制します。エラーメッセージは引き続き報告されます。

-virtual-pixel 設定は、画像外のピクセルを最終結果にぼかす方法を決定します。

-raise `thickness`

画像のエッジを明るくしたり暗くしたりします。

これにより、3D 効果が作成されます。隆起効果を作成するには -raise を使用し、それ以外の場合は +raise を使用します。

類似の -frame オプションとは異なり、-raise はイメージの寸法を変更しません。

-random-threshold `low`x`high`

イメージにランダムしきい値を適用します。

-range-threshold `low-black`,`low-white`,`high-white`,`high-black`

イメージ内の特定の値の範囲内でハードしきい値またはソフトしきい値のいずれかを実行します。

-read `filename`

暗黙的な読み取りではなく、イメージを明示的に読み取ります。

このオプションを使用すると、'option' 文字で始まるファイル名から読み取ることができます。このオプションを使用しないと、オプション (不明またはその他) と間違えられる可能性があります。

-read-mask `filename`

マスクで指定された画像ピクセルの更新を防止します。

これは、複合マスク操作に使用されるマスクを使用するのと同じで、グレースケール値により、マスクが添付されている画像のブレンド更新が発生します。

画像からマスクを削除するには、+read-mask を使用します。

同様に動作しますが、厳密なブールマスクを使用する -clip-mask も参照してください。

-red-primary `x,y`

赤の色度原点を設定します。

-regard-warnings

警告メッセージに注意してください。

このオプションにより、一部の画像形式の警告がエラーとして扱われます。

-remap `filename`

画像内の色の数を、この画像で使用される色まで減らします。

-dither 設定が有効 (デフォルト) の場合、指定された色は必要に応じて画像上でディザリングされ、そうでない場合は、最も近い色 (RGB 色空間内) が選択されて画像内のそのピクセルが置き換えられます。

現在の画像シーケンス内のすべての画像に -remap の色を適用すると、副作用として、すべての画像に同じカラーテーブルが設定されます。つまり、GIF などのファイル形式に保存すると、追加のローカルカラーテーブルを必要とせずに、そのカラーテーブルがすべての画像に対して単一の共通またはグローバルカラーテーブルとして使用されます。

+remap を使用して、現在の画像シーケンス内のすべての画像を減らし、すべての画像に共通のカラーマップを使用します。これは、すべての画像を一緒に追加し (追加の背景色なし)、256 色制限で -colors を使用してそれらの画像を色減らし、次に元の画像リストに対してそれらの色を -remap で減らすのと同じです。これにより、すべての画像が単一のカラーマップに従うことが保証されます。

すべての画像の色数が 256 未満の場合、色の変更は必要ないため、+remap では色の削減やディザリングは実行されません。その場合、その効果はグローバルカラーテーブルの使用を強制することだけです。これは、アニメーションイメージシーケンス内のカラー数を減らすために -colors または -ordered-dither のいずれかを使用した後に推奨されます。

リマップイメージカラーマップの精度は最大 8 ビットであることに注意してください。より深いカラーマップは、この要件を満たすために他のカラーと自動的に結合されます。

-region `geometry`

後続の操作が適用される領域を設定します。

x および y オフセットは、-crop の場合と同じように扱われます。

ジオメトリ引数の詳細については、Image Geometry を参照してください。

以前に設定された領域を削除するには、+region を使用します。

-remote

リモート操作を実行します。

認識されるコマンドは、ロードするイメージファイルの名前のみです。

複数の display アプリケーションを同時に実行している場合は、window オプションを使用して、制御するアプリケーションを指定します。

-render

ベクター操作をレンダリングします。

+render を使用して、ベクター操作のレンダリングをオフにします。これは、結果を MVG や SVG などのベクター形式に保存する場合に便利です。

-repage `geometry`

画像のキャンバスとオフセット情報を調整します。

このオプションは -page に似ていますが、設定ではなく画像演算子として機能します。キャンバスサイズまたはそのキャンバス上の画像のオフセットを、それらのコンポーネントのみを提供することで個別に設定できます。

ジオメトリ引数の詳細については、Image Geometry を参照してください。

! フラグが指定されている場合、指定されたオフセットが既存のオフセットに追加され、イメージが以前の位置を基準に移動されます。これは、アニメーションシーケンスに便利です。

'0x0' などのキャンバスサイズが 0 の場合、キャンバスサイズの再計算が強制され、イメージ (現在のオフセット) がそのキャンバスに完全に表示されます (負のオフセットがない限り)。

+repage を使用して、イメージから仮想キャンバスメタデータを完全に削除/リセットします。

-set 'page' オプションを使用して、仮想キャンバスメタデータを直接割り当てることができます。

-resample `horizontal`x`vertical`

指定された水平および垂直解像度に画像を再サンプリングします。

指定されたターゲット解像度で、レンダリング後のサイズが元のサイズと同じになるように画像のサイズを変更します。たとえば、300 DPI のデバイスで 3 インチ x 2 インチでレンダリングされる 300 DPI の画像の場合、その画像が 72 DPI に再サンプルされると、72 DPI のデバイスでは 3 インチ x 2 インチでレンダリングされます。画像解像度を保存できる画像形式はごくわずかです (JPEG、PNG、TIFF など)。画像解像度をサポートしていない形式の場合、再サンプル解像度を指定する前に、コマンドラインで -density を使用して画像の元の解像度を指定する必要があります。

Photoshop は、独自の埋め込みプロファイルから画像解像度を保存および取得します。このプロファイルが画像内に存在する場合、Photoshop は標準ファイルヘッダーで指定された画像解像度を無視して、以前の解像度を使用して画像を引き続き処理します。

-reshape `geometry`

画像の形状を変更します。

-resize `geometry`

画像のサイズを変更します。

ジオメトリ引数の詳細については、Image Geometry を参照してください。ジオメトリ文字列にオフセットが存在する場合、オフセットは無視され、-gravity オプションは効果がありません。

-filter オプションまたは -define filter:option=value が -resize オプションの前にある場合、画像は指定された直交フィルタを使用してサイズが変更されます。

多くの画像処理アルゴリズムでは、画像が線形ライトコーディングであると想定しています。画像がガンマ補正されている場合は、非線形ガンマ補正を削除し、変換を適用して、次のように復元できます:

magick portrait.jpg -gamma .45455 -resize 25% -gamma 2.2  \
  -quality 92 passport.jpg

注意: 一部の再サンプリング関数は、Sinc 関数の近似で減衰振動します。そのため、ImageMagick のリリースが HDRI 対応の場合、負のローブが発生する可能性があります。これを除去するには、コマンドラインに -clamp を追加します。

-respect-parentheses

設定は括弧の境界まで有効です。

-reverse

現在の画像リスト内の画像の順序を逆にします。

-roll {`+-`}`x`{`+-`}`y`

指定された量だけ画像を垂直または水平に回転させます。

負の x オフセットは画像を右から左に回転させます。負の y オフセットは画像を下から上に回転させます。

-rotate `degrees`{`<`}{`>`}

画像に Paeth 画像回転 (せん断操作を使用) を適用します。

> を使用すると、画像の幅が高さを超える場合にのみ画像を回転します。 < は、画像の幅が高さより小さい場合に、画像を only 回転します。たとえば、-rotate "-90>" を指定し、画像サイズが 480x640 の場合、画像は回転しません。ただし、画像が 640x480 の場合は、-90 度回転します。> または < を使用する場合は、ファイルのリダイレクトとして誤って解釈されないように引用符で囲みます。

画像を回転した後に残った角の空の三角形は、background の色で塗りつぶされます。

-distort 演算子、特に 'ScaleRotateTranslate' 歪曲方法も参照してください。

画像のページまたは仮想キャンバス情報も回転します。仮想キャンバスページ情報が不要な場合は、+repage を使用して削除します。

-rotational-blur `angle`

画像の中心をぼかします。

この操作は、以前は「-radial-blur」と呼ばれていました。

-sample `geometry`

ピクセルサブサンプリングとピクセル複製を使用して、それぞれ画像を縮小/拡大します。

画像から元のピクセルを直接サンプリングするだけで、画像のサイズを変更できます。拡大する場合、ピクセルはブロックで複製されます。縮小する場合、ピクセルはサブサンプリングされます (つまり、一部の行と列がスキップされます)。

したがって、結果は -resize を -filter 設定 point (最近傍) で使用した場合と同等ですが、-sample はイメージのフィルター処理をすべて回避するため、はるかに高速です。そのため、現在の -filter 設定は完全に無視されます。

-sample の主な特徴は、結果のイメージに新しい色が追加されないことですが、一部の色は消える場合があります。

ジオメトリ引数の詳細については、Image Geometry を参照してください。ジオメトリ文字列にオフセットが存在する場合、-resize とは異なり無視されます。

実際のサンプリングポイントは、サンプリングされるサブ領域の中央です。そのため、イメージの単一ピクセルサンプリングでは、中央のピクセル (イメージの寸法が偶数の場合は左上中央) が使用されます。ただし、-define 'sample:offset' を設定すると、この位置を、サンプリングされる各サブ領域内の別の場所に、パーセンテージオフセットとして変更できます。

デフォルトでは、この値は中間点の場合は '50' ですが、左上の場合は '0'、右下の場合は '100' に設定したり、サンプリングサブ領域の左中端の場合は '0x50' などの個別の X および Y オフセットで設定したりできます。

-sampling-factor `horizontal-factor`x`vertical-factor`

JPEG または MPEG-2 エンコーダーと YUV デコーダー/エンコーダーで使用されるサンプリング係数。

このオプションは、JPEG エンコーダーがクロマダウンサンプリングに使用するサンプリング係数を指定します。このオプションを省略すると、JPEG ライブラリは独自のデフォルト値を使用します。 YUV 形式の読み取りまたは書き込み時、および M2V (MPEG-2) 形式の書き込み時には、-sampling-factor 2x1 または -sampling-factor 4:2:2 を使用して 4:2:2 ダウンサンプリング方式を指定します。

-scale `geometry`

ピクセルブロック平均化とピクセル複製を使用して、それぞれ画像を縮小/拡大します。

縮小時にピクセルを平均化して置き換えるか、拡大時にピクセルを置き換えるだけで、画像のサイズを変更できます。

したがって、結果は -resize を -filter 設定 box で使用した場合と同等です。ただし、画像のフィルター処理をすべて回避するため、はるかに高速です。そのため、現在の -filter 設定は完全に無視されます。

画像を縮小 (縮小) するときに元の画像が新しい画像サイズの整数倍である場合、新しいピクセルの色を生成するために平均化されるピクセルの数は画像全体で同じになります。これは「ビニング」と呼ばれる特殊なケースで、デジタルカメラによって生成される画像などのノイズ (特に低照度条件) を軽減する方法としてよく使用されます。

-scene `value`

シーン番号を設定します。

このオプションは、イメージのシーン番号またはイメージシーケンスの最初のイメージを設定します。

キャプチャする画面を指定します。

このオプションは、イメージを取得するために使用される GetImage 要求を、指定されたウィンドウに直接ではなく、ルートウィンドウで実行する必要があることを示します。この方法では、指定されたウィンドウに重なる他のウィンドウの一部を取得できます。さらに重要なことに、独立したウィンドウであるが指定されたウィンドウの上に表示されるメニューやその他のポップアップをキャプチャできます。

-script `filename`

指定されたファイルに制御を転送します。

-seed

疑似乱数の新しいシーケンスをシードします

-segment `cluster-threshold`x`smoothing-threshold`

画像の色をセグメント化します。

色成分のヒストグラムを分析し、ファジー c 平均法で均質な単位を識別することで、画像をセグメント化します。これは、ImageMagick の色量子化ルーチンの一部です。

cluster threshold は、各クラスター内で有効と見なされるためにクラスターしきい値を超える必要があるピクセルの数として指定します。Smoothing threshold は、ヒストグラムの 2 次導関数のノイズを除去します。値を大きくするほど、2 次導関数がより滑らかになります。デフォルトは 1.5 です。

-verbose 設定が定義されている場合、カラークラスターの詳細なレポートが返されます。

-selective-blur `radius`

コントラストしきい値内のピクセルを選択的にぼかします。

コントラストがしきい値以下のピクセルをぼかします。しきい値は、QuantumRange の分数またはパーセンテージで表すことができます。

sigma 値は重要な引数であり、実際に行われるぼかしの量を決定します。

-separate

画像チャネルをグレースケール画像に分離します。チャネルは -channel で指定します。

-sepia-tone `percent-threshold`

セピア調の写真をシミュレートします。

強度のパーセントしきい値として threshold を指定します (0 - 99.9%)。

このオプションは、写真暗室でセピア調にすることで得られる効果に似た特殊効果を画像に適用します。しきい値の範囲は 0 から QuantumRange で、セピア調の程度を測る基準となります。しきい値を 80% に設定すると、適切なトーンが得られます。

-set `key value`

+set `key`

現在の画像シーケンス内の画像の画像属性とプロパティを設定します。

これにより、現在の画像シーケンス内のすべての画像に添付されている特定の設定が割り当て (または変更) されます。オプションの +set 形式を使用すると、必要に応じて、その設定が削除されるか、またはデフォルト状態にリセットされます。

たとえば、通常はオプション -delay、-dispose、および -page、-colorspace によって上書きされるような、よく知られている特定の画像メタデータ「属性」が変更されます。通常、これらの属性は、同じ名前の key を使用して、画像が読み込まれる前に割り当てられます。

上記のように、指定された key が特定の既知の「属性」と一致しない場合、設定は自由形式の「プロパティ」文字列として保存されます。このような設定は、-verbose 情報 (「info:」出力形式) に「プロパティ」としてリストされます。

これには、オプション -comment、-label、-caption を使用してイメージによって設定され、イメージに割り当てられる文字列「プロパティ」が含まれます。これらのオプションは、実際には、イメージが読み込まれるときに自動的に割り当てられるグローバル「アーティファクト」を割り当てます (Format Percent Escapes は展開されます)。例:

$ magick rose: -set Comment 'Rose is a rose is a rose is a rose' rose.jpg
identify -format %c rose.jpg
Rose is a rose is a rose is a rose

設定値は、定義値で Format and Print Image Properties を使用することもできます。例:

$ magick rose: -set origsize '%wx%h' -resize 50% \
  -format 'Old size = %[origsize]  New size = %wx%h' info:
Old size = 70x46  New size = 35x23

使用可能なその他のよく知られた「プロパティ」には、date:timestamp、date:create、date:modify、および signature があります。

-repage 演算子を使用すると、すでにメモリ内にあるイメージの 'page' 属性を変更することもできます (-page も参照)。ただし、この '属性' のサブ部分をより細かく制御できるように設計されています。-set page オプションは、'page' 属性を直接、変更せずに割り当てることしかできません。

このオプションでは、カラースペースまたはプロファイルをイメージに関連付けることもできます。たとえば、

magick image.psd -set profile ISOcoated_v2_eci.icc image-icc.psd

一部の「プロパティ」は、使用するには特定の方法で定義する必要があります。たとえば、画像の出力ファイル名を変更するために使用できるのは、「filename:」というプレフィックスが付いた「プロパティ」のみです。たとえば、

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

設定値のプレフィックスが「option:」の場合、設定は、-define オプションを使用して設定した場合とまったく同じように、グローバルな「アーティファクト」として保存されます。このような設定はグローバルスコープであるため、元の画像がかなり前に変更または破棄された場合でも、特定の画像の「属性」と「プロパティ」を渡すために使用できます。これにより、まったく異なる画像でそれらを使用できます。たとえば、次のようになります:

magick rose:  -set option:rosesize '%wx%h' -delete 0 \
  label:'%[rosesize]'   label_size_of_rose.gif"

Format Percent Escapes は、指定された key が既存の「属性」または「プロパティ」と一致しない場合にのみ「アーティファクト」と一致します。

値の先頭に registry: を付けることで、イメージレジストリの属性を設定できます。

-set profile オプションは、以下に示すコマンドラインオプションを使用するか、プログラミングインターフェイスを介してプロファイルを設定することで、以前にフォーマットされた補助チャンクを出力 PNG ファイルに挿入するためにも使用できます:

magick in.png -set profile PNG-chunk-x:<filename> out.png

x は場所フラグで、filename は最初の 4 バイトにチャンク名、その後にコロン (":")、チャンクデータが続くファイルです。このエンコーダーはチャンクの長さと CRC を計算するため、これらをファイルに含めないでください。

「x」は「b」（PLTE の前）、「m」（中間、つまり PLTE と IDAT の間）、または「e」（終了、つまり IDAT の後）のいずれかになります。同じタイプのチャンクを複数書き込む場合は、「x」の後に短い一意の文字列を追加して、後続のプロファイルが前のプロファイルを上書きしないようにします。例:

magick in.png -set profile PNG-chunk-b01:file01 \
  -profile PNG-chunk-b02:file02 out.png

-shade `azimuth`x`elevation`

遠くの光源を使用してイメージに陰影を付けます。

光源の位置として azimuth と elevation を指定します。シェーディング結果をグレースケール画像として返すには、+shade を使用します。

-shadow `percent-opacity`{x`sigma`}{`+-`}`x`{`+-`}`y`{`%`}

画像の影をシミュレートします。

-shared-memory

共有メモリを使用します。

このオプションは、ユーティリティがピックスマップに共有メモリを使用するかどうかを指定します。ImageMagick は共有メモリサポート付きでコンパイルする必要があり、ディスプレイは MIT-SHM 拡張機能をサポートする必要があります。それ以外の場合、このオプションは無視されます。デフォルトは True です。

-sharpen `radius`

画像をシャープにします。

指定された半径と標準偏差 (シグマ) のガウス演算子を使用します。

sigma の値は重要な引数であり、実際に行われるシャープニングの量を決定します。

-shave `geometry`

画像の端からピクセルを削ります。

geometry 引数の size 部分は、画像の両側から削除する領域の幅と、上部と下部から削除する領域の高さを指定します。オフセットは無視されます。

geometry 引数の詳細については、Image Geometry を参照してください。

-shear `Xdegrees`[x`Ydegrees`]

画像を x 軸および/または y 軸に沿って傾斜させます。

傾斜角度は、正、負、または 0 にすることができます。Ydegrees を省略すると、デフォルトで Xdegrees になります。両方の角度が指定されると、傾斜の水平コンポーネントが垂直コンポーネントの前に実行されます。

せん断は、画像の 1 つのエッジを x 軸または y 軸に沿って (つまり、それぞれ水平または垂直に) スライドさせ、平行四辺形を作成します。それぞれの量は、それぞれのせん断角度によって制御されます。水平せん断の場合、Xdegrees は「上」(負の y 軸) を基準として時計回りに測定され、0°<Xdegrees<90° の場合は上エッジが右に、90°<Xdegrees<180° の場合は左にスライドします。垂直せん断の場合、Ydegrees は「右」(正の x 軸) を基準として時計回りに測定され、0°<Ydegrees<90° の場合は右エッジが下に、90°<Xdegrees<180° の場合は上にスライドします。

画像のせん断で残った空の三角形は、-background オプションで定義された色で塗りつぶされます。色は、-fill オプションで説明されている形式を使用して指定されます。

水平せん断は、垂直部分の前に実行されます。水平および垂直のせん断は commute ではないため、これは重要な点です。つまり、せん断のシーケンスでは順序が重要です。たとえば、次の 2 つのコマンドは同等ではありません。

magick logo: -shear 20x0 -shear 0x60 logo-sheared.png
convert logo: -shear 0x60 -shear 20x0 logo-sheared.png

上記の 2 つのコマンドのうち最初のコマンドは、作成される空きスペースの量を除いて、次のコマンドと同等です。次のコマンドは小さい画像を生成するため、時間とスペースの観点からはより適切な選択です。

magick logo: -shear 20x60 logo-sheared.png

-sigmoidal-contrast `contrast`x`mid-point`

ハイライトやシャドウを飽和させずにコントラストを上げます。

シグモイド伝達関数を使用して、ハイライトやシャドウを飽和させずに画像のコントラストを上げます。Contrast は、コントラストを上げる量を示します。たとえば、0 はなし、3 は標準、20 は多いです。

mid-point は、結果の画像でコントラストの最大変化の「傾斜」がどこに収まるかを示します (0 は白、50% は中間グレー、100% は黒)。

デフォルトでは画像のコントラストが高くなります。コントラストを下げるには +sigmoidal-contrast を使用します。

シグモイドの明るさの変化 (ガンマ調整に似ています) と同等の効果を得るには、明るさを上げるには -sigmoidal-contrast {brightness}x0%、明るさを下げるには +sigmoidal-contrast {brightness}x0% を使用します。シグモイド曲線の中間点に '0' を使用することに注意してください。

非常に高い contrast を使用すると、画像の「スムージングされたしきい値」のようなものが生成されます。実際のしきい値ほど鮮明ではありませんが (エイリアシング効果が高い)、しきい値 mid-point 付近でグレーレベルが徐々に低下します。

-silent

サイレントに動作します。このオプションは import ツールでのみ使用されます。

-similarity-threshold `value`

サブイメージ一致の最小 RMSE。

この設定を使用すると、メトリックが値以下の一致が見つかるとすぐに検索が停止します。部分的に塗りつぶされた 2 番目の出力イメージが生成されます。値に 0 を使用すると、最初に見つかった完全な一致で検索が停止します。この設定を省略すると、検索は完了まで、または -dissimilarity-threshold で制限された範囲で続行されます。

-size `width`[x`height`][`+offset`]

イメージの幅と高さを設定します。

このオプションを使用して、GRAY、RGB、CMYK などの寸法が不明な生イメージの幅と高さを指定します。幅と高さに加えて、オフセット付きの -size を使用して、イメージ内のヘッダー情報をスキップするか、MAP イメージファイル内の色数を指定します (例: -size 640x512+256)。

Photo CD イメージの場合は、次のサイズから選択します:

-sketch `radius`

鉛筆スケッチをシミュレートします。

指定された半径、標準偏差 (シグマ)、角度でスケッチします。指定された角度は、画像がスケッチされる角度です。これは、オブジェクトが来る方向であると考えられる方向です。

-smush `offset`

透明度を無視して画像シーケンスを追加します。

Smush は -append のより柔軟なバージョンで、シーケンス内の画像を上から下 (-smush) または左から右 (+smush) に結合し、指定されたオフセットに従って画像間にギャップを設けます。

オフセットが負の場合、画像はその量だけ重なります。

-smush は -gravity に従います。空きスペースは -background の色で埋められます。

ゼロオフセットおよび透明画像の場合、2 つの画像の非透明部分は重ならずに可能な限り近く配置されます。

-snaps `value`

画面のスナップショットの数を設定します。

このオプションを使用して、X サーバー画面から複数の画像を取得し、アニメーションシーケンスを作成します。

-solarize `percent-threshold`

しきい値レベルを超えるすべてのピクセルを無効にします。

factor を強度のパーセントしきい値 (0 - 99.9%) として指定します。

このオプションは、現像プロセス中に写真フィルムを光にさらすときに見られる solarization 効果を生成します。

-sort-pixels

各スキャンライン内のピクセルを強度の昇順で並べ替えます。

-sparse-color `method` '`x`,`y` `color` ...'

指定された色のポイントを使用して指定されたイメージに色を付け、指定された方法を使用して他の中間色を塗りつぶします。

重心: 3 つのポイントが指定された 3 点の色の三角形。2 つのポイントのみを指定すると、それらのポイント間に線形グラデーションが形成されます。生成されたグラデーションは、それらの 3 つのポイントによって作成された三角形を超えて広がります。
双線形: 重心法に似ていますが、4 点です。4 点未満の場合は重心法に戻ります。
ボロノイ法: 各ピクセルを指定された最も近いカラーポイントにマップするだけです。結果は単色のポリゴンセルになります。
マンハッタン法: ボロノイ法に似ていますが、結果として得られるポリゴンセルは固定座標系にマップされます。
シェパード法: 点の色は、距離の逆二乗の比率に基づいて偏ります。色の平均値の海に色の斑点を生成します。
逆: 点の色は、逆距離の比率に基づいて偏ります。これにより、丸みを帯びた点ではなく、よりシャープな点の色が生成されます。'shepards' 平均色の海に色の点を生成します。

点は、仮想キャンバス上の画像の位置 (-page または -repage オフセット) に従って配置されます。実際に特定の画像上に存在する必要はなく、画像の端を超えた点である可能性があります。すべての点は浮動小数点値です。

-channel で定義された色チャネルのみが変更されます。つまり、デフォルトではマット/アルファ透明チャネルは影響を受けません。通常、透明チャネルは操作の前または後にオフになります。

もちろん、透明なグラデーションを生成するために一部のカラーポイントが透明である場合、その値を格納するためにイメージの透明度も有効にする必要があります。

上記のすべての方法では、単一のカラーポイントが指定されると、ポイントに関係なく、イメージ内のすべてのカラーが指定されたカラーに置き換えられます。これは論理的であり、イメージを何らかのデフォルト値に再着色する代替手法を提供します。

-splice `geometry`

現在の背景色をイメージに接合します。

これにより、指定された -gravity ジオメトリ設定に従って、現在の -background 色の行と列が指定されたイメージに追加されます。ジオメトリ引数の詳細については、Image Geometry を参照してください。基本的に、-splice は、挿入された行と列によって区切られた 4 つの象限にイメージを分割します。

ジオメトリの次元が 0 の場合、その次元には行も列も追加されません。同様に、適切な -gravity 設定でゼロオフセットを使用すると、イメージの端に行と列が追加され、その 1 つの端に沿ってのみイメージがパディングされます。端のパディングは、-splice が最も一般的に使用される用途です。

まったく同じ geometry と -gravity が後で -chop で使用されると、追加されたすべてのスプライスが削除されます。

-spread `amount`

画像ピクセルをランダムな量だけ移動します。

引数 amount は、ブレンドする候補ピクセルを選択する各ピクセルの周囲の近傍のサイズを定義します。

ルックアップは -interpolate 設定によって制御されます。

-statistic `type` `geometry`

各ピクセルを近傍の対応する統計値に置き換えます。

次の統計タイプから選択します:

コントラスト: 最大差 (最大 - 最小) を近傍の (最大 + 最小) 値で割った値
最大値: 近傍のチャネルあたりの最大値
勾配: 近傍の最大差 (最大 - 最小) 値
最大値: 近傍のチャネルあたりの最大値近傍
最小値: 近傍内のチャネルあたりの最小値
平均: 近傍内のチャネルあたりの平均値
中央値: 近傍内のチャネルあたりの中央値
最頻値: 近傍のチャネルごとの最頻値（最頻値）
非ピーク: 近傍のチャネルごとの中央値の直前または直後の値
RMS: 近傍のチャネルごとの二乗平均平方根値
標準偏差: 近傍のチャネルごとの標準偏差値

-stegano `offset`

画像内の透かしを非表示にします。

オフセットを使用して、画像の先頭からいくつかのピクセルを非表示にして画像を開始します。このオフセットと画像のサイズに注意してください。ステガノグラフィ画像を復元するには、この情報が必要になります (例: display -size 320x256+35 stegano:image.png)。

-stereo `+x`{`+y`}

2 つの画像を合成して、赤/シアンのステレオアナグリフを作成します。

ステレオペアの左側 (2 番目の画像) は、出力画像の赤チャンネルとして保存されます。右側 (最初の画像) は、緑と青のチャンネルとして保存されます。ステレオ画像を正しく表示するには、赤緑ステレオグラスが必要です。

-storage-type `type`

ピクセルストレージタイプ。有効な型は次のとおりです:

char: 符号なし文字
double: double
float: float
integer: integer
long: long
quantum: ImageMagick のネイティブ深度内のピクセル分布
short: unsigned short

float 型と double 型は 0.0 から 1.0 に正規化されます。それ以外の場合、ピクセル値は 0 からストレージタイプがサポートできる最大値までの範囲になります。

-stretch `fontStretch`

フォントのストレッチスタイルの種類を設定します。

この設定は、ImageMagick が現在選択されているフォントファミリに適用しようとするストレッチの種類を示します。次の中から fontStretch を選択してください。

Any
Condensed
Expanded
ExtraCondensed
ExtraExpanded
Normal
SemiCondensed
SemiExpanded
UltraCondensed
UltraExpanded

ストレッチタイプの完全なリストを印刷するには、-list stretch を使用します。

フォントに影響するその他の設定については、オプション -font、-family、-style、および -weight を参照してください。

-strip

画像からプロファイル、コメント、または次の PNG チャンクを削除します: bKGD、cHRM、EXIF、gAMA、iCCP、iTXt、sRGB、tEXt、zCCP、zTXt、date。方向チャンク orNT を削除するには、方向を未定義に設定します (例: -orient Undefined)。

-stroke `color`

グラフィックプリミティブをストロークするときに使用する色。

色は、-fill オプションで説明されている形式を使用して指定されます。

詳細については、-draw を参照してください。

-strokewidth `value`

ストロークの幅を設定します。

詳細については、-draw を参照してください。

-style `fontStyle`

テキストのフォントスタイルを設定します。

この設定は、ImageMagick が現在選択されているフォントファミリに適用しようとするフォントスタイルを示します。次の中から fontStyle を選択してください。

Any
Italic
Normal
Oblique

フォントに影響するその他の設定については、オプション -font、-family、-stretch、および -weight を参照してください。

-subimage-search

サブイメージを検索します。

このオプションは、比較検索で、大きな画像内の小さな画像の最も一致する場所を検索するために必要です。この検索により、2 つの画像 (または 2 つのフレーム) が生成されます。1 つ目は「差異」画像で、2 つ目は「一致スコア」画像になります。

「一致スコア」画像は、指定されたサブ画像の左上隅のあらゆる位置のピクセルを含む小さい画像です。つまり、そのサイズは、larger_image のサイズ - sub_image + 1 になります。この画像で最も明るい位置は、報告されている最も一致した位置です。これは完全に一致する場合とそうでない場合があり、実際の明るさはこれを反映します。他の明るい「ピーク」を使用して、他の可能性のある一致位置を見つけることができます。

検索では、大きい画像のすべての可能な位置でサブ画像を比較しようとするため、非常に遅くなる可能性があることに注意してください。サブ画像が小さいほど、この検索は高速になります。

-swap `index,index`

画像シーケンス内の 2 つの画像の位置を交換します。

たとえば、-swap 0,2 は現在の画像シーケンスの最初と 3 番目の画像を入れ替えます。シーケンスの最後の 2 つの画像を切り替えるには、+swap を使用します。

-swirl `degrees`

画像ピクセルを中心の周りに渦巻き状にします。

Degrees は渦巻きのきつさを定義します。

-synchronize

画像をストレージデバイスに同期します。

すべての画像データが完全にフラッシュされ、ディスクに同期されるようにするには、「true」に設定します。パフォーマンスは低下しますが、システムクラッシュが発生した場合に有効な画像ファイルを確保したり、画像ピクセルキャッシュ用のディスク領域が不足している場合に早期にレポートしたりできるという利点があります。

-taint

イメージを変更済みとしてマークします。

-text-font `name`

固定幅テキストの書き込み用フォント。

固定 (タイプライタースタイル) 形式のテキストで使用する優先フォントの名前を指定します。デフォルトは 14 ポイントの Courier です。

フォントにタグを付けて、PostScript、TrueType、または OPTION1 フォントのいずれであるかを指定できます。たとえば、Courier.ttf は TrueType フォントで、x:fixed は OPTION1 です。

-texture `filename`

画像の背景にタイル表示するテクスチャの名前。

-threshold `value`{`%`}

画像に同時黒/白しきい値を適用します。

指定されたしきい値を超えるピクセル値 (具体的には、-channel を使用して設定されたチャネル) には最大チャネル値が再割り当てされ、その他の値には最小値が割り当てられます。

しきい値は、目的のチャネル値に対応するパーセンテージまたは絶対整数値として指定できます。整数で指定する場合、最小値は 0 (すべてのチャネルが影響を受ける場合の黒に相当) ですが、最大値 (白に相当) は ImageMagick の特定のビルドの quantum depth の値であるため、インストールに依存します。そのため、ほとんどのアプリケーションでは、しきい値をパーセンテージで指定することが妥当な推奨事項です。

次の例では、赤の値が 50% を超えるピクセルは 100% の赤の値を持つように強制され、赤の値が 50% 以下のピクセルは赤チャネルで 0 に設定されます。緑、青、およびアルファチャネル (存在する場合) は変更されません。

magick in.png -channel red -threshold 50% out.png

(おそらく) 非実用的ですが、有益な例として、次の例では、入力画像と同じ寸法のすべて黒とすべて白の画像が生成されます。

magick in.png -channel RGB -threshold 100% black.png
convert in.png -channel RGB -threshold -1 white.png

-black-threshold および -white-threshold も参照してください。

-thumbnail `geometry`

画像のサムネイルを作成します。

これは -resize に似ていますが、パフォーマンスが最適化されています。さらに、コメントとカラープロファイルが削除され、Thumb プロパティが設定されます。このオプションは -filter に従います。たとえば、パフォーマンスを向上させたいが品質がわずかに低下する場合は、-filter box を使用します。

ジオメトリ引数の詳細については、Image Geometry を参照してください。

-tile `filename`

後続のグラフィックプリミティブを塗りつぶすために使用されるタイルイメージを設定します。

-tile `geometry`

イメージのレイアウトを指定します。

ジオメトリ引数の詳細については、Image Geometry を参照してください。

-tile

後続の合成操作が画像の横方向と縦方向に繰り返されることを指定します。

-tile-offset {`+-`}`x`{`+-`}`y`

タイル画像のオフセットを、タイル画像がタイルされる背景画像に対する相対値で指定します。

これは、-tile または -texture でタイル画像を設定する前に設定するか、TILE: または PATTERN: 入力形式を使用してタイルキャンバスを作成するために直接適用する必要があります。

ImageMagick は内部的に、タイル画像の設定時に指定された引数によってタイル画像の -roll を実行します。

-tint `value`

画像を塗りつぶし色で着色します。

着色の量をパーセントで指定します。黒、白、赤、黄色などの純色は -tint の影響を受けません。グレーのさまざまな色合いなどの中間色のみが影響を受けます。

-title `string`

表示される画像にタイトルを割り当てます。"、"animate"、"display"、"montage"

このオプションを使用して、画像に特定のタイトルを割り当てます。これは画像ウィンドウに割り当てられ、通常はウィンドウのタイトルバーに表示されます。オプションで、-format オプションで説明されている特殊なフォーマット文字を埋め込むことで、画像ファイル名、タイプ、幅、高さ、Exif データ、またはその他の画像属性を含めることができます。

たとえば、

-title "%m:%f %wx%h"

は、幅が 512、高さが 480 で、タイトルが bird.miff の画像に対して、MIFF:bird.miff 512x480 という画像タイトルを生成します。

-transform

画像を変換します。

このオプションは、前の -affine オプションの変換マトリックスを適用します。

magick -affine 2,2,-2,2,0,0 -transform bird.ppm bird.jpg

この演算子は、現在 -distort 'AffineProjection' メソッドに置き換えられています。

-transparent `color`

画像内でこの色を透明にします。

一致したピクセルを反転するには、+transparent を使用します。つまり、一致しないすべての色を透明にします。

-opaque 演算子は -transparent とまったく同じですが、一致する色を透明ではなく、現在の -fill 色設定に置き換えます。ただし、-transparent 演算子は、"-alpha set" に従って、イメージでアルファチャネルが有効になっていることも保証し、アルファチャネル処理を有効にするために -channel を変更する必要はありません。

これは、GIF などのカラーマップイメージ形式で使用される「透明色」として色を定義しないことに注意してください。そのためには、-transparent-color を使用します

-transparent-color `color`

透明色を設定します。

これは、ブール値の透明度を表すためにこの色を使用する GIF や PNG8 などの画像形式に保存するために使用されることがあります。これは色を透明にするものではなく、保存された画像のカラーパレットで透明色がどの色であるかを定義するだけです。不透明色を透明にするには、-transparent を使用します。

このオプションを使用すると、競合することなく、不透明な可視色と、同じ色値の透明色の両方を使用できます。つまり、画像内の透明色領域と不透明色領域の両方に同じ色を使用できます。これにより、透明色インデックスを処理しないアプリケーションで画像を表示するときに適切な透明色を選択できると同時に、ImageMagick がこのタイプの画像を正しく処理できるようになります。

デフォルトの透明色は #00000000 で、完全に透明な黒です。

-transpose

左上から右下への対角線に沿って画像をミラーリングします。

このオプションは、ピクセル配列を数学的に転置します。これはシーケンス -flip -rotate 90 と同等です。

-transverse

画像の左下から右上への対角線に沿って画像をミラーリングします。操作 -flop -rotate 90 と同等です。

-treedepth `value`

減色アルゴリズムのツリー深度。

通常、この整数値は 0 または 1 です。値が 0 または 1 の場合、減色アルゴリズムに最適なツリー深度が使用されます。

最適な深度では、通常、最速の計算速度と最小のメモリ量でソースイメージを最適に表現できます。ただし、デフォルトの深度は一部のイメージには適していません。最適な表現を保証するには、このパラメータに 2 ～ 8 の値を試してください。詳細については、color reduction algorithm を参照してください。

このオプションを有効にするには、-colors または -monochrome オプション、または色の削減を必要とするイメージ形式への書き込みが必要です。

-trim

イメージをトリミングします。

このオプションは、コーナーピクセルとまったく同じ色のエッジをすべて削除します。-trim でコーナーピクセルとほぼ同じ色のエッジを削除するには、-fuzz を使用します。

画像のページまたは仮想キャンバス情報は保存されるため、-trim 操作の結果を画像から抽出できます。仮想キャンバスページ情報が不要な場合は、+repage を使用して削除してください。

トリミングされた画像が「消える」と警告が生成され、-crop 操作で画像自体が「失われる」場合と同様に、特別な 1 ピクセルの透明な「失われた」画像が返されます。

-define trim:percent-background=0% を使用して、画像からすべての背景を削除します。エッジで許容される背景の量は、パーセントで指定します。0% は、背景が許容されないことを意味します。50% は、ファズ係数ごとにエッジに最大 50% の背景ピクセルを含めることができることを意味します。

-define trim:edges={north,east,south,west} をカンマで区切って使用すると、画像の指定されたエッジのみをトリミングできます (例: -define trim:edges=north,south -fuzz 5% -trim)。

-define trim:minSize=geometry を使用して、トリミングを指定されたサイズに制限します。

-background background-color を使用して、対象領域を囲む背景色を識別します。

-type `type`

画像タイプ。

Bilevel、Grayscale、GrayscaleAlpha、Palette、PaletteAlpha、TrueColor、TrueColorAlpha、ColorSeparation、または ColorSeparationAlpha から選択します。

通常、フォーマットがグレースケールやトゥルーカラーなどの異なるサブフォーマットをサポートしている場合、エンコーダーは効率的なサブフォーマットを選択しようとします。-type オプションを使用すると、この動作をオーバーライドできます。たとえば、グレーのピクセルしか存在しない場合でも JPEG がグレースケールフォーマットで書き込まれないようにするには、次を使用します。

magick bird.png -type TrueColor bird.jpg

同様に、出力フォーマットが透明度をサポートしている場合、-type TrueColorAlpha を使用して、画像が不透明であっても、エンコーダーがアルファチャネルを書き込むように強制します。

-type optimize を使用すると、画像が可能な限り小さいファイルサイズで書き込まれるようになります。

-undercolor `color`

注釈境界ボックスの色を設定します。

色は、-fill オプションで説明されている形式を使用して指定されます。

詳細については、-draw を参照してください。

-update `seconds`

画像ファイルが変更されたときにそれを検出し、再表示します。

画像を表示しているときに、現在表示されているファイルが上書きされたとします。display は、入力ファイルが変更されたことを自動的に検出し、それに応じて表示されている画像を更新します。

-unique-colors

ピクセルカラーの 1 つ以外をすべて破棄します。

-units `type`

画像解像度の単位。

Undefined、PixelsPerInch、または PixelsPerCentimeter から選択します。このオプションは通常、-density オプションと組み合わせて使用されます。

-unsharp `radius`

アンシャープマスク演算子を使用して画像をシャープにします。

-unsharp オプションは画像をシャープにします。画像は、指定された半径と標準偏差 (シグマ) のガウス演算子で畳み込まれます。適切な結果を得るには、半径をシグマより大きくする必要があります。適切な半径を選択するには、半径を 0 にしてください。

sigma の値は重要な引数であり、実際に行われるシャープ化の量を決定します。

radius は、計算されたガウス分布を保持する配列のサイズを決定するためにのみ使用されます。整数である必要があります。指定されないか、ゼロに設定されている場合、IM はガウス分布に意味のある結果をもたらす最大の半径を計算します。

パラメータは次のとおりです:

半径: 中心ピクセルを除いたガウス分布の半径 (ピクセル単位) (デフォルト 0)。
シグマ: ガウス分布の標準偏差 (ピクセル単位) (デフォルト 1.0)。
ゲイン: 元の画像とぼかし画像の差のうち元の画像に加算される割合 (デフォルト 1.0)。
しきい値: 差分量を適用するために必要なしきい値 (QuantumRange の割合) (デフォルトは 0.05)。

-verbose

このオプションが -identify オプションまたは info: の前にある場合、イメージに関する詳細情報を出力します。

-version

ImageMagick のバージョン文字列を出力して終了します。

-view `string`

FlashPix 表示パラメータ。

-vignette `radius`{x`sigma`}{`+-`}`x`{`+-`}`y`{`%`}

画像のエッジをビネットスタイルで柔らかくします。

ビネット効果のロールオフは、radiusxsigma によって制御されます。名目上のロールオフの場合、これは 0xsigma に設定されます。値が 0x0 の場合、ロールオフのない円/楕円が生成されます。引数 x と y は円のサイズを制御します。値が大きいほど半径が小さくなり、値が小さいほど半径が大きくなります。値が +0+0 の場合、画像と同じサイズの円/楕円が生成されます。x と y のデフォルト値は、対応する画像寸法の 10% です。したがって、半径は 10% 減少します。つまり、円/楕円の直径は対応する画像寸法の 80% になります。ジオメトリ内のパーセント記号は x と y に影響しますが、radius と sigma は絶対値です (例: -vignette "0x2+10%+10%").

-virtual-pixel `method`

virtual pixels の内容を指定します。

このオプションは、カラールックアップでソースイメージが完全に「見つからない」場合に、どのカラーソースを使用するかを定義します。ソースイメージを囲む色。通常、この色はソースイメージから取得されますが、背景色を指定することもできます。

次の方法から選択します:

背景: 周囲の領域画像は背景色です
黒: 画像の周囲の領域は黒です
チェッカータイル: 画像と背景色の交互の正方形
ディザ: 非ランダムな 32x32 ディザパターン
エッジ: エッジピクセルを無限大に拡張します
グレー: 画像の周囲の領域はグレー
horizontal-tile: 画像を水平に並べて、背景色を上/下に表示します
horizontal-tile-edge: 画像を水平に並べて、サイドエッジのピクセルを複製します
ミラー: ミラータイルイメージ
ランダム: イメージからランダムなピクセルを選択
タイル: イメージをタイルイメージ (デフォルト)
透明: イメージの周囲の領域は透明な黒色になります
垂直タイル: イメージを垂直にタイルイメージ、側面は背景色になります
垂直タイルエッジ: 垂直にタイルイメージイメージをコピーし、サイドエッジピクセルを複製します
白: イメージの周囲の領域は白です

デフォルト値は「エッジ」です。

これは、-distort、-implode、-fx などの歪み演算子にとって最も重要です。ただし、-convolve、-blur、-sharpen など、イメージ自体のすぐ外側のピクセルにアクセスする可能性のある操作にも影響します。

仮想ピクセルタイプの完全なリストを出力するには、-list virtual-pixel オプションを使用します。

-visual `type`

この X ビジュアルタイプを使用して画像をアニメーション化します。"、'animate'、'display'

次のビジュアルクラスから選択します:

StaticGray    TrueColor
GrayScale     DirectColor
StaticColor   default
PseudoColor   visual id

X サーバーは選択したビジュアルをサポートしている必要があります。サポートされていない場合はエラーが発生します。ビジュアルが指定されていない場合は、デフォルトの画面で最も多くの色を同時に表示できるビジュアルクラスが選択されます。

-watermark `brightness`x`saturation`

指定されたパーセンテージの明るさと彩度を使用して画像にウォーターマークを付けます。

グレースケール画像 (アルファマスク付き) を取得し、ウォーターマーク画像のグレースケール値と brightness パーセンテージに従って、宛先画像の明るさを変更します。宛先の色の彩度属性は、saturation パーセンテージによって直接変更されます。デフォルトでは 100 パーセント (色の変更なし) です。

-wave `amplitude`

画像の列を正弦波に切り取ります。

-wavelet-denoise `threshold`

ウェーブレット変換を使用して画像からノイズを除去します。しきい値は、その値以下はすべてノイズとみなされる値で、範囲は 0.0 (なし) から QuantumRange またはパーセント (例: 5%) です。ソフトネスはしきい値を減衰させ、通常は 0.0 (なし、デフォルト) から 1.0 の範囲です。値が高いほど、画像に残るノイズが多くなります。

-weight `fontWeight`

テキストのフォントウェイトを設定します。

この設定は、現在選択されているフォントファミリに ImageMagick が適用しようとするフォントウェイトを示します。fontWeight には正の整数を使用するか、次から選択します。

薄い: fontWeight = 100 と同じです。
極薄: fontWeight = 200 と同じです。
薄い: fontWeight = 300 と同じです。
標準: fontWeight = 400 と同じです。
中: fontWeight = と同じです。 500。
デミボールド: fontWeight = 600 と同じです。
太字: fontWeight = 700 と同じです。
エクストラボールド: fontWeight = 800 と同じです。
ヘビー: fontWeight = 900 と同じです。

ウェイトタイプの完全なリストを出力するには、-list weight を使用します。

フォントに影響するその他の設定については、オプション -font、-family、-stretch、および -style を参照してください。

-white-balance

LAB 色空間のグレーワールド仮定に従って、画像にホワイトバランスを適用します。

使用

-white-point `x,y`

色度ホワイトポイント。

-white-threshold `value`{`%`}

しきい値を超えるすべてのピクセルを強制的にホワイトにしますが、しきい値以下のすべてのピクセルは変更しません。

しきい値は、希望する -channel 値に対応するパーセンテージまたは [0, QuantumRange] 内の絶対整数値として指定できます。しきい値と結果値の詳細については、-threshold を参照してください。

-window `id`

画像をウィンドウの背景にします。"、'animate'、'display'

id はウィンドウ ID または名前です。X のルートウィンドウをターゲットウィンドウとして選択するには、root を指定します。

デフォルトでは、画像はターゲットウィンドウの背景に並べて表示されます。backdrop または -resize が指定されている場合は、画像が背景色で囲まれます。詳細については、X RESOURCES を参照してください。

画像にターゲットウィンドウのカラーマップで許可されているよりも多くの固有の色がある場合、画像はルートウィンドウに表示されません。-colors を使用して、画像の数を減らします。色。

-window-group

ウィンドウグループを指定します。

-word-break `type`

テキストがコンテンツボックスからあふれてしまう場合に改行するかどうかを設定します。デフォルトの normal または break-word から選択します。

-write `filename`

画像シーケンスを書き込みます。

-write filename オプションに先行する画像シーケンスが書き出され、追加のオプションがある場合は、同じ画像を現在の状態で処理が続行されます。書き込み後に画像を元の状態に戻すには、+write filename オプションを使用します。

-compress を使用して、画像圧縮のタイプを指定します。

-write-mask `filename`

マスクで指定された画像ピクセルの更新を防止します。

+write-mask を使用して、画像からマスクを削除します。

同様に動作しますが、厳密なブールマスクを使用する -clip-mask も参照してください。

-adaptive-blur radius[xsigma]

-adaptive-resize geometry

-adaptive-sharpen radius[xsigma]

-adjoin

-affine sx,rx,ry,sy[,tx,ty]

-alpha type

-annotate degrees text

-antialias

-append

-attenuate value

-authenticate password

-auto-gamma

-auto-level

-auto-orient

-auto-threshold method

-average

-backdrop

-background color

-bench iterations

-bias value{%}

-bilateral-blur width{xheight}{+intensity-sigma}{+spatial-sigma}

-black-point-compensation

-black-threshold value{%}

-blend geometry

-blue-primary x,y

-blue-shift factor

-blur radius

-border geometry

-bordercolor color

-borderwidth geometry

-brightness-contrast brightness

-cache threshold

-canny radius

-caption string

-cdl filename

-channel type

-channel-fx expression

-charcoal factor

-chop geometry

-clahe widthxheight{%}{+}number-bins{+}clip-limit{!}

-clamp

-clip

-clip-mask

-clip-path id

-clone index(s)

-clut

-coalesce

-colorize value

-colormap type

-colors value

-color-matrix matrix

-colorspace value

-color-threshold start-color-stop-color

-combine

+combine colorspace

-comment string

-compare

-complex operator

-compose operator

-composite

-compress type

-connected-components connectivity

-contrast

-contrast-stretch black-point

-convolve kernel

-copy geometry offset

-crop geometry{@}{!}

-cycle amount

-debug events

-decipher filename

-deconstruct

-define key{=value}...

-delay ticks

-delete indexes

-density width

-depth value

-descend

-deskew threshold{%}

-despeckle

-adaptive-blur `radius`[x`sigma`]

-adaptive-resize `geometry`

-adaptive-sharpen `radius`[x`sigma`]

-affine `s_x`,`r_x`,`r_y`,`s_y`[,`t_x`,`t_y`]

-alpha `type`

-annotate `degrees` `text`

-attenuate `value`

-authenticate `password`

-auto-threshold `method`

-background `color`

-bench `iterations`

-bias `value`{`%`}

-bilateral-blur `width`{x`height`}{`+intensity-sigma`}{`+spatial-sigma`}

-black-threshold `value`{`%`}

-blend `geometry`

-blue-primary `x`,`y`

-blue-shift `factor`

-blur `radius`

-border `geometry`

-bordercolor `color`

-borderwidth `geometry`

-brightness-contrast `brightness`

-cache `threshold`

-canny `radius`

-caption `string`

-cdl `filename`

-channel `type`

-channel-fx `expression`

-charcoal `factor`

-chop `geometry`

-clahe `width`x`height`{%}{+}`number-bins`{+}`clip-limit`{!}

-clip-path `id`

-clone `index(s)`

-colorize `value`

-colormap `type`

-colors `value`

-color-matrix `matrix`

-colorspace `value`

-color-threshold `start-color`-`stop-color`

+combine `colorspace`

-comment `string`

-complex `operator`

-compose `operator`

-compress `type`

-connected-components `connectivity`

-contrast-stretch `black-point`

-convolve `kernel`

-copy `geometry` `offset`

-crop `geometry`{`@`}{`!`}

-cycle `amount`

-debug `events`

-decipher `filename`

-define `key`{`=value`}`...`

-delay `ticks`

-delete `indexes`

-density `width`

-depth `value`

-deskew `threshold{%}`

-direction `type`

-displace `horizontal-scale`{%}{!}

-display `host:display[.screen]`

-dispose `method`

-dissimilarity-threshold `value`

-dissolve `src_percent`[x`dst_percent`]

-distort `method arguments`

-distribute-cache `port`

-dither `method`

-draw `string`

-duplicate `count,indexes`

-edge `radius`

-emboss `radius`{x`sigma`

-encipher `filename`

-encoding `type`

-endian `type`

-evaluate `operator value`

-evaluate-sequence `operator`

-extent `geometry`

-extract `geometry`

-family `fontFamily`

-features `distance`