added \graphicspath support to \pgfdeclareimage

[sergiud]

Motivation for this change

This PR implements support for \graphicspath in \pgfdeclareimage.

Fixes #565.

Checklist

Please check the boxes to explicitly state your agreement to these terms:

• Code changes are licensed under GPLv2 + LPPLv1.3c
• Documentation changes are licensed under FDLv1.2

[hmenke]

Thank you for your contribution and your interest in PGF/TikZ! Unfortunately, I cannot merge the PR as is, because it is not compatible with Plain TeX and ConTeXt. But we will pick up your suggestion and implement it in a portable manner.

[sergiud]

OK, great.

[muzimuzhi]

A more general question: In LaTeX format, should pgf's \pgfutil@IfFileExists respect \input@path as its LaTeX relative \IfFileExists does? This would affect the loading of library/module, .table files, and of course images.

[hmenke]

On 2026-06-15 a more comprehensive testsuite was introduced for PGF/TikZ. This tests all new contributions against the examples extracted from the manual and checks whether anything has changed to avoid regressions. Since this pull request was opened before that, these tests were not run automatically. I have run l3build check on the result of the merge of this pull request branch into master. The result can be found below.

Tip

Your pull request might have failed some tests. This does not mean that your contribution will be rejected. In fact, depending on the changes you propose, it might even be expected that some tests fail, however, this needs to be evaluated carefully.

Failed tests

• pdftex

  • config-examples

    • pgfmanual-en-base-images
  • config-examples-pdf

    • pgfmanual-en-base-images
• latexdvips

  • config-examples

    • pgfmanual-en-base-images
• latexdvisvgm

  • config-examples

    • pgfmanual-en-base-images
• luatex

  • config-examples

    • pgfmanual-en-base-images
  • config-examples-pdf

    • pgfmanual-en-base-images
• xetex

  • config-examples

    • pgfmanual-en-base-images
  • config-examples-pdf

    • pgfmanual-en-base-images

[muzimuzhi]

Superseded by

• Use \IfFileExists and \InputIfFileExists from LaTeX format #1446

Sorry I was wrong.