Befehlsmakros command-macros

Befehlsmakros bieten benannte Tastaturbefehle für Befehlssätze.

$ *name*$

​ name ​ Makronamen

Makros werden in separaten Makrodefinitionsdateien definiert, die an Materialkataloge oder den Standardkatalog angehängt werden können.

name wird nicht zwischen Groß- und Kleinschreibung unterschieden und kann aus einer beliebigen Kombination von ASCII-Buchstaben, Zahlen , '-', '_' und '.' bestehen. Zeichen.

Makros an einer beliebigen Stelle in einer Anfrage nach dem "?“ oder an einer beliebigen Stelle in einem vignette::Modifier Feld aufrufen. Makros können nur einen oder mehrere Image-Rendering-Befehle darstellen und müssen von anderen Befehlen mit "&"-Trennzeichen getrennt werden.

Makroaufrufe werden durch ihre Ersatzzeichenfolgen frühzeitig während der Analyse ersetzt. Befehle in Makros überschreiben dieselben Befehle in der Anfrage, wenn sie vor dem Makroaufruf in der Anfrage auftreten. Dieser Workflow unterscheidet sich von vignette::Modifier, bei dem Befehle in der Anfragezeichenfolge Befehle in der vignette::Modifier-Zeichenfolge überschreiben, unabhängig von der Position in der Anfrage.

Befehlsmakros dürfen keine Argumentwerte enthalten, jedoch können benutzerdefinierte Variablen verwendet werden, um Werte aus der Anforderung an das Makro zu übergeben.

Makros dürfen nicht verschachtelt sein.

Beispiel

Makros können hilfreich sein, wenn dieselben Befehle oder Attribute auf verschiedene gerenderte Bilder angewendet werden sollen.

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

Sie können ein Makro für die allgemeinen Attribute definieren:

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

Das Makro würde wie folgt verwendet:

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

Da qlt= für die dritte Anfrage unterschiedlich ist, überschreibt die Software den Wert, nachdem das Makro aufgerufen wurde (die Angabe von qlt= before $render$ ist ineffektiv).

Siehe auch

catalog::MacroFile, catalog::Modifier, Referenz zur Makrodefinition