Macros de comando command-macros

As macros de comando fornecem atalhos nomeados para conjuntos de comandos.

$ *name*$

​ name ​ Nome da macro

As macros são definidas em arquivos de definição de macro separados, que podem ser anexados a catálogos de materiais ou ao catálogo padrão.

name não diferencia maiúsculas de minúsculas e pode consistir em qualquer combinação de letras ASCII, números , '-', '_' e '.' caracteres.

Chame macros em qualquer lugar em uma solicitação depois do '?', ou em qualquer lugar dentro de um campo vignette::Modifier. As macros só podem representar um ou mais comandos de Renderização de imagem e devem ser separadas de outros comandos com separadores '&'.

As invocações de macro são substituídas por suas cadeias de caracteres de substituição no início da análise. Os comandos nas macros substituem os mesmos comandos na solicitação se ocorrerem antes da invocação da macro na solicitação. Este fluxo de trabalho é diferente de vignette::Modifier, no qual os comandos da cadeia de caracteres de solicitação substituem os comandos da cadeia de caracteres vignette::Modifier, independentemente da posição na solicitação.

Macros de comandos não podem ter valores de argumento, mas variáveis personalizadas podem ser usadas para transmitir valores da solicitação para a macro.

As macros não podem ser aninhadas.

Exemplo

As macros podem ser úteis se os mesmos comandos ou atributos forem aplicados a diferentes imagens renderizadas.

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

Você pode definir uma macro para os atributos comuns:

render vignette=cat/$vig$&fmt=jpg&qlt=80&sharpen=1&src=cat/$mat$&res=40

A macro seria usada da seguinte maneira:

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

Como qlt= é diferente para a terceira solicitação, o software substitui o valor após a macro ser invocada (especificando qlt= antes $render$é ineficaz).

Consulte também

catalog::MacroFile, catalog::Modifier, Referência de Definição de Macro