CTAN Comprehensive TeX Archive Network

Directory macros/latex/contrib/pstool


The pstool package

A package like pst-pdf for processing PostScript graphics with psfrag labels within pdf documents. The difference with this package is that every graphic is compiled individually, drastically speeding up compilation time when only a single figure needs re-processing.

An example and a testsuite is available in the source repository for the package: https://github.com/wspr/pstool

Please see the PDF documentation for further information.

  • Copyright 2008–2014 Zebb Prime
  • Copyright 2008–2018 Will Robertson


This work may be distributed and/or modified under the conditions of the Project Public License, either version 1.3c or (at your option) any later version. The latest version of this license is in: http://www.latex-project.org/lppl.txt

This work has the LPPL maintenance status maintained'. The Current Maintainer of this work is Will Robertson.

Change history

  • v1.5e, Jan 2018:
    • New package option crossref=false to disable cross-referencing support.
  • v1.5d, Oct 2017:
    • Use shellesc package for write18 in Lua.
  • v1.5c:
    • Documentation update; some minor cosmetic code changes.
  • v1.5b:
    • Fix conflict with beamer, which resets the catcode of @ with begin{document}.
  • v1.5a, March 2013:
    • Fix bug introduced in last version in which plain compilation (producing DVI) produced erroneous output above each figure.
  • v1.5, February 2013:
    • Fix =/# mixup in Windows ps2pdf options.
    • Check the .tex file for newness when regenerating figures.
    • Add macro-file=... for a global file to retrieve psfrag macros (default is "jobname-pstool.tex"). Thanks to Heinrich Kruger for suggestions for the above.
    • Cross-references and citations within external graphics are now supported.
  • v1.4, November 2010:
    • More robust parsing of the main input file to read in the preamble. Therefore, EndPreamble is now required much less often.
    • Apparently unreleased to CTAN, oops :)
  • v1.3, July 2009:
    • bitmap option to control compression of bitmap graphics,
    • Package options may now be set anywhere with pstoolsetup{},
    • localised pstool options can be set per-graphic.

Download the contents of this package in one zip archive (370.2k).

pstool – Support for psfrag within pdf

The package works in the same sort of way as pst-pdf, but it also processes the PostScript graphics with psfrag to add labels within the graphic, before conversion. Thus the bundle replaces two steps of an ordinary workflow. (Naturally, the package requires that \write 18 is enabled.)

Pstool ensures that each version of each graphic is compiled once only (the graphic is (re-)compiled only if it has changed since the previous compilation of the document). This drastically speeds up the running of the package in the typical case (though the first run of any document is inevitably just as slow as with any similar package).

Version1.5e 2018-01-20
LicensesThe Project Public License 1.3c
Copyright2008–2014 Zebb Prime
2008–2018 Will Robertson
MaintainerZebb Prime
Will Robertson
Contained inTeX Live as pstool
MiKTeX as pstool
TopicsGraphics text
Graphics EPS/PDF
Guest Book Sitemap Contact Contact Author