-defineコマンドラインオプションは、一般的にコーダーと画像処理操作を制御するために使用される特定のグローバル設定を追加します。
このオプションは、画像データの読み書き中に使用するコーダーとデコーダーの定義を1つ以上作成します。定義は、一般的に、通常の手段では提供されないものに加えて、画像ファイル形式コーダーモジュールと画像処理操作を制御するために使用されます。定義済み設定は、-verbose情報（"info:"出力形式）に「アーティファクト」としてリストされます。
定義にvalueがない場合、その名前を持つフラグの空値の定義が作成されます。これはオン/オフオプションを制御するために使用されます。以前に作成された定義を削除するには、-define keysを使用します。+define "*"を使用して、既存のすべての定義を削除します。
-set "option:key" "value"オプションを使用して、同じ「アーティファクト」設定を定義することもできます。これにより、定義された値に画像プロパティのフォーマットと印刷を使用することもできます。
optionとkeyは大文字と小文字が区別されません（デコーダー内で使用するために小文字に変換されます）が、valueは大文字と小文字が区別されます。
このような設定はグローバルなスコープを持ち、すべての画像と操作に影響を与えます。
magick bilevel.tif -define ps:imagemask eps3:stencil.ps
registry:を値の前に付けることで、イメージレジストリの属性を設定します。たとえば、作業ファイルを入れる一時パスを設定するには、次のようにします。
-define registry:temporary-path=/data/tmp
認識されている定義のリストを次に示します。
| コマンドライン定義 | |
|---|---|
| ashlar:best-fit | 左端と右端の両方のタイルを揃えます。 |
| ashlar:tiles | キャンバスごとにレンダリングする画像タイルの最大数を設定します。 |
| auto-threshold:verbose | auto-threshold:threshold画像プロパティとして導出された閾値を返します。 |
| color:illuminant | 参照光源、デフォルトはD65です。 |
| colorspace:auto-grayscale=on|off | グレースケールをサポートするコーダー内でのグレースケールへの自動変換を防ぎます。これは-type truecolorと併用する必要があります。PNGとTIFはこの定義を必要としません。PNGの場合は、PNG24:imageを使用するだけです。TIFの場合は、-type truecolorを使用するだけです。JPGとPSDはこの定義が必要です。 |
| compare:ssim-radius=value | 構造的類似性指標の半径を設定します。 |
| compare:ssim-sigma=value | 構造的類似性指標のシグマを設定します。 |
| compare:ssim-k1=value | 構造的類似性指標のk1引数を設定します。 |
| compare:ssim-k2=value | 構造的類似性指標のk2引数を設定します。 |
| complex:snr=value | -complexのSNR定数を設定します。 |
| compose:args=arguments | convert ... -compose ... -compositeを使用する場合、特定の合成引数の値を設定します。画像合成を参照してください。 |
| compose:clip-to-self=true|false | 一部の-composeメソッドは、オーバーレイ領域外の「宛先」画像を変更できます。デフォルトでは無効になっています。 |
| compose:clamp=on|off | 値が0未満のピクセルを0に設定し、値が量子範囲を超えるピクセルを量子範囲（例：65535）に設定します。それ以外の場合は、ピクセル値は変更されません。ImageMagick 6.9.1-3以降でサポートされている定義です。 |
| compose:colorspace=colorspace | colorize合成演算子の色空間を設定します。デフォルトはHCLです。 |
| compose:compose=on|off | この特別な使用方法により、アルファ合成効果が関与することなく、画像チャネルの真の数学を実行できます。 |
| connected-components:angle-threshold=value | valueより小さい同等の楕円角度を持つ領域を、周囲の領域または最大の隣接領域にマージします。Imagemagick 7.0.9.24でサポートされています。 |
| connected-components:area-threshold=value | valueより小さい面積を持つ領域を、周囲の領域または最大の隣接領域にマージします。閾値には、オプションで範囲（例：410-1600）を含めることができます。 |
| connected-components:background-id=object-id | どのオブジェクトを背景オブジェクトにするかを識別します。Imagemagick 7.0.9.21でサポートされています。 |
| connected-components:circularity-threshold=value | valueより小さい円形度を持つ領域を、周囲の領域または最大の隣接領域にマージします。円形度は、4*pi*area/perimeter^2として計算されます。Imagemagick 7.0.9.24でサポートされています。 |
| connected-components:diameter-threshold=value | valueより小さい直径を持つ領域を、周囲の領域または最大の隣接領域にマージします。直径は、sqrt(4*area/pi)として計算されます。Imagemagick 7.0.9.24でサポートされています。 |
| connected-components:eccentricity-threshold=value | 同等の楕円離心率がvalueより小さい領域を、周囲の領域または最大の隣接領域にマージします。Imagemagick 7.0.9.24でサポートされています。 |
| connected-components:exclude-header=true | ヘッダーなしでオブジェクトをリストします。Imagemagick 7.0.9.21でサポートされています。 |
| connected-components:keep=list-of-ids | 出力に保持するID値のカンマ区切りおよび/またはハイフン区切りのリスト。Imagemagick 6.9.3-0でサポートされています。 |
| connected-components:keep-colors=red;green;blue | セミコロンで区切られたリストで、色で識別されたオブジェクトを保持します。Imagemagick 6.9.3-0でサポートされています。 |
| connected-components:keep-top=number-of-objects | 面積で上位のオブジェクト数のみを保持します。Imagemagick 7.0.9.21でサポートされています。 |
| connected-components:major-axis-threshold=value | 同等の楕円長軸直径がvalueより小さい領域を、周囲の領域または最大の隣接領域にマージします。Imagemagick 7.0.9.24でサポートされています。 |
| connected-components:mean-color=true | 出力画像をID値から平均色値に変更します。Imagemagick 6.9.2-8でサポートされています。 |
| connected-components:minor-axis-threshold=value | 同等の楕円短軸直径がvalueより小さい領域を、周囲の領域または最大の隣接領域にマージします。Imagemagick 7.0.9.24でサポートされています。 |
| connected-components:perimeter-threshold=value | valueより小さい周囲長を持つ領域を、周囲の領域または最大の隣接領域にマージします。Imagemagick 7.0.9.24でサポートされています。 |
| connected-components:remove=list-of-ids | 出力から削除するID値のカンマ区切りおよび/またはハイフン区切りのリスト。Imagemagick 6.9.2-9でサポートされています。 |
| connected-components:remove-colors=red;green;blue | セミコロンで区切られたリストで、色で識別されたオブジェクトを削除します。Imagemagick 6.9.3-0でサポートされています。 |
| connected-components:verbose=true | 各領域のID、境界ボックス、中心、面積、平均色をリストします。 |
| convolve:scale={kernel_scale}[!^] [,{origin_addition}] [%] | カーネルのスケーリングを定義します。特別なフラグ!は、自動的にフルダイナミックレンジにスケールします。!フラグは、係数またはパーセントと組み合わせて使用できます。係数またはパーセントは、自動スケーリング後に適用されます。例は50%!です。これにより、フルダイナミックレンジスケーリングよりも50%暗い結果が生成されます。^フラグは、カーネルが「ゼロ和」であることを保証します。たとえば、エッジ検出カーネルのように、一部の値が正で一部の値が負の場合です。原点の追加は、カーネルの中央ピクセルにその値を追加します。これにより、フィルタリングされた画像の結果に画像をその回数だけ追加するような効果が得られます。一般的な値は1であり、元の画像が畳み込みの結果に追加されます。デフォルトは0です。 |
| deskew:auto-crop=true | 傾き補正後に画像を自動的にトリミングします。 |
| delegate:bimodal=true | PostscriptからPDFへの直接変換を指定します。 |
| distort:scale=value | -distortで使用するための出力スケーリング係数を設定します。 |
| distort:viewport=WxH+X+Y | -distortで使用するためのビューポートを設定します。 |
| dither:diffusion-amount=X% | Floyd-Steinberg拡散で使用される拡散量を設定します。 |
| exif:sync-image=false | デフォルトでは、画像の解像度はEXIFプロファイルと同期されます。この定義を使用して、EXIFプロファイルを無視します。 |
| filename:literal=true | デフォルトでは、出力ファイル名には埋め込みフォーマット文字を含めることができます。このオプションを使用して、埋め込みフォーマット文字の解釈をバイパスし、ファイル名を文字通り使用します。 |
| filter:option=value | -resizeで使用するためのフィルタオプションを設定します。具体的なオプションについては、以下を参照してください。 |
| filter:b=value | Cubic、Catrom、Mitchel、Hermiteなどのキュービックフィルタ、およびParzenキュービック窓関数で使用されるスプライン係数を再定義します。b値またはc値のいずれか1つのみが定義されている場合、もう1つの値は「Cubic-Keys」フィルタを生成するように設定されます。b値とc値の意味は、Mitchell-Netravaliの研究論文で定義されています。 |
| filter:blur=factor | フィルタ（とそのウィンドウ）のX軸をスケールします。ぼかしの場合は> 1.0、シャープの場合は< 1.0を使用します。これは、ガウスフィルタやガウスのような単純なフィルタでのみ使用する必要があります。それ以外の場合は、期待どおりの結果が得られない可能性があります。 |
| filter:c=value | Cubic、Catrom、Mitchel、Hermiteなどのキュービックフィルタ、およびParzenキュービック窓関数で使用されるKeysアルファ係数を再定義します。b値またはc値のいずれか1つのみが定義されている場合、もう1つの値は「Cubic-Keys」フィルタを生成するように設定されます。b値とc値の意味は、Mitchell-Netravaliの研究論文で定義されています。 |
| filter:kaiser-alpha=value | Kaiserウィンドウのアルファ値を設定します。「PI」を掛けると、「kaiser-beta」と等価になり、その設定を上書きします。Kaiserウィンドウ関数にのみ影響し、他の属性には影響しません。 |
| filter:kaiser-beta=value | Kaiserウィンドウのベータ値を設定します。Kaiserウィンドウ関数にのみ影響し、他の属性には影響しません。ImageMagick v6.7.6-10より前は、このオプションは「filter:alpha」（非常に古い「zoom」プログラムからの継承）として知られていました。これは、より現代的な学術研究の使用に合わせて機能を調整し、より明確に割り当てるために変更されました。デフォルト値は6.5です。 |
| filter:lobes=count | Sinc/Besselフィルタで使用されるローブ数を設定します。これは、フィルタの「サポート」範囲を指定する代替方法であり、特に画像の歪みに使用する場合、窓付きフィルタに適しているように設計されています。 |
| filter:sigma=value | ガウスフィルタを定義する際に使用される'sigma'値を設定します。デフォルトのsigma値は'0.5'です。これはガウスフィルタのみに影響し、フィルタの'サポート'を縮小することはありません（拡大する可能性はあります）。小さなサポート設定を使用することでフィルタがピクセルを'欠損'させることなく、非常に小さなぼかしを生成するために使用できます。'0.707'（'1/sqrt(2)'の値）という大きな値も、別の一般的な設定です。 |
| filter:support=radius | フィルタサポートの半径を設定します。フィルタの大きさを定義し、フィルタリングされたリサンプリングプロセスの速度を直接決定します。すべてのフィルタには、デフォルトで'推奨'されるサポートサイズがあります。ラグランジュフィルタやウィンドウ付きフィルタなどの一部のフィルタは、この値に応じて自身を調整します。単純なフィルタでは、この値は何もせず（リサンプリングを遅くするだけ）、またはフィルタ関数を悪影響を与える方法でクリップします。 |
| filter:verbose=true | 最終的な内部フィルタ選択に関する情報を標準出力に出力するように有効にします。これには、使用されているフィルタ設定に関するコメント付きヘッダーと、フィルタウェイトを簡単にグラフ化できるデータが含まれます。ただし、一部のフィルタは内部的に他のフィルタで定義されていることに注意してください。たとえば、LanczosフィルタはSincFastウィンドウ付きSincFastフィルタで定義され、Mitchellフィルタは特定の'B'と'C'設定を持つ一般的なCubicファミリフィルタとして定義されます。 |
| filter:window=filter_function | IIR（無限インパルス応答）フィルタのSincとJincは、指定されたフィルタでウィンドウ化されます（定義されたサポート範囲にわたってゼロに減少されます）。これにより、これらのIIRフィルタのウィンドウ関数として使用するフィルタ関数を指定できます。定義済みのフィルタの多くは、実際にはこれらのIIRフィルタのウィンドウ関数です。一般的な選択肢はBoxで（これは事実上ウィンドウ関数をオフにします）。 |
| filter:window-support=radius | ウィンドウ関数をこのサイズにスケールします。これにより、ウィンドウ化（または自己ウィンドウ化ラグランジュフィルタ）は、呼び出し元演算子に実際に提供されるものよりもサポートウィンドウが大きい場合のように動作します。ただし、フィルタは依然として提供される実際のサポートサイズにクリップされます。設定されていない場合、これは通常のフィルタサポートサイズと等しくなります。 |
| h:format=value | Cスタイルのヘッダーを書き込む際に使用する画像エンコーディング形式を設定します。formatには、hとmagickを除く、ImageMagickでサポートされている任意の出力形式を指定できます。このオプションを省略した場合、デフォルトはPseudoClass画像の場合はGIF、DirectClass画像の場合はPNMです。 |
| fourier:normalize=inverse | +-fftおよび+-iftで使用されるFFT/IFT正規化の場所を設定します。デフォルトはforwardです。 |
| frames:step | 画像フレームを選択する場合、デフォルトではリストを一度に1フレームずつステップします。たとえば、[0-3]はフレーム0、1、2、3を返します。この例でステップを2に設定すると、代わりにフレーム0と2が取得されます。 |
| fx:debug=true | -fx式をデバッグします。 |
| hough-lines:accumulator=true | 線画像に加えて、アキュムレータ画像も返します。 |
| json:features | 詳細情報に特徴を含めます。 |
| json:limit | |
| json:locate | |
| json:moments | 詳細情報に画像モーメントを含めます。 |
| kmeans:seed-colors=color-list | 色を初期化します。color-listは、セミコロンで区切られたシードカラーのリストです（例：red;sRGB(19,167,254);#00ffff）。 |
| magick:format=value | Cスタイルのヘッダーを書き込む際に使用する画像エンコーディング形式を設定します。これは上記で説明した「h:format=format」と同じです。 |
| magnify:method=value | ピクセルアート拡大の方法を選択します。選択肢は、eagle2X、eagle3X、eagle3XB、epb2X、fish2X、hq2X、scale2X（デフォルト）、scale3X、xbr2Xです。 |
| modulate:colorspace=colorspace | -modulateで使用するカラースペースを定義します。色相ベースのカラースペースを使用できます。デフォルトはHSLです。 |
| morphology:compose=compose-method | 複数の-morphologyカーネルによって生成された結果をマージする方法を指定します。デフォルトはなしです。一般的な値の1つは、たとえばsobelエッジカーネルで使用される'lighten'です。 |
| morphology:showKernel=1 | 生成された-morphologyカーネルに関するすべての情報を（'標準エラー'に）出力します。 |
| phash:colorspaces=colorspace,colorspace,... | 知覚ハッシュは、デフォルトでsRGBとHCLpカラースペースを使用します。この定義を使用する場合は、最大6つの代替カラースペースを指定できます。（IM 7.0.3-8以降） |
| phash:normalize=true | phashメトリックを正規化します。 |
| pixel:compliance={none|undefined|svg|mvg|x11|xpm} | -depthと組み合わせて、この定義により、パーセント、名前、8ビットコンポーネント、または16進数の値の1つまたは組み合わせで色値を表示できます。16ビット深度値は一般的にパーセントとして表示され、8ビット深度値は一般的に色の名前と8ビットコンポーネント値の組み合わせとして表示されます。 |
| png:bit-depth=value | |
| png:chunk-malloc-max=value | 最大チャンクサイズを設定します。 |
| profile:skip=name1,name2,... | 画像を読み込むときに、名前付きプロファイル[s]をスキップします。すべての名前付きプロファイルをスキップするには、skip="*"を使用します。ICC、EXIF、APP1、IPTC、XMPなど、多くの名前付きプロファイルが存在します。 |
| precision:highres-transform=true | プロファイル変換の精度を高めます。高精度変換は符号なしではなく浮動小数点であるため、わずかなパフォーマンス低下があります。結果が元の画像にプロファイルが含まれているかどうかに依存する可能性があることに注意することが重要です。 |
| preserve-timestamp=true|false | ファイルのタイムスタンプを保持します（mogrifyのみ）。 |
| q-table=quantization-table.xml | カスタムJPEG量子化テーブル。 |
| quantum:format=type | rawファイル（例：GRAY:）またはHDRIモードのMIFFおよびTIFF画像の負の値を保持するために、浮動小数点形式を指定するには、型をfloating-pointに設定します。-depth 16が含まれている場合、結果は単精度浮動小数点形式になります。-depth 32が含まれている場合、結果は倍精度浮動小数点形式になります。符号付きピクセルデータの場合は、-define quantum:format=signedを使用します。 |
| quantum:maximum=value | DCMなどの特定の画像タイプの最大値。設定されていない場合、最大値はQuantumRangeです。 |
| quantum:minimum=value | DCMなどの特定の画像タイプの最小値。設定されていない場合、最小値はゼロです。 |
| quantum:polarity=photometric-interpretation | 画像のphotometric-interpretation（通常はTIFF画像ファイル形式）をmin-is-black（デフォルト）またはmin-is-whiteのいずれかに設定します。 |
| registry:attribute=value | 画像レジストリの属性を設定します。例：registry:temporary-path=/data/tmp。 |
| registry:date:precision=length | タイムスタンプについて出力される文字の最大数を設定します。 |
| registry:option:pedantic=true | false | デフォルトでは、コマンドラインオプションがファイル名でもある場合（例：-quality）、ファイル名として解釈されます。このオプションをtrueに設定して、オプションとして解釈します。 |
| registry:precision=value | 出力される有効数字の最大数を設定します。 |
| resample:verbose=true | EWA（楕円加重平均）リサンプリングアルゴリズムによって作成された円筒フィルタのルックアップテーブルを出力します。このテーブルは、二乗半径ルックアップ値を使用することに注意してください。これは通常、EWAリサンプリングのデバッグにのみ使用されます。 |
| sample:offset=geometry | サンプリングされているサブ領域内のサンプリングポイントの位置を、パーセンテージで表します（-sampleを参照）。 |
| shepards:power=value | シェパードの歪みにおける指数を設定します。デフォルトは2です。 |
| stream:buffer-size=value | ストリームバッファサイズを設定します。非バッファリングI/Oの場合は0を選択します。 |
| trim:percent-background=X% | エッジで許容される背景の量を設定します。パーセントで指定されます。0％は背景が許容されないことを意味します。50％は、エッジにファジファクターごとに最大50％の背景ピクセルを含めることができることを意味します。 |
| trim:edges={north,east,south,west} | 指定された画像のエッジのみトリミングします。 |
| trim:minSize=geometry | トリミングを指定されたサイズに制限します。 |
| type:features=string | 複雑なテキストレイアウト中にRAQMデリゲートで使用されるフォント機能を追加します。これは通常、デフォルトでは有効になっていないオプションのフォント機能を有効にするために使用されますが、デフォルトのフォント機能を無効にするためにも使用できます。機能には、カーニング、合字、アラビア語を制御するものが含まれます。 |
| type:hinting=false | フォントヒンティングを無効にします。適切なグリフレンダリングには、ヒンティングと呼ばれる操作を通じて、スケールされた点がターゲットデバイスのピクセルグリッドに沿って配置される必要があります。その主な目的の1つは、フォント全体で重要な幅と高さを尊重することです。（たとえば、「I」と「T」のグリフの中央の垂直線が同じピクセル幅であることが非常に頻繁に望ましいです。ヒンティングは、小さなピクセルサイズで問題を引き起こす可能性のあるステムやオーバーシュートなどの機能も管理します。 |
| white-balance:vibrance=value{%} | aとbチャネルの色鮮やかさの変化。 |
| x:screen=true | ルートウィンドウから画像を取得します。 |
| x:silent=true | 画像のインポート時にビープ音をオフにします。 |
| 画像形式 | |
| bmp3:alpha=true|false | BMP画像形式で書き込むときに、アルファチャネルを含めます。 |
| bmp:format=value | 有効な値はbmp2、bmp3、およびbmp4です。このオプションは、出力ファイル名に「BMP2:」をプレフィックスする方法が不便である場合、またはmogrifyユーティリティを使用する場合など、使用できない場合に役立ちます。 |
| bmp:subtype=value | BMPチャネル深度サブタイプ。選択肢は、RGB555、RGB565、ARGB4444、ARGB1555です。BMP（BMP4）でのみサポートされます。BMP3とBMP2には、これらのオプションをサポートするヘッダーフィールドが含まれていません。 |
| {caption,label}:{max,start}-pointsize=value | テキスト注釈が画像の境界内に収まる最大ポイントサイズを検索する際に使用する境界ポイントサイズを設定します。 |
| dcm:display-range=reset | DCM画像形式の最小および最大ピクセル値に表示範囲を設定します。 |
| dcm:rescale=true | ファイル内のリスケールスロープとインターセプト設定の解釈を有効にします。 |
| dcm:rescale=true | ファイル内のリスケールスロープとインターセプト設定の解釈を有効にします。 |
| dcm:window=CxW | dcm ウィンドウの中心と幅を指定します。 |
| dds:cluster-fit=true|false | DDS クラスタフィットを有効にします。 |
| dds:compression=dxt1|dxt5|none | dds 圧縮を設定します。 |
| dds:mipmaps=値 | dds のミップマップ数を設定します。 |
| dds:weight-by-alpha=true|false | DDS アルファウェイトを有効にします。 |
| dng:max-raw-memory=値 | raw バッファサイズがこの値（メガバイト単位）を超えた場合、処理を停止します。デフォルトは 8192 です。 |
| dng:no-auto-bright=true | ヒストグラムベースのホワイトレベルを無効にします。 |
| dng:output-color=値 | 出力カラー空間を選択します。選択肢は次のとおりです。0 - Rawカラー（カメラごとに固有）、1 - sRGB D65（デフォルト）、2 - Adobe RGB（1998）D65、3 - ワイドガマットRGB D65、4 - Kodak ProPhoto RGB D65、5 - XYZ、6 - ACES |
| dng:read-thumbnail=true | 埋め込まれたサムネイルを読み込み、「dng:thumbnail」というプロファイルとして保存します。 |
| dng:use-auto-wb=true | 画像全体を平均化してホワイトバランスを計算します。 |
| dng:use-camera-wb=true | カメラで指定されたホワイトバランスを使用します。デフォルトは true です。 |
| dot:layout-engine=値 | DOT 画像形式のレイアウトエンジンを指定します（例：neato）。 |
| eps:use-cropbox=true | ImageMagick にクロップボックスを尊重させます。 |
| exr:color-type=値 | EXR形式のカラースペースを指定します。(RGB、RGBA、YC、YCA、Y、YA、R、G、B、A) |
| fpx:view=値 | ビューイング変換の仕様を含むFlashPixビューイングオブジェクトを指定します。ビューイング変換により、アプリケーションは、元の画像を変更せずにリアルタイムで画像に適用される一連の「コマンド」として、単純な編集のセットを表すことができます。 |
| ftxt:chsep=値 | 読み書き時にチャネル値を区切る単一のテキスト文字です。デフォルトは「,」（カンマ）です。 |
| ftxt:format=値 | 読み書きのフォーマット文字列です。デフォルトは「\x,\y:\c」です。エスケープ\xなどについては、[ftxt: フォーマット済みテキスト]（http://im.snibgo.com/fmttxt.htm）を参照してください。 |
| ftxt:hasalpha=値 | テキストにアルファチャネルがあるかどうか（読み取り専用）。デフォルトは false です。 |
| ftxt:nummeta=値 | メタチャネルの数（読み取り専用）。デフォルトは 0 です。 |
| heic:chroma=値 | HEICクロマパラメータを設定します。可能な値は「420」、「422」、「444」です。デフォルトは「420」です。 |
| heic:depth-image=true | コンテナに深度画像がある場合、それを抽出します。 |
| heic:preserve-orientation=true | HEICデコード中に元のEXIFの向きを保持し、それに応じてピクセルを回転させます。デフォルトでは、EXIFの向きはHEICのピクセルの実際の向きと一致するように「1」にリセットされます。 |
| heic:speed=値 | HEIC速度パラメータを設定します。0～9の整数値です。デフォルトは5です。 |
| icon:auto-resize | ico画像を書き込む際に複数のサイズを自動的に保存します（256x256ピクセルの入力画像が必要です）。 |
| jp2:layer-number=値 | デコードする最大品質レイヤー数を設定します。JPT、JC2、J2Kでも同様です。 |
| jp2:number-resolutions=値 | エンコードする解像度の数を設定します。JPT、JC2、J2Kでも同様です。 |
| jp2:progression-order=値 | LRCP、RLCP、RPCL、PCRL、またはCPRLから選択します。JPT、JC2、J2Kでも同様です。 |
| jp2:quality=値,値... | dB単位で指定された品質レイヤーPSNRを設定します。順序は左から右に昇順です。デフォルトは単一のロスレス品質レイヤーです。JPT、JC2、J2Kでも同様です。 |
| jp2:rate=値 | JPEG 2000ファイルの書き込み時に使用する圧縮係数を指定します。圧縮係数は圧縮率の逆数です。有効範囲は0.0～1.0で、1.0はロスレス圧縮を示します。定義されている場合、この値は-quality設定を上書きします。quality設定が75の場合、rate値は0.06641になります。JPT、JC2、J2Kでも同様です。 |
| jp2:reduce-factor=値 | 破棄する最高解像度レベルの数を設定します。JPT、JC2、J2Kでも同様です。 |
| jpeg:arithmetic-coding=on|off | Huffman最適化を有効/無効にします。 |
| jpeg:block-smoothing=on|off | |
| jpeg:colors=値 | 必要な色の数を設定し、JPEGエンコーダに量子化させます。 |
| jpeg:dct-method=値 | default、fastest、float、ifast、islowから選択します。 |
| jpeg:extent=値 | 最大JPEGファイルサイズを制限します。例えば-define jpeg:extent=400KBです。JPEGエンコーダは、出力ファイルがこの値を超えない最高圧縮品質レベルを検索します。バージョン6.9.2-5以降は-qualityオプションも考慮されます。6.9.1-0と6.9.2-4の間では、jpeg:extentを正しく動作させるために-quality 100を追加する必要があります。6.9.1-0より前のバージョンでは、-quality設定は無視されていました。 |
| jpeg:fancy-upsampling=on|off | |
| jpeg:optimize-coding=on|off | |
| jpeg:q-table=テーブル | |
| jpeg:sampling-factor=サンプリングファクター文字列 | |
| jpeg:size=ジオメトリ | JPEG画像のサイズヒントを設定します。例えば-define jpeg:size=128x128です。大きなJPEG画像のサイズを縮小する場合に、パフォーマンスの向上とメモリ要件の削減に最も役立ちます。 |
| jxl:effort=値 | jpeg-xlエンコーディングの労力を設定します。有効な値は3（falcon）から9（tortoise）の範囲です。 |
| mng:need-cacheoff | ストリーミングMNGの再生キャッシュをオフにします。 |
| pcl:fit-to-page=true | |
| pdf:author=著者 | ドキュメントの著者を設定します。 |
| pdf:create-epoch=秒 | ドキュメントの作成時刻を設定します。 |
| pdf:creator=作成者 | ドキュメントの作成者を設定します。 |
| pdf:fit-page=ジオメトリ | ジオメトリは、PDFの読み込み時にサイズ変更を行う際のスケーリング寸法を指定します。ジオメトリはWxH{%}またはページサイズです。オフセットは許可されません。（IM 6.8.8-8で導入） |
| pdf:fit-to-page=true | |
| pdf:hide-annotations=true | ページAnnotsキーに関連付けられた注釈を非表示にします。 |
| pdf:interpolate=true | レンダリング中に補間を有効にします。 |
| pdf:keywords=キーワード | ドキュメントのキーワードを設定します。 |
| pdf:modify-epoch=秒 | ドキュメントの変更時刻を設定します。 |
| pdf:no-identifier=true | IDエントリを生成しません。 |
| pdf:page-direction=右から左 | |
| pdf:printed=true | 注釈や画像の「画面」または「プリンタ」オプションを使用して、ファイルを画面表示するか印刷するかを決定します。 |
| pdf:producer=作成者 | ドキュメントの作成者を設定します。 |
| pdf:subject=件名 | ドキュメントの件名を設定します。 |
| pdf:stop-on-error=true | |
| pdf:thumbnail=false | PDFファイルを保存する際に画像サムネイルを生成します。 |
| pdf:title=タイトル | ドキュメントのタイトルを設定します。 |
| pdf:use-cropbox=true | |
| pdf:use-trimbox=true | |
| png:color-type=値 | PNG出力の必要なビット深度とカラースペースです。通常選択されるものとは異なるビット深度とカラースペースをPNGエンコーダに強制的に使用させることができますが、画像品質の損失がない場合のみです。画像品質を低下させる試みはエラーとして扱われ、PNGファイルは書き込まれません。例えば、1ビットの白黒画像がある場合、これらの「define」を使用して、8ビットのグレースケール、インデックス付き、または64ビットのRGBAとして書き込ませることができます。しかし、1600万色の画像がある場合、グレースケールまたはインデックス付きのPNGとして書き込ませることはできません。これを行うには、PNGエンコーダを使用する前に、適切な-depth、-colors、または-typeディレクティブを使用して画像品質を低下させる必要があります。インデックス付きPNGファイルでは、「ビット深度」はインデックスあたりのビット数を意味し、1、2、4、または8にすることができます。このようなファイルでは、カラーサンプルは常に8ビット深度です。 |
| png:compression-filter=値 | 有効な値は0～9です。0～4は対応するPNGフィルター、5はカラーマップのある画像を除く適応型フィルタリング、6はすべての画像に対する適応型フィルタリング、7はMNG「loco」圧縮、8は適応型フィルタリングによるZ_RLE戦略、9はフィルタリングなしのZ_RLE戦略です。 |
| png:compression-level=値 | 有効な値は0～9で、0は最も圧縮率が低く、速度が速く、9は通常、最も圧縮率が高く、常に速度が遅くなります。 |
| png:compression-strategy=値 | 有効な値は0～4で、デフォルト、フィルタリング済み、huffman_only、rle、および固定ZLIB圧縮戦略を意味します。Z_RLE（1.2.0以前）またはZ_FIXED（1.2.2.2以前）をサポートしていない古いzlibを使用している場合、それぞれ3と4の値は代わりにzlibのデフォルト戦略を使用します。 |
| png:format=値 | 有効な値はpng8、png24、png32、png48、png64、png00です。このプロパティは、出力ファイル名にフォーマット名を先頭に付ける通常の方法が不便な場合（PNGエンコードされたICOファイルの書き込み時やmogrifyを使用する場合など）に、使用する特定のPNGフォーマットを指定するのに役立ちます。値=png8は色の数を256に減らし、必要に応じてそのうちの1つのみを完全に透明にすることができます。他の値は品質の低下を強制しません。品質を失うことなく画像データを表すことができないフォーマットを要求することはエラーです（ただし、すべてのフォーマットでビット深度を16から8に減らすことは許可されます）。値=png24とpng48は、単一の色が完全に透明で、その色が不透明なピクセルにも表示されない場合にのみ透過性を許可します。このような透過性は、PNG tRNS チャンクに書き込まれます。値=png00により、入力画像がPNGでもあった場合、画像は入力画像からカラースペースとビット深度を継承します。 |
| png:exclude-chunk=値 | |
| png:include-chunk=値 | PNG出力から除外または含める補助チャンク。 値は、bKGDなどのPNGチャンクの種類の名前、チャンク名のカンマ区切りリスト（date、all、またはnoneという単語を含むことができます）、またはその両方です。PNGチャンク名は大文字と小文字が区別されますが、必要に応じてすべて小文字の名前を使用することもできます。 "include-chunk"リストと"exclude-chunk"リストは、PNGエンコーダの動作にのみ影響し、PNGデコーダには影響しません。 特殊なケースとして、sRGBチャンクが除外され、gAMAチャンクが含まれている場合、ガンマが1/2.2でない場合にのみgAMAチャンクが書き込まれます。これは、ほとんどのデコーダが、PNGファイルにカラー空間情報が含まれていない場合、gAMA=0.45455に対してsRGBを想定しないためです。リストは左から右に処理されるため、単一のdefineでこれを達成できます。 -define png:include-chunk=none,gAMA
特殊なケースとして、sRGBチャンクが除外されず、PNGエンコーダが画像にsRGB ICCプロファイルが含まれていることを認識した場合、PNGエンコーダは、ICCプロファイル全体ではなくsRGBチャンクを書き込みます。sRGBチャンクではなくiCCPチャンクとしてsRGBプロファイルをPNG出力に書き込ませるには、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独自のvpAg（「仮想ページ」）チャンクを含み、PNG仕様で説明されているPNGの「コピーセーフ」ステータスに関係なく、ImageMagickで認識されないすべてのPNGチャンクを除外することです。 ImageMagickで認識されないチャンク名は、「include-chunk」リストまたは「exclude-chunk」リストのいずれかに表示されていても無視されます。現在ImageMagickで認識されている補助チャンクは、bKGD、cHRM、gAMA、iCCP、oFFs、orNT、pHYs、sRGB、tEXt、tRNS、vpAg、zTXtです。 "Date:create"および"Date:modify"テキストチャンクを含めるか除外するリストにdateを追加することもできます。ImageMagickは通常、これらのチャンクを出力PNGに挿入します。 |
| 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エンコーダは、イメージ演算子ではなくPostscriptイメージマスク演算子を使用して、バイレベル画像をレンダリングする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の新機能であり、出力画像で透過性が2回適用されるのを防ぎます。このオプションは、画像を読み込む前に設定する必要があります。 |
| 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 | ピラミッドの最小ベースとレベル数を指定します（例：64x4）。 |
| svg:substitute-entities=true | ソースを信頼できる場合は、エンティティ置換を有効にします。 |
| svg:parse-huge=true | ソースを信頼できる非常に大きなSVGのレンダリングを有効にします。 |
| tga:preserve-orientation=true | 画像の向きを保持します。 |
| tga:write-footer=true | 空のオプションのフッターの書き込みを有効にします。 |
| tiff:alpha=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=カンマ区切りタグIDリスト | 1つ以上のタグID値を無視できます。 |
| tiff:predictor=[1, 2または3] | エンコーディングスキームが適用される前に、画像データに適用される数学演算子です。一般的な考え方は、画像の連続するピクセルがお互いに似ているということです。したがって、前のピクセルに既に含まれている情報からピクセル情報を減算すると、情報密度が大幅に低下し、その後の圧縮が容易になります。1 = コーディング前に予測スキームを使用しない。2 = 水平差分。3 = 浮動小数点水平差分。 |
| tiff:preserve-compression=true | ソース画像の圧縮を保持します。 |
| tiff:rows-per-strip=値 | ストリップごとの行数を設定します。 |
| tiff:tile-geometry=WxH | ピラミッドtiffのタイルサイズを設定します。出力名に接尾辞PTIF:が必要です。 |
| video:intermediate-format={pam,webp} | ffmpegのビデオ中間形式オプションを設定します。 |
| video:pixel-format=値 | ffmpegのピクセル形式オプションを設定します。 |
| video:vsync=値 | ffmpegのvsyncオプションを設定します。 |
| 疑似画像形式 | |
| caption:max-pointsize=ポイントサイズ | 最大ポイントサイズを制限します。 |
| caption:split=ブール値 | キャプションをキャンバスに収めるために必要な場合、テキストを分割します。 |
| gradient:angle=角度（度） | 線形グラデーションの場合、これは、北（上）を基準にして時計回りの正の方向に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=値 | 上下左右または対角線方向への線形グラデーションの方向を指定します。選択肢は次のとおりです。NorthWest、North、Northeast、West、East、SouthWest、South、SouthEast。Imagemagick 6.9.2-5でサポートされています。 |
| gradient:extent=値 | 画像の中心に配置された放射状グラデーションの形状を指定します。選択肢は次のとおりです。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 | ベクトル1 (x1,y1) からベクトル2 (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=ポイント | |
| pango:justify=true|false | |
| pango:language=en_US|その他 | |
| pango:markup=true|false | |
| pango:single-paragraph=true|false | |
| pango:wrap=word|char|word-char | |
| pixel:compliance=値 | いくつかの標準に従って、「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つの成分についてはパーセントになります。他の色空間の場合、値はパーセントまたは分数値として一覧表示される場合があります。深度を8に設定すると、色相ベースの色を除き、値が8ビット範囲に制限されます。 |
| txt:compliance=値 | 括弧内の値の「txt:」形式をいくつかの標準に従って設定します。選択肢はsvg、none、undefined、mvg、x11、xpmです。デフォルトでは、(s)RGB色の量子範囲の値が一覧表示されます。SVG、X11、XPM、MVG、Noneオプションでは、すべてのQレベルコンパイルで8ビット範囲の値が一覧表示されます。undefinedオプションでは、量子範囲の値も一覧表示されます。色が表示されるか、色相ベースの色空間に変換される場合、一覧表示される値は、色相については整数、他の2つの成分についてはパーセントになります。他の色空間の場合、値はパーセントまたは分数値として一覧表示される場合があります。深度を8に設定すると、色相ベースの色を除き、値が8ビット範囲に制限されます。 |
| webp:タグ=値 | WebPには、このページで詳しく説明されている多数の定義があります。 |
| xmp:validate={true,false} | デフォルトでは、ImageMagickは画像に埋め込まれたXMPプロファイルを検証します。 |
| 識別定義 | |
| identify:locate=minimum|maximum | 1つ以上の画像の最小値または最大値の座標を特定します。 |
| identify:limit=数 | 指定された数の最小値または最大値の座標を特定します。 |