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

Page Numbers, Dates and the File Name in a PDF Watermark

See more PDF Watermark Examples

Demonstrates the placeholders a text watermark understands, each replaced per page as the watermark is added: {page} is the page number, {pages} the page count, {date:FORMAT} the current local date and time, and {filename} the name of the file that was loaded. Two braces give a literal brace. pageNumber.start sets what {page} is on the first page, which is how a numbering that ignores a cover is produced, and pageNumber.style formats both {page} and {pages} as decimal, romanUpper, romanLower, letterUpper or letterLower.

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 four_pages.pdf

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

my $json = Chilkat2::JsonObject->new;
$json->UpdateString('type', 'text');
$json->UpdateString('text', 'Page {page} of {pages}  -  printed {date:yyyy-MM-dd HH:mm}  -  {filename}');
$json->UpdateString('id', 'pagefoot');
$json->UpdateString('position.align', 'bottom');
$json->UpdateNumber('position.margin', '24');
$json->UpdateNumber('font.size', '9');
$json->UpdateString('color', '#505050');

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

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

# Roman numerals that start at i on page 2, so that a cover page is not numbered.
my $pdf2 = Chilkat2::Pdf->new;
$success = $pdf2->LoadFile('qa_data/pdf/four_pages.pdf');
if (!$success) {
    print $pdf2->LastErrorText, "\n";
    exit;
}

my $json2 = Chilkat2::JsonObject->new;
$json2->UpdateString('type', 'text');
$json2->UpdateString('text', '- {page} -');
$json2->UpdateString('id', 'roman');
$json2->UpdateString('pages', '2-');
$json2->UpdateInt('pageNumber.start', 1);
$json2->UpdateString('pageNumber.style', 'romanLower');
$json2->UpdateString('position.align', 'bottom');
$json2->UpdateNumber('font.size', '10');
$success = $pdf2->Watermark('add', $json2, $jsonOut);
if (!$success) {
    print $pdf2->LastErrorText, "\n";
    exit;
}

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

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

# Sample output:

# footer pages: 1-4
# roman pages: 2-4