C 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. C

#include <C_CkPdf.h>
#include <C_CkJsonObject.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkPdf pdf;
    HCkJsonObject json;
    HCkJsonObject jsonOut;

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

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

    pdf = CkPdf_Create();
    success = CkPdf_LoadFile(pdf,"qa_data/pdf/two_page_memo.pdf");
    if (success == FALSE) {
        printf("%s\n",CkPdf_lastErrorText(pdf));
        CkPdf_Dispose(pdf);
        return;
    }

    json = CkJsonObject_Create();
    CkJsonObject_UpdateString(json,"type","pdfPage");
    CkJsonObject_UpdateString(json,"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.
    CkJsonObject_UpdateInt(json,"pdf.page",1);

    //  Behind the memo's own text, on page one, scaled to the page.
    CkJsonObject_UpdateString(json,"zOrder","back");
    CkJsonObject_UpdateString(json,"pages","first");
    CkJsonObject_UpdateString(json,"scale.fit","page");
    CkJsonObject_UpdateString(json,"id","letterhead");

    jsonOut = CkJsonObject_Create();
    success = CkPdf_Watermark(pdf,"add",json,jsonOut);
    if (success == FALSE) {
        printf("%s\n",CkPdf_lastErrorText(pdf));
        CkPdf_Dispose(pdf);
        CkJsonObject_Dispose(json);
        CkJsonObject_Dispose(jsonOut);
        return;
    }

    printf("id: %s pages: %s\n",CkJsonObject_stringOf(jsonOut,"id"),CkJsonObject_stringOf(jsonOut,"pages"));

    success = CkPdf_WriteFile(pdf,"qa_output/memo_letterhead.pdf");
    if (success == FALSE) {
        printf("%s\n",CkPdf_lastErrorText(pdf));
        CkPdf_Dispose(pdf);
        CkJsonObject_Dispose(json);
        CkJsonObject_Dispose(jsonOut);
        return;
    }

    //  Sample output:

    //  id: letterhead pages: 1


    CkPdf_Dispose(pdf);
    CkJsonObject_Dispose(json);
    CkJsonObject_Dispose(jsonOut);

    }