命令宏 command-macros

命令宏为命令集提供命名快捷键。 宏在单独的宏定义文件中定义，这些文件可以附加到图像目录或默认目录。

$ *名称*$

*name*不区分大小写，并且可以由ASCII字母、数字、“ — ”、“_”和“。”的任意组合组成 个字符。

宏可以在“？”之后的请求中任何位置调用，也可以在catalog::Modifier或catalog::PostModifier字段中的任何位置调用。 宏只能表示一个或多个完整的图像提供命令，并且必须使用&分隔符与其他命令分开。

在解析过程中，宏调用在早期被替换字符串替换。 如果宏中的命令发生在请求中的宏调用之前，则宏中的命令会覆盖请求中的相同命令。 此处理流程不同于catalog::Modifier，其中请求字符串中的命令始终会覆盖catalog::Modifier字符串中的命令，无论请求中的位置如何。

命令宏不能有参数值，但自定义变量可用于将请求中的值传递到宏中。

宏可以嵌套。 但是，只有在宏定义被解析时已定义时，才能调用该宏。 此工作流程可通过以下方法完成：先在同一宏定义文件中显示，或将此类嵌入宏的定义置于默认宏定义文件中。

示例 section-2f73d36ac8d64254a03bae5afeae2fb9

如果将相同的属性应用到不同的图像，则宏会很有用。

http://server/cat/1345?wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1 http://server/cat/1435?wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1 http://server/cat/8243?wid=480&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1

您可以为公共属性定义宏：

view wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1

宏的使用方式如下：

http://server/cat/1345?$view$ http://server/cat/1435?$view$ http://server/cat/8243?$view$&wid=480

由于第三个请求的wid=不同，您只需在​ 之后覆盖值 ​即可调用宏（在​ $view$之前指定wid= ​无效）。

另请参阅 section-8cdba0ed2480444ca61e719e54f8871c

目录：：MacroFile ，目录：：Modifier，宏定义引用