The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
App-PDF-Overlay-0.002
River stage zero No dependents
++
/ App::PDF::Overlay

NAME

pdfolay - insert a PDF document over/under another document

SYNOPSIS

pdfolay [options] [file ...]

 Options:
   --output=XXX         output document (default "__new__.pdf")
   --overlay=XXX        name of the overlay PDF document
   --back               overlay behind the source document
   --behind             same as --back
   --restart            restart the overlay at every source
   --repeat             cycle overlay pages if source hase more pages
   --ident              shows identification
   --help               shows a brief help message and exits
   --man                shows full documentation and exits
   --verbose            provides more verbose information
   --quiet              runs as silently as possible

OPTIONS

--output=XXX

Name of the resultant PDF document.

Default is __new__.pdf.

--overlay=XXX

Name of the PDF document to overlay.

--back

Insert the overlay document behind the source documents.

--repeat

Repeat (cycle through) the pages of the overlay document when the source document has more pages than the overlay.

Default is to stop overlaying when the pages of the overlay document are exhausted.

--restart

Restart overlaying with the first page of the overlay document when a new source document is processed.

--help

Prints a brief help message and exits.

--man

Prints the manual page and exits.

--ident

Prints program identification.

--verbose

Provides more verbose information. This option may be repeated to increase verbosity.

--quiet

Suppresses all non-essential information.

file

The input PDF documents.

DESCRIPTION

This program will read the given input PDF file(s) and copy them into a new output document.

Optionally, an overlay PDF document can be specified. If so, the pages of the overlay document are inserted over (or, with option --behind, behind) the pages of the source documents.

When the source documents have more pages than the overlay document, there are a couple of ways to reuse the overlay pages. These can be controlled with the options --restart and --repeat.

Assuming the source documents have pages A B C and D E F, and the overlay document has pages X Y, then the combinations are:

    default:        AX BY C   D  E  F
    repeat:         AX BY CX  DY EX FY
    restart:        AX BY C   DX EY F
    repeat+restart: AX BY CX  DX EY FX

AUTHOR

Johan Vromans, <JV at cpan.org>

SUPPORT AND DOCUMENTATION

Development of this module takes place on GitHub: https://github.com/sciurius/perl-App-PDF-Overlay.

You can find documentation for this module with the perldoc command.

    perldoc App::PDF::Overlay

Please report any bugs or feature requests using the issue tracker on GitHub.

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

Copyright 2022 Johan Vromans, all rights reserved.

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