命令宏 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::MacroFile， catalog::Modifier，宏定义引用