Command macros 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 een willekeurige combinatie van ASCII-letters, -getallen, '-', '_' en '.' tekens.

U kunt macro's overal in een aanvraag aanroepen na '?' of ergens in een veld vignette::Modifier . 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 , waar opdrachten in de tekenreeks request de opdrachten in de tekenreeks vignette::Modifier overschrijven, 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= voor het derde verzoek verschillend is, treedt de software de waarde met voeten nadat de macro wordt aangehaald (specificerend qlt= alvorens $render$ inefficiënt is).

zie ook

catalog::MacroFile, catalog::Modifier, macrodefinitieverwijzing