macros de commande

Les macros de commande fournissent des raccourcis nommés pour les jeux de commandes. Les macros sont définies dans des fichiers de définition de macro distincts, qui peuvent être joints aux catalogues d’images ou au catalogue par défaut.

$ *name*$

name

Nom de la macro.

*Le * nom n'est pas sensible à la casse et peut consister en toute combinaison de lettres ASCII, de chiffres, de '-', '_' et '.' caractères.

Les macros peuvent être invoquées n’importe où dans une requête après "?", ainsi que n’importe où dans un champ catalog::Modifier ou catalog::PostModifier. Les macros ne peuvent représenter qu’une ou plusieurs commandes de traitement d’images complètes et doivent être séparées des autres commandes avec des séparateurs "&".

Les appels de macros sont remplacés par leurs chaînes de substitution au début de l’analyse. Les commandes des macros remplacent les mêmes commandes dans la requête si elles surviennent avant l’appel de macro dans la requête. Ceci est différent de catalog::Modifier, où les commandes de la chaîne de requête remplacent toujours les commandes de la chaîne catalog::Modifier, quelle que soit la position de la requête.

Les macros de commande ne peuvent pas avoir de valeurs d’argument, mais des variables personnalisées peuvent être utilisées pour transmettre des valeurs de la requête à la macro.

Les macros peuvent être imbriquées avec la restriction suivante : Une macro ne peut être appelée que si elle est déjà définie au moment de l'analyse de la définition de macro, soit en apparaissant plus tôt dans le même fichier de définition de macro, soit en plaçant la définition d'une telle macro incorporée dans le fichier de définition de macro par défaut.

Exemple

Les macros peuvent s’avérer utiles si les mêmes attributs doivent être appliqués à des images différentes.

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

Nous pouvons définir une macro pour les attributs communs :

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

La macro serait utilisée comme suit :

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

Comme wid= est différent pour la troisième requête, nous remplaçons simplement la valeur après l'appel de la macro (la spécification de wid=avant $view$ n'aurait aucun effet).

Voir aussi

catalogue ::MacroFile , catalogue ::Modificateur, Guide de référence des définitions de macro

Sur cette page