22.2.2 \DeclareGraphicsExtensions

Synopsis :

\DeclareGraphicsExtensions{liste séparée par des virgules d'extensions de fichier}

Déclare les extensions de nom de fichier à essayer. Ceci vous permet de spécifier l’ordre dans lequel les formats graphiques sont choisis quant les fichiers graphiques sont inclus en donnant le nom de fichier sans l’extension, comme dans \includegraphics{courbe_de_fonction}.

Dans l’exemple qui suit, LaTeX trouve les fichiers au format PNG avant les fichiers PDF.

\DeclareGraphicsExtensions{.png,PNG,.pdf,.PDF}
  ...
\includegraphics{lion}   % trouve lion.png avant lion.pdf

Du fait que le nom lion ne contient pas de point, LaTeX utilise la liste d’extension. Pour chacun des répertoires dans la liste de chemins graphiques (voir \graphicspath), LaTeX essaie les extensions dans l’ordre donné. S’il ne trouve aucun fichier correspondant après avoir essayé tous les répertoires et toutes les extensions, alors il renvoie une erreur ‘! LaTeX Error: File `lion' not found’. Notez que vous devez inclure le point au début de chaque extension.

Du fait que les noms de fichiers sous GNU/Linux et Macintosh sont sensibles à la casse, la liste des extensions de fichier est sensible à la casse sur ces plateformes. La plateforme Windows n’est pas sensible à la casse.

Vous n’êtes pas tenu d’inclure \DeclareGraphicsExtensions dans votre document ; le pilote d’impression a une valeur par défaut raisonnable. Par exemple, la version la plus récente de pdftex.def a cette liste d’extensions.

.pdf,.png,.jpg,.mps,.jpeg,.jbig2,.jb2,.PDF,.PNG,.JPG,.JPEG,.JBIG2,.JB2

Pour modifier cet ordre, utilisez le paquetage grfext.

Vous pouvez utiliser cette commande n’importe où dans le document. Vous pouvez l’utiliser plus d’une fois. On peut afficher la valeur courante avec \makeatletter\typeout{\Gin@extensions}\makeatother.