Rust Requires Chilkat v11.7.0+

A PDF Watermark That Only Appears When Printed

See more PDF Watermark Examples

Demonstrates a watermark that is invisible on screen and appears on paper, which is what a "printed copies are uncontrolled" marking needs. Two approaches can do it: an optional-content layer with layer.view off and layer.print on, which also gives the reader an entry in the layers panel of the viewer (layer.locked stops them switching it), and a Watermark annotation with annotation.view false and annotation.print true. annotation.fixedPrint keeps the printed size and position the same whatever paper it goes on. Rust

// 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

let pdf = chilkat::Pdf::new();
if pdf.load_file("qa_data/pdf/two_page_memo.pdf").is_err() {
    println!("{}", pdf.last_error_text());
    return;
}

let json = chilkat::JsonObject::new();
let _ = json.update_string("type", "text");
let _ = json.update_string("text", "UNCONTROLLED WHEN PRINTED");
let _ = json.update_string("id", "printonly");

// As a layer: off on screen, on when printing, and locked so the reader cannot switch it on.
let _ = json.update_string("approach", "layer");
let _ = json.update_string("layer.name", "Print marking");
let _ = json.update_string("layer.view", "off");
let _ = json.update_string("layer.print", "on");
let _ = json.update_bool("layer.locked", true);

let _ = json.update_string("rotation", "diagonal");
let _ = json.update_string("scale.fit", "page");
let _ = json.update_number("scale.fitPercent", "70");
let _ = json.update_number("opacity", "0.3");

let json_out = chilkat::JsonObject::new();
if pdf.watermark("add", &json, &json_out).is_err() {
    println!("{}", pdf.last_error_text());
    return;
}

println!("layer id: {} pages: {}", json_out.string_of("id").unwrap_or_default(), json_out.string_of("pages").unwrap_or_default());

if pdf.write_file("qa_output/memo_print_only.pdf").is_err() {
    println!("{}", pdf.last_error_text());
    return;
}

// The same thing as an annotation instead.
let pdf2 = chilkat::Pdf::new();
if pdf2.load_file("qa_data/pdf/two_page_memo.pdf").is_err() {
    println!("{}", pdf2.last_error_text());
    return;
}

let json2 = chilkat::JsonObject::new();
let _ = json2.update_string("type", "text");
let _ = json2.update_string("text", "UNCONTROLLED WHEN PRINTED");
let _ = json2.update_string("id", "printonly2");
let _ = json2.update_string("approach", "annotation");
let _ = json2.update_bool("annotation.view", false);
let _ = json2.update_bool("annotation.print", true);
let _ = json2.update_bool("annotation.fixedPrint", true);
let _ = json2.update_string("rotation", "diagonal");
if pdf2.watermark("add", &json2, &json_out).is_err() {
    println!("{}", pdf2.last_error_text());
    return;
}

println!("annotation id: {}", json_out.string_of("id").unwrap_or_default());

// Sample output:

// layer id: printonly pages: 1-2
// annotation id: printonly2