(PowerBuilder) PDF Signature Appearance Width and Height

See more PDF Signatures Examples

This example explains how the width and height of the signature appearance rectangle box is determined.

Note: This example requires Chilkat v9.5.0.85 or greater.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

integer li_rc
oleobject loo_Pdf
integer li_Success
oleobject loo_Json
oleobject loo_JAppearance
oleobject loo_Cert

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

loo_Pdf = create oleobject
// Use "Chilkat_9_5_0.Pdf" for versions of Chilkat < 10.0.0
li_rc = loo_Pdf.ConnectToNewObject("Chilkat.Pdf")
if li_rc < 0 then
    destroy loo_Pdf
    MessageBox("Error","Connecting to COM object failed")
    return
end if

// Load a PDF to be signed.
// The "hello.pdf" is available at https://chilkatsoft.com/hello.pdf
li_Success = loo_Pdf.LoadFile("qa_data/pdf/hello.pdf")
if li_Success = 0 then
    Write-Debug loo_Pdf.LastErrorText
    destroy loo_Pdf
    return
end if

// Options for signing are specified in JSON.
loo_Json = create oleobject
// Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
li_rc = loo_Json.ConnectToNewObject("Chilkat.JsonObject")

// In most cases, the signingCertificateV2 and signingTime attributes are required.
loo_Json.UpdateInt("signingCertificateV2",1)
loo_Json.UpdateInt("signingTime",1)

// Put the signature on page 1, top left
loo_Json.UpdateInt("page",1)
loo_Json.UpdateString("appearance.y","top")
loo_Json.UpdateString("appearance.x","left")

// Add some text.
loo_Json.UpdateString("appearance.text[0]","Digitally signed by: cert_cn")
loo_Json.UpdateString("appearance.text[1]","current_dt")

// Add a built-in SVG graphic to the right.
loo_Json.UpdateString("appearance.image","blue-check-mark")
loo_Json.UpdateString("appearance.imagePlacement","right")
loo_Json.UpdateString("appearance.imageOpacity","100")

// There are 4 ways the width and height of the signature rectangle can be specified.
// 1) The width and height (in points) are both explicitly specified.
//    User space coordinates use "points" where 72 points equals 1 inch.
//    For example (3 inches wide and 1 inch high)
//    The fontScale is automatically chose to fit.  In addition, if a graphic (JPG or built-in SVG) is included,
//    it is automatically scaled such that the text + graphic fit together in the specified rectangle.
//    Note: When both height and width are explicitly specified, the resultant signature appearance rectangle
//    will match one of the dimensions, but the other dimension will be equal or smaller.  This is because the text
//    must be proportionally scaled.
loo_Json.UpdateInt("appearance.width",72 * 3)
loo_Json.UpdateInt("appearance.height",72)

// The signature would have this appearance. In this case, the height is actually less than 1 inch because
// if Chilkat chose a fontScale to fill the height, the resulting text's width would be too long for the desired width. 


// 2) The width is explicitly specified, but we use the keyword "auto" for height.
//    In this case, the fontScale is chosen to achieve the desired width,
//    and the height will be whatever the result of the chosen font scale.
//    In this example, the width is 4 inches, and the height is "auto".
loo_Json.UpdateInt("appearance.width",72 * 4)
loo_Json.UpdateString("appearance.height","auto")

// The signature would have this appearance: 


// 3) The height is explicitly specified, but we use the keyword "auto" for width.
//    In this case, the fontScale is chosen to achieve the desired height,
//    and the width will be whatever the result of the chosen font scale.
//    In this example, the height is 1 inch (72 points) and the width is "auto".
loo_Json.UpdateString("appearance.width","auto")
loo_Json.UpdateInt("appearance.height",72)

// The signature would have this appearance.


// 4) Finally, we don't need to specify width/height at all.  Instead, we can choose a fontScale
//    and the dimensions of the PDF signature appearance's rectangle will be the result of using the
//    specified fontScale.

loo_JAppearance = loo_Json.ObjectOf("appearance")
loo_JAppearance.Delete("width")
loo_JAppearance.Delete("height")
destroy loo_JAppearance
loo_Json.UpdateString("appearance.fontScale","10.0")

// With fontScale = "10.0"


// Load the signing certificate. (Use your own certificate.)
loo_Cert = create oleobject
// Use "Chilkat_9_5_0.Cert" for versions of Chilkat < 10.0.0
li_rc = loo_Cert.ConnectToNewObject("Chilkat.Cert")

li_Success = loo_Cert.LoadPfxFile("qa_data/pfx/myPdfSigningCert.pfx","pfx_password")
if li_Success = 0 then
    Write-Debug loo_Cert.LastErrorText
    destroy loo_Pdf
    destroy loo_Json
    destroy loo_Cert
    return
end if

// Tell the pdf object to use the certificate for signing.
li_Success = loo_Pdf.SetSigningCert(loo_Cert)
if li_Success = 0 then
    Write-Debug loo_Pdf.LastErrorText
    destroy loo_Pdf
    destroy loo_Json
    destroy loo_Cert
    return
end if

li_Success = loo_Pdf.SignPdf(loo_Json,"qa_output/hello_signed.pdf")
if li_Success = 0 then
    Write-Debug loo_Pdf.LastErrorText
    destroy loo_Pdf
    destroy loo_Json
    destroy loo_Cert
    return
end if

Write-Debug "The PDF has been successfully cryptographically signed."


destroy loo_Pdf
destroy loo_Json
destroy loo_Cert