Opdrachtmacro's command-macros

De macro's van het bevel verstrekken genoemde kortere weg voor reeksen bevelen.

$ *name*$

​ name ​ Macronaam

Macro's worden gedefinieerd in afzonderlijke macrodefinitiebestanden, die kunnen worden gekoppeld aan materiaalcatalogi of de standaardcatalogus.

name is niet hoofdlettergevoelig en kan bestaan uit elke combinatie van ASCII-letters, -cijfers , '-', '_' en '.' tekens.

Macro's overal in een verzoek aanroepen na '?' of ergens in een vignette::Modifier veld. Macro's kunnen slechts een of meer opdrachten voor het renderen van afbeeldingen vertegenwoordigen en moeten worden gescheiden van andere opdrachten met scheidingstekens '&'.

Macro-aanroepen worden tijdens het parseren vervangen door hun vervangende tekenreeksen. Opdrachten binnen macro's overschrijven dezelfde opdrachten in de aanvraag als deze vóór de macroactivering in de aanvraag worden uitgevoerd. Deze workflow verschilt van vignette::Modifier, waarbij opdrachten in de tekenreeks request de opdrachten in de vignette::Modifier tekenreeks, ongeacht de positie in de aanvraag.

Opdrachtmacro's kunnen geen argumentwaarden hebben, maar aangepaste variabelen kunnen worden gebruikt om waarden van de aanvraag in de macro door te geven.

Macro's mogen niet genest zijn.

Voorbeeld

Macro's kunnen handig zijn als dezelfde opdrachten of kenmerken moeten worden toegepast op verschillende gerenderde afbeeldingen.

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

U kunt een macro definiëren voor de algemene kenmerken:

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

De macro wordt als volgt gebruikt:

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

Omdat qlt= is verschillend voor het derde verzoek, treedt de software de waarde met voeten nadat de macro wordt aangehaald (specificerend qlt= voor $render$is niet effectief).

Zie ook

catalog::MacroFile, catalog::Modifier, Macrodefinitieverwijzing