命令宏*

命令宏為命令集提供命名快捷方式。

$ *[!DNL name]*$

name 宏名稱

宏定義在單獨的宏定義檔案中，這些宏可附加到材料目錄或預設目錄。

name 不區分大小寫，且可包含任何ASCII字母、數字、'-'、'_'和'.'的組合字元.

在'?'後，或在vignette::Modifier欄位中的任何位置，在請求中叫用巨集。 宏只能表示一個或多個完整的影像渲染命令，並且必須與具有「&」分隔符的其它命令分開。

宏調用在解析期間早被其替代字串替換。 如果宏中的命令在請求中調用宏之前發生，則會覆蓋請求中的相同命令。 這與vignette::Modifier不同，在中，請求字串中的命令一律會覆寫vignette::Modifier字串中的命令，而不論請求中的位置。

命令宏不能有參數值，但可使用自定義變數將值從請求傳遞到宏。

宏可能不嵌套。

範例

如果要將相同的命令或屬性應用於不同的渲染影像，宏就很有用。

http://server/ir/render/cat/vig0?fmt=jpeg&qlt=80&sharpen=1&src=cat/matA&res=40 http://server/ir/render/cat/vig1?fmt=jpeg&qlt=80&sharpen=1&src=cat/matB&res=40 http://server/ir/render/cat/vig2?fmt=jpeg&qlt=95&sharpen=1&src=cat/matC&res=40

可以為公共屬性定義宏：

render vignette=cat/$vig$&fmt=jpg&qlt=80&sharpen=1&src=cat/$mat$&res=40

宏的用法如下：

http://server/ir/render/cat/vig0?$mat=matc&$render$ http://server/ir/render/cat/vig0?$mat=matc&$render$ http://server/ir/render/cat/vig0?$mat=matc&$render$&qlt=95

由於qlt=與第三個請求不同，因此我們只會在呼叫巨集後覆寫值（在​$render$之前指定qlt=​將不會產生任何效果）。

另請參閱

catalog::MacroFile、 catalog::Modifier，宏定義參考