命令巨集 command-macros

指令巨集為指令集提供命名的捷徑。

$ *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,巨集定義參考

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49