Sample code for 30+ languages & platforms
Perl Requires Chilkat v11.7.0+

Put a Letterhead Behind the First Page of a PDF

See more PDF Watermark Examples

Demonstrates the pdfPage type, which places a page of another PDF as the watermark. It is the way to use a letterhead, a cover overlay or a vector logo that was saved as a PDF, and unlike an image it stays sharp at any size because it is drawn, not resampled. "zOrder" set to back puts it behind the existing content, where a letterhead belongs, and "pages" set to first restricts it to page one.

Chilkat Perl Downloads

Chilkat2 Perl
use strict;
use warnings;
use Chilkat2;

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

# The PDF used in this example is available at two_page_memo.pdf

# The PDF used in this example is available at letterhead.pdf

my $pdf = Chilkat2::Pdf->new;
my $success = $pdf->LoadFile('qa_data/pdf/two_page_memo.pdf');
if (!$success) {
    print $pdf->LastErrorText, "\n";
    exit;
}

my $json = Chilkat2::JsonObject->new;
$json->UpdateString('type', 'pdfPage');
$json->UpdateString('pdf.path', 'qa_data/pdf/letterhead.pdf');

# The page of the source PDF to use (1 by default).  "match" instead of a number places source
# page n on target page n, which suits a set of per-page backgrounds.
$json->UpdateInt('pdf.page', 1);

# Behind the memo's own text, on page one, scaled to the page.
$json->UpdateString('zOrder', 'back');
$json->UpdateString('pages', 'first');
$json->UpdateString('scale.fit', 'page');
$json->UpdateString('id', 'letterhead');

my $jsonOut = Chilkat2::JsonObject->new;
$success = $pdf->Watermark('add', $json, $jsonOut);
if (!$success) {
    print $pdf->LastErrorText, "\n";
    exit;
}

print 'id: ', $jsonOut->StringOf('id'), ' pages: ', $jsonOut->StringOf('pages'), "\n";

$success = $pdf->WriteFile('qa_output/memo_letterhead.pdf');
if (!$success) {
    print $pdf->LastErrorText, "\n";
    exit;
}

# Sample output:

# id: letterhead pages: 1