Befehlsmakros

Letzte Aktualisierung: 2023-09-01
  • Erstellt für:
  • Developer
    User

Befehlsmakros bieten spezifische Tastaturbefehle für Befehlssätze. Makros werden in separaten Makro-Definitionsdateien definiert, die an Bildkataloge oder den Standardkatalog angehängt werden können.

$ *name*$

name

Makroname.

*name* nicht zwischen Groß- und Kleinschreibung unterscheiden und aus einer beliebigen Kombination von ASCII-Buchstaben, Zahlen , '-', '_' und '.' bestehen können Zeichen.

Makros können an einer beliebigen Stelle in einer Anfrage nach dem "?"und an einer beliebigen Stelle in einer catalog::Modifier oder catalog::PostModifier -Feld. Makros können nur einen oder mehrere vollständige Image Serving-Befehle darstellen und müssen mit & Trennzeichen.

Makroaufrufe werden während des Parsens durch ihre Ersatzzeichenfolgen ersetzt. Befehle in Makros überschreiben dieselben Befehle in der Anfrage, wenn sie vor dem Makroaufruf in der Anfrage auftreten. Dieser Verarbeitungsfluss unterscheidet sich von catalog::Modifier, wobei Befehle in der Anfragezeichenfolge Befehle in der catalog::Modifier Zeichenfolge, unabhängig von der Position in der Anforderung.

Befehlsmakros können keine Argumentwerte haben, aber benutzerdefinierte Variablen können verwendet werden, um Werte aus der Anfrage an das Makro zu übergeben.

Makros können verschachtelt sein. Ein Makro kann jedoch nur aufgerufen werden, wenn es zum Zeitpunkt der Analyse der Makrodefinition bereits definiert ist. Dieser Workflow erfolgt entweder durch frühere Darstellung in derselben Makrodefinitionsdatei oder durch Platzieren der Definition für ein solches eingebettetes Makro in der Standard-Makrodefinitionsdatei.

Beispiel

Makros können nützlich sein, wenn dieselben Attribute auf verschiedene Bilder angewendet werden sollen.

http://server/cat/1345?wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1 http://server/cat/1435?wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1 http://server/cat/8243?wid=480&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1

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

view wid=240&fmt=jpeg&qlt=85&op_usm=5,2&bgc=200,200,200&align=-1,-1

Das Makro würde wie folgt verwendet:

http://server/cat/1345?$view$ http://server/cat/1435?$view$ http://server/cat/8243?$view$&wid=480

weil wid= unterscheidet sich bei der dritten Anforderung, können Sie den Wert einfach überschreiben. after das Makro aufgerufen wird (Angabe von wid=before $view$ keine Wirkung hat).

Verwandte Themen

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

Auf dieser Seite