コマンドマクロ command-macros

コマンドマクロは、一連のコマンドに名前付きショートカットを提供します。 マクロは個別のマクロ定義ファイルで定義され、画像カタログまたはデフォルトカタログに添付できます。

$ *name*$

*name*は大文字と小文字を区別せず、ASCII文字、数字、「 – 」、「_」、「。」の組み合わせで構成される可能性があります。

マクロは、「?」の後のリクエスト内の任意の場所、およびcatalog::Modifierまたはcatalog::PostModifier フィールド内の任意の場所で呼び出すことができます。 マクロは、1つ以上の完全な画像サービングコマンドのみを表します。また、&個の区切り記号を含む他のコマンドから区切る必要があります。

マクロ呼び出しは、パースの早い段階で代用文字列に置き換えられます。 マクロ内のコマンドは、リクエスト内のマクロ呼び出しの前に発生した場合、リクエスト内の同じコマンドを上書きします。 この処理フローはcatalog::Modifierとは異なります。リクエスト文字列内のコマンドは、リクエスト内の位置に関係なく、catalog::Modifier文字列内のコマンドを常に上書きします。

コマンドマクロには引数の値を指定できませんが、カスタム変数を使用して、リクエストの値をマクロに渡すことができます。

マクロはネストできます。 ただし、マクロは、マクロ定義の解析時に既に定義されている場合にのみ呼び出すことができます。 このワークフローは、同じマクロ定義ファイル内で以前に表示するか、そのような埋め込みマクロの定義をデフォルトのマクロ定義ファイルに配置することによって実行されます。

例 section-2f73d36ac8d64254a03bae5afeae2fb9

マクロは、同じ属性を異なる画像に適用する場合に便利です。

http://server/cat/1345?wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1 http://server/cat/1435?wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1 http://server/cat/8243?wid=480&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1

共通の属性のマクロを定義できます。

view wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1

マクロは次のように使用されます。

http://server/cat/1345?$view$ http://server/cat/1435?$view$ http://server/cat/8243?$view$&wid=480

wid=は3番目のリクエストとは異なるため、マクロが呼び出された​ 後 ​の値を単純に上書きできます（wid=前 $view$を指定しても効果はありません）。

関連項目 section-8cdba0ed2480444ca61e719e54f8871c

​ カタログ：:MacroFile、​ カタログ：:Modifier、​ マクロ定義参照