-define コマンドラインオプションは、主にコーダーや画像処理操作を制御するための特定のグローバル設定を追加します。

このオプションは、画像データの読み書き時にコーダー／デコーダーが使用する 1 つ以上の定義を作成します。定義は一般に、画像ファイル形式のコーダーモジュールや画像処理操作を、通常の手段で提供される以上に制御するために使用されます。定義された設定は -verbose 情報（"info:" 出力形式）に「Artifacts」として一覧表示されます。

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

同じ「アーティファクト」設定は -set "option:key" "value" オプションでも定義でき、こちらでは定義値の中で 書式設定と画像プロパティの出力 を使用できます。

オプションとキーは大文字小文字を区別しません（デコーダー内部での使用のため小文字に変換されます）が、値は大文字小文字を区別します。

これらの設定はスコープがグローバルで、すべての画像と操作に影響します。

magick bilevel.tif -define ps:imagemask eps3:stencil.ps
magick arrow.tga -set colorspace:auto-grayscale=off myArrow.tga

値に registry: を前置すると、画像レジストリの属性を設定できます。たとえば、作業ファイルを置く一時パスを設定するには次のようにします。

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

認識される define の一覧を以下に示します。

コマンドライン定義

IMAGE FORMATS

-define png:include-chunk=none,gAMA

特殊なケースとして、sRGB チャンクが除外されておらず、PNG エンコーダーが画像に sRGB ICC プロファイルが含まれることを認識した場合、PNG エンコーダーは ICC プロファイル全体の代わりに sRGB チャンクを書き込む。PNG エンコーダーに sRGB チャンクの代わりに sRGB プロファイルを出力 PNG の iCCP チャンクとして書き込ませるには、sRGB チャンクを除外する。重要な PNG チャンク IHDR・PLTE・IDAT・IEND は除外できない。リストに現れたそのようなエントリは無視される。補助 PNG tRNS チャンクが除外され画像に透明がある場合、PNG の色タイプは 4 または 6（GRAY_ALPHA または RGBA）に強制される。画像が透明でない場合、tRNS チャンクはそもそも書き込まれず、出力画像の PNG 色タイプには影響しない。-strip オプションは PNG 出力に対して次と同等のことを行う:

-define png:exclude-chunk=EXIF,iCCP,iTXt,sRGB,tEXt,zCCP,zTXt,date

デフォルトの動作は、既知のすべての PNG 補助チャンクに加えて ImageMagick の private vpAg（「仮想ページ」）チャンクを含め、PNG 仕様で説明される PNG の "copy-safe" 状態に関わらず、ImageMagick が知らないすべての PNG チャンクを除外する。ImageMagick が知らないチャンク名は、"include-chunk" または "exclude-chunk" リストに現れても無視される。現在 ImageMagick が知っている補助チャンクは bKGD・cHRM・gAMA・iCCP・oFFs・orNT・pHYs・sRGB・tEXt・tRNS・vpAg・zTXt。リストに date を入れて、ImageMagick が通常出力 PNG に挿入する "Date:create" と "Date:modify" テキストチャンクを含める／除外することもできる。 png:ignore-crc[=true] | 画像に CRC や ADLER32 エラーがないと分かっている場合、これでデコードを高速化できる。"ファザー" からのバグ報告のデバッグにも役立つ。 png:preserve-colormap[=true] | 既存の image->colormap を使う。通常 PNG エンコーダーはパレットを最適化し、未使用エントリを除去して透明色を先頭に置こうとする。このフラグが設定されると、その動作は抑制される。 png:preserve-iCCP[=true] | デフォルトでは、PNG デコーダーとエンコーダーは、PNG 入力の iCCP チャンクまたはオプションで供給された ICC プロファイルを調べ、それが sRGB プロファイルと認識されれば sRGB チャンクへ変換する。-define png:preserve-iCCP を使うとこれを防げる。その場合 iCCP チャンクが読み書きされ、sRGB チャンクは書き込まれない。sRGB を称しながら各種エラーがあり libpng16 に拒否される ICC プロファイルもある。そのようなプロファイルもとにかく認識されて sRGB チャンクに変換されるが、-define png:preserve-iCCP がある場合は拒否される。なお、すべての "sRGB" ICC プロファイルがまだ認識されているわけではなく、遭遇するたびにリストへ追加していく。 png:swap-bytes[=true] | PNG 仕様は、複数バイト整数をネットワークバイト順（MSB-LSB エンディアン）で格納するよう求める。このオプションで、16 ビットサンプルがリトルエンディアン順（LSB-MSB）で誤って格納された不正な PNG ファイルを修正できる。"-define png:swap-bytes" オプションはコマンドラインで入力ファイル名の前に置く必要がある。スワップは libpng のデコード処理中に行われる。 ps:imagemask | ps:imagemask フラグが定義されると、PS3 と EPS3 コーダーは、image 演算子ではなく Postscript imagemask 演算子で二値画像をレンダリングする Postscript ファイルを作成する。 psd:additional-info=all|selective | このオプションは PSD ファイルから別の PSD ファイルへ変換する場合にのみ使うべき。画像読み込み後に置くこと。2 つのオプションは 'all' と 'selective'。'selective' は画像のジオメトリに関係しない追加情報をすべて保持する。'all' は画像のジオメトリが変更されていない場合にのみ使うべき。入力 PSD から出力 PSD へ調整レイヤーなどの単純でないレイヤーを転送する際に役立つ。このオプションを使わないと追加情報は保持されない。この define は Imagemagick 6.9.5-8 以降で利用可能。 psd:alpha-unblend=off | フラット化されたレイヤー 0 について、出力画像にアルファチャンネルを追加する前に、ベース画像との透明の新しい自動アンブレンドを無効にする。この define は入力 psd 画像の前に置く必要がある。（IM 6.9.2.5 以降で利用可能）。自動アンブレンドは IM 6.9.2.5 で新規追加され、出力画像で透明が二重に適用されるのを防ぐ。このオプションは画像読み込み前に設定すべき。 psd:preserve-opacity-mask=true | このオプションは PSD ファイルから別の PSD ファイルへ変換する場合にのみ使うべき。レイヤーの不透明マスクを保持し、画像保存時にレイヤーへ戻して追加する。'true' に設定するとこの機能が有効になる。この define は Imagemagick 6.9.5-10 以降で利用可能。 psd:write-layers=false | PSD ファイルのレイヤーの書き出しを無効にするのに使える。 psd:replicate-profile=true | 返される最初の画像だけでなく、すべての画像へ画像プロファイルをコピーするのに使える。 ptif:pyramid=min-basexlevels | ピラミッドの min-base とレベル数を指定する。例: 64x4。 svg:parse-huge=true | ソースを信頼できる非常に大きな SVG のレンダリングを有効にする。 svg:substitute-entities=true | ソースを信頼できる場合にエンティティ置換を有効にする。 tga:preserve-orientation=true | 画像の向きを保持する。 tga:write-footer=true | 空のオプションフッターの書き出しを有効にする。 tiff:alpha=associated|unassociated|unspecified | アルファの追加サンプルを associated・unassociated・unspecified として指定する。 tiff:assume-alpha=true|false | 宣言されていない追加チャンネルをアルファとみなす。 tiff:endian=msb|lsb | tiff:exif-properties=false | EXIF プロパティの読み込みを無効にする。 tiff:fill-order=msb|lsb | tiff:peg-tables-mode=0-3 | tiff ファイルを jpeg 圧縮で書き出す際の TIFFTAG_JPEGTABLESMODE を設定する。 tiff:gps-properties=false | GPS プロパティの読み込みを無効にする。 tiff:ignore-layers=true | Photoshop のレイヤーを無視する。 tiff:ignore-tags=comma-separate-list-of-tag-IDs | 1 つ以上のタグ ID 値を無視できるようにする。 tiff:predictor=[1, 2 or 3] | エンコード方式を適用する前に画像データへ適用する数学的演算子。後続の画素が互いに似ているという一般的な発想に基づく。したがって、すでに直前の画素に含まれる情報を画素から差し引くと、その情報密度がかなり減り、後続の圧縮に役立つ可能性が高い。1 = コーディング前に予測スキームを使わない。2 = 水平差分。3 = 浮動小数点水平差分。 tiff:preserve-compression=true | ソース画像の圧縮を保持する。 tiff:rows-per-strip=value | ストリップあたりの行数を設定する。 tiff:tile-geometry=WxH | ピラミッド tiff のタイルサイズを設定する。出力名の前にサフィックス PTIF: が必要。 uhdr:gainmap-gamma=value | ゲインマップ画像のエンコードガンマを設定する。0.0 より大きくなければならない。エンコード時に使用。任意。デフォルト値は 1.0。 uhdr:gainmap-quality=value | ゲインマップ画像のエンコード品質係数を設定する。有効範囲は 1〜100 で、1 は最低画質または最高圧縮、100 は最高画質または最低圧縮を示す。エンコード時に使用。任意。デフォルト値は 95。 uhdr:gainmap-max-content-boost=value | ある画素において、対象 HDR レンディションの線形輝度の、SDR 画像に対する（で割った）許容最大比を指定する。言い換えると、SDR レンディションに対し、HDR ディスプレイで表示したときに画素がどれだけ明るくなれるかを指定する。0.0 より大きくなければならない。エンコード時に使用。任意。設定されない場合、入力に基づいて動的に計算される。 uhdr:gainmap-min-content-boost=value | ある画素において、対象 HDR レンディションの線形輝度の、SDR 画像に対する（で割った）許容最小比を指定する。言い換えると、SDR レンディションに対し、HDR ディスプレイで表示したときに画素がどれだけ暗くなれるかを指定する。0.0 より大きくなければならない。エンコード時に使用。任意。設定されない場合、入力に基づいて動的に計算される。 uhdr:hdr-color-gamut={bt709|display_p3|bt2100} | 入力 HDR インテントの色域を設定する。エンコード時に使用。必須。 uhdr:hdr-color-transfer={hlg|pq|linear} | 入力 HDR インテントの色伝達を設定する。エンコード時に使用。必須。 uhdr:output-color-transfer={hlg|pq|linear|srgb} | ultrahdr 画像がレンダリングされる対象ディスプレイの伝達特性を設定する。デコード時に使用。必須。srgb の場合、sdr インテントのみがデコードされ出力される。そうでなければ sdr インテントとゲインマップがデコードされ、hdr 画像に合成されて出力される。 uhdr:sdr-color-gamut={bt709|display_p3|bt2100} | 入力 SDR インテントの色域を設定する。エンコード時に使用。必須。 uhdr:uhdr:target-display-peak-brightness=value | ピーク輝度はディスプレイが達成できる最大輝度レベルを指す。HDR コンテンツの明るいハイライトを正確に表現するために重要。 video:intermediate-format={pam,webp} | ffmpeg の動画中間形式オプションを設定する。 video:pixel-format=value | ffmpeg の画素形式オプションを設定する。 video:vsync=value | ffmpeg の vsync オプションを設定する。 PSEUDO-IMAGE FORMATS caption:max-pointsize=pointsize | 最大ポイントサイズを制限する。 caption:split=boolean | キャプションをキャンバスに収めるために必要ならテキストを分割する。 gradient:angle=angle (in degrees) | 線形グラデーションでは、北（上）を基準に時計回りを正として color1 から color2 へ向かう方向を指定する。放射状グラデーションでは、通常の X-Y 方向から時計回りを正としたグラデーションの回転を指定する。Imagemagick 6.9.2-5 でサポート。 gradient:bounding-box=WxH+X+Y | グラデーションを画像寸法より大きい、または小さい領域に制限する。境界ボックスで定義された領域が画像より小さい場合、color1 が背景色になる。Imagemagick 6.9.2-5 でサポート。 gradient:center=x,y | 放射状グラデーションの中心点の座標を指定する。デフォルトは画像の中心。Imagemagick 6.9.2-5 でサポート。 gradient:direction=value | 線形グラデーションの方向を、上／下／左／右または対角の隅へ向けて指定する。選択肢: NorthWest、North、Northeast、West、East、SouthWest、South、SouthEast。Imagemagick 6.9.2-5 でサポート。 gradient:extent=value | 画像中心の放射状グラデーションの形状を指定する。選択肢: Circle、Diagonal、Ellipse、Maximum、Minimum。Circle と Maximum は、長方形の画像でも、画像の半幅と半高の大きい方に等しい半径の円形放射状グラデーションを描く。Circle と Maximum はどちらもデフォルトの放射状グラデーションと等価。Minimum は、長方形の画像でも、半幅と半高の小さい方に等しい半径の円形放射状グラデーションを描く。Diagonal は、長方形の画像でも、画像の半対角に等しい半径の円形放射状グラデーションを描く。Ellipse は、長方形の画像に対し、画像の半幅と半高に等しい半径の楕円形放射状グラデーションを描く。Imagemagick 6.9.2-5 でサポート。 gradient:radii=x,y | グラデーションの x・y 半径を指定する。x 半径と y 半径が等しければ放射状グラデーションの形状は円になる。異なれば楕円になる。デフォルト値は画像の半幅と半高の最大値。Imagemagick 6.9.2-5 でサポート。 gradient:vector=x1,y1,x2,y2 | vector1 (x1,y1) から vector2 (x2,y2) へ向かう線形グラデーションの方向を指定する。Color1（fromColor）はベクトル位置 x1,y1 に、color2（toColor）はベクトル位置 x2,y2 に配置される。Imagemagick 6.9.2-5 でサポート。 histogram:unique-colors=false | 画像の一意な色のテキスト一覧表示を抑制する。 pango:align=left|center|right | pango:auto-dir=true|false | pango:ellipsize=start|middle|end | pango:gravity-hint=natural|strong|line | pango:hinting=none|auto|full | pango:indent=points | pango:justify=true|false | pango:language=en_US|others | pango:markup=true|false | pango:single-paragraph=true|false | pango:wrap=word|char|word-char | pixel:compliance=value | "pixel:" 出力形式をいくつかの規格に従って設定する。選択肢は SVG・None・Undefined・MVG・X11・XPM。デフォルトでは (s)rgb(r,g,b) または (s)rgba(r,g,b,a) の形式で (s)RGB 色の値を一覧する。色名はもはや提示されない。sRGB または RGB 色について、SVG・X11・XPM・None オプションは色名が存在すれば一覧する。MVG と Undefined オプションは 16 進値を一覧する。色相ベースのカラースペースで提示・変換される場合、色相は整数、他の 2 成分はパーセントで一覧される。他のカラースペースでは、値はパーセントまたは分数値で一覧される。depth を 8 に設定すると、色相ベースの色を除き値が 8 ビット範囲に制限される。 txt:compliance=value | 括弧内の値の "txt:" 形式をいくつかの規格に従って設定する。選択肢は svg・none・undefined・mvg・x11・xpm。デフォルトでは (s)RGB 色の値を量子化レンジで一覧する。SVG・X11・XPM・MVG・None オプションはすべての Q レベルコンパイルで 8 ビット範囲の値を一覧する。undefined オプションも量子化レンジで値を一覧する。色相ベースのカラースペースで提示・変換される場合、色相は整数、他の 2 成分はパーセントで一覧される。他のカラースペースでは、値はパーセントまたは分数値で一覧される。depth を 8 に設定すると、色相ベースの色を除き値が 8 ビット範囲に制限される。 webp:tag=value | WebP には多数の define があり、この ページ で詳説されている。 xmp:validate={true,false} | デフォルトでは、ImageMagick は画像に埋め込まれた XMP プロファイルを検証する。