Thorsten Schwander > TeX-AutoTeX > TeX::AutoTeX::StampPDF

Download:
TeX-AutoTeX-v0.906.0.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 1.9.2.7   Source  

NAME ^

TeX::AutoTeX::StampPDF - watermark PDF files

VERSION ^

This documentation refers to TeX::AutoTeX::StampPDF version 1.9.2.5

SYNOPSIS ^

use TeX::AutoTeX::StampPDF qw(stamp_pdf);

stamp_pdf($pdffile, $array_ref);

DESCRIPTION ^

This module modifies a given PDF file. It prints an arbitrary text string (within certain length limits) onto the left edge of the 1st page of a well formed PDF file.

This is intended to be used to put the arXiv stamp onto PDF-only and pdflatex submissions, but any type of "watermark" text string is possible.

Non adjustable settings are:

Font: Times-Roman

FontSize: 20

X-Y offsets

SUBROUTINES/METHODS ^

The single subroutine exported by this package is stamp_pdf.

stamp_pdf

stamp_pdf takes 2 arguments, the name of a PDF file, which must be apt to be opened r/w, and a reference to an array, which contains a text string in its [0]th element. A backup file of the original PDF is created temporarily, thus the current working directory has to be writeable by euid.

The reason for the second argument to be a reference to an array is that we intend to add an associated hyperlink to the stamp, which will be paired with the [0] element. Current limitations of CAM::PDF make this difficult.

DIAGNOSTICS ^

throw a TeX::AutoTeX::FatalException

CONFIGURATION AND ENVIRONMENT ^

none

DEPENDENCIES ^

CAM::PDF

INCOMPATIBILITIES ^

none

BUGS AND LIMITATIONS ^

The placement of the stamp is tuned to US letter size paper and dimensions are hard-coded. This is easily adaptable to other paper sizes if necessary.

Please report bugs to www-admin

AUTHOR ^

Thorsten Schwander <schwande@cs.cornell.edu>

LICENSE AND COPYRIGHT ^

Copyright (c) 2007 - 2011 arxiv.org http://arxiv.org/help/contact

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

syntax highlighting: