命令宏

命令宏提供一組命令的命名快捷方式。

$ *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= 對於第三個請求不同,在調用宏後軟體將覆蓋值(指定 qlt= $render$無效)。

另請參閱

catalog::MacroFilecatalog::Modifier,宏定義引用

本頁內容