Ruby Requires Chilkat v11.7.0+

Watermark Only Some of a PDF's Pages

See more PDF Watermark Examples

Demonstrates choosing the pages to stamp. "pages" takes all (the default), first, last, odd, even, or a list of 1-based pages and ranges such as 1,3,5-9,12- where a trailing dash means "to the end". "excludePages" takes the same syntax and is applied afterwards, which is how you say "every page except the cover". The result reports the pages the watermark actually landed on. Ruby

require 'chilkat'

success = false

#  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

pdf = Chilkat::CkPdf.new()
success = pdf.LoadFile("qa_data/pdf/four_pages.pdf")
if (success == false)
    print pdf.lastErrorText() + "\n";
    exit
end

print "pages in the document: " + pdf.get_NumPages().to_s() + "\n";

json = Chilkat::CkJsonObject.new()
jsonOut = Chilkat::CkJsonObject.new()
json.UpdateString("type","text")
json.UpdateString("text","INTERNAL")
json.UpdateString("id","internal")

#  Every page except the first.
json.UpdateString("pages","all")
json.UpdateString("excludePages","1")
success = pdf.Watermark("add",json,jsonOut)
if (success == false)
    print pdf.lastErrorText() + "\n";
    exit
end

print "every page but the cover: " + jsonOut.stringOf("pages") + "\n";

#  A list of pages and ranges, on a second copy of the document.
pdf2 = Chilkat::CkPdf.new()
success = pdf2.LoadFile("qa_data/pdf/four_pages.pdf")
if (success == false)
    print pdf2.lastErrorText() + "\n";
    exit
end

json2 = Chilkat::CkJsonObject.new()
json2.UpdateString("type","text")
json2.UpdateString("text","APPENDIX")
json2.UpdateString("id","appendix")
json2.UpdateString("pages","2,4-")
success = pdf2.Watermark("add",json2,jsonOut)
if (success == false)
    print pdf2.lastErrorText() + "\n";
    exit
end

print "page 2 and 4 onwards: " + jsonOut.stringOf("pages") + "\n";

success = pdf.WriteFile("qa_output/four_pages_internal.pdf")
if (success == false)
    print pdf.lastErrorText() + "\n";
    exit
end

#  Sample output:

#  pages in the document: 4
#  every page but the cover: 2-4
#  page 2 and 4 onwards: 2,4