22.2.3 \DeclareGraphicsRule

Synopsis :

\DeclareGraphicsRule{extension}{type}{extension taille-fic}{commande}

Déclare comment gérer les fichiers graphiques dont le nom se termine en extension.

L’exemple suivant déclare que tous les fichiers dont le nom est de la forme nomfichier-sans-point.mps doivent être traités comme une sortie de MetaPost, ce qui signifie que le pilote d’impression utilisera son code de gestion MetaPost pour traiter le fichier en entrée.

\DeclareGraphicsRule{.mps}{mps}{.mps}{}

La déclaration suivante

\DeclareGraphicsRule{*}{mps}{*}{}

dit à LaTeX qu’il doit traiter comme une sortie MetaPost tout fichier avec extension non couverte par une autre règle, ainsi il couvre nomfichier.1, nomfichier.2, etc.

Ici on décrit les quatre arguments.

extension

L’extension de nom de fichier à laquelle la règle considérée s’applique. L’extension commence au premier point dans le nom de fichier, en incluant le point. Utiliser l’astérisque, *, pour désigner la comportement par défaut pour toutes les extensions non déclarées.

type

Le type du fichier considéré. Ce type est une chaîne de caractères qui doit être définie dans le pilote d’impression. Par exemple, les fichiers avec les extensions .ps, .eps, ou .ps.gz peuvent tous être classifiés sous le type eps. Tous les fichiers de même type sont traités en entrée avec la même commande interne par le pilote d’impression. Par exemple, les types de fichiers reconnus par pdftex sont : jpg, jbig2, mps, pdf, png, tif.

extension taille-fic

L’extension du fichier à lire pour déterminer la taille du graphique, si un tel fichier existe. Elle peut être la même que extension mais aussi être différente.

Considérons par exemple un graphique PostScript. Pour le rendre plus petit, il peut être compressé en un fichier .ps.gz. Les fichiers compressé ne sont pas lu simplement par LaTeX aussi vous pouvez mettre l’information de boîte englobante dans une fichier séparé. Si extension taille-fic est vide, alors vous devez spécifier l’information de taille dans les arguments de \includegraphics.

Si le fichier pilote a une procédure pour lire les tailles de fichier pour type alors elle est utilisée, sinon il utilise la procédure pour lire les fichiers .eps. (Ainsi vous pourriez spécifier la taille d’un fichier .bmp dans un fichier avec une ligne %%BoundingBox de style PostScript si aucun autre format n’est disponible).

commande

Une commande à appliquer au fichier. La plupart du temps on laisse cet argument vide. Cette commande doit commencer avec un caractère accent grave. Ainsi, \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1} spécifie que tout fichier ayant une extension .eps.gz doit être traité comme un fichier eps, avec l’information de boîte englobante stockée dans le fichier ayant l’extension .eps.bb, et que la commande gunzip -c sera exécuté sur votre plateforme pour décompresser le fichier.

Une telle commande est spécifique à votre plateforme. De plus, votre système TeX doit autoriser l’exécution de commandes externes ; par mesure de sécurité les systèmes modernes restreignent l’exécution de commandes à moins que vous l’autorisiez explicitement. Se référer à la documentation de votre distribution TeX.