命令宏 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=不同，在调用宏后，软件将覆盖该值（在​ $render$之前指定qlt= ​无效）。

另请参阅

catalog::MacroFile，catalog::Modifier，宏定义引用