Comprehensive TeX Archive Network

Direc­tory macros/latex/contrib/pstool

The pstool package

A package like `pst-pdf` for processing PostScript graphics
with psfrag labels within pdfLaTeX 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.

Running `latex` on pstool.tex will produce the files
  pstool.ins, pstool.sty, and README.txt,
and compile the PDF documentation.

Executing `latex pstool.ins` produces the files above
except pstool.ins (and the PDF file, obviously).

Please see the PDF documentation for further information.

* Copyright 2008–2014 Zebb Prime
* Copyright 2008–2017 Will Robertson
* Distributed under the LaTeX Project Public License, "maintained" by Will Robertson

Change history

* v1.5d, Oct 2017:
  - Use `shellesc` package for write18 in LuaTeX.

* 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 LaTeX 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.

Down­load the con­tents of this pack­age in one zip archive (417.6k).

pstool – Sup­port for ps­frag within pdf

The pack­age works in the same sort of way as pst-pdf, but it also pro­cesses the PostScript graph­ics with ps­frag to add la­bels within the graphic, be­fore con­ver­sion. Thus the bun­dle re­places two steps of an or­di­nary work­flow. (Nat­u­rally, the pack­age re­quires that \write 18 is en­abled.)

Ps­tool en­sures that each ver­sion of each graphic is com­piled once only (the graphic is (re-)com­piled only if it has changed since the pre­vi­ous com­pi­la­tion of the doc­u­ment). This dras­ti­cally speeds up the run­ning of the pack­age in the typ­i­cal case (though the first run of any doc­u­ment is in­evitably just as slow as with any sim­i­lar pack­age).

Ver­sion1.5d 2017-10-13
Li­cense The Project Public Li­cense 1.3c
Copy­right2008–2014 Zebb Prime
2008–2017 Will Robert­son
Main­tainerWill Robert­son
Zebb Prime
TDS archivepstool.tds.zip
Con­tained inTeX Live as pstool
MiKTeX as pstool
Topics con­vert­ing graph­ics files from out­put or (E)PS to em­bed­dable PDF
text within graph­ics (drawn or over­laid)
Guest Book Sitemap Contact Contact Author