Show Menu
TOPICS×

Command macros *

Command macros provide named shortcuts for sets of commands.
$ *[name]*$
** name ** Macro name
Macros are defined in separate macro definition files, which can be attached to material catalogs or the default catalog.
name is not case-sensitive and can consist of any combination of ASCII letters, numbers , '-', '_', and '.' characters.
Invoke macros anywhere in a request after the '?', or anywhere within a vignette::Modifier field. Macros can only represent one or more complete Image Rendering commands and must be separated from other commands with '&' separators.
Macro invocations are replaced by their substitution strings early during parsing. Commands within macros override the same commands in the request if they occur before the macro invocation in the request. This is different from vignette::Modifier , where commands in the request string will always override commands in the vignette::Modifier string, regardless of the position in the request.
Command macros cannot have argument values, but custom variables may be used to pass values from the request into the macro.
Macros may not be nested.
Example
Macros can be useful if the same commands or attributes are to be applied to different rendered images.
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
You can define a macro for the common attributes:
render vignette=cat/$vig$&fmt=jpg&qlt=80&sharpen=1&src=cat/$mat$&res=40
The macro would be used as follows:
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
Since qlt= is different for the third request, we simply override the value after the macro is invoked (specifying qlt= before $render$ would not have any effect).
See also
catalog::MacroFile , catalog::Modifier , Macro Definition Reference