Chilkat Examples

ChilkatHOMEAndroid™Classic ASPCC++C#Mono C#.NET Core C#C# UWP/WinRTDataFlexDelphi ActiveXDelphi DLLVisual FoxProJavaLianjaMFCObjective-CPerlPHP ActiveXPHP ExtensionPowerBuilderPowerShellPureBasicCkPythonChilkat2-PythonRubySQL ServerSwift 2Swift 3,4,5...TclUnicode CUnicode C++Visual Basic 6.0VB.NETVB.NET UWP/WinRTVBScriptXojo PluginNode.jsExcelGo

Tcl Examples

Web API Categories

ASN.1
Amazon EC2
Amazon Glacier
Amazon S3
Amazon S3 (new)
Amazon SES
Amazon SNS
Amazon SQS
Async
Azure Cloud Storage
Azure Service Bus
Azure Table Service
Base64
Bounced Email
Box
CAdES
CSR
CSV
Certificates
Compression
DKIM / DomainKey
DSA
Diffie-Hellman
Digital Signatures
Dropbox
Dynamics CRM
ECC
Ed25519
Email Object
Encryption
FTP
FileAccess
Firebase
GMail REST API
GMail SMTP/IMAP/POP
Geolocation
Google APIs
Google Calendar
Google Cloud SQL
Google Cloud Storage
Google Drive
Google Photos
Google Sheets
Google Tasks
Gzip

HTML-to-XML/Text
HTTP
HTTP Misc
IMAP
JSON
JSON Web Encryption (JWE)
JSON Web Signatures (JWS)
JSON Web Token (JWT)
Java KeyStore (JKS)
MHT / HTML Email
MIME
MS Storage Providers
Microsoft Graph
NTLM
OAuth1
OAuth2
Office365
OneDrive
OpenSSL
Outlook
Outlook Calendar
PDF Signatures
PEM
PFX/P12
POP3
PRNG
REST
REST Misc
RSA
SCP
SFTP
SMTP
SSH
SSH Key
SSH Tunnel
SharePoint
Socket/SSL/TLS
Spider
Stream
Tar Archive
Upload
WebSocket
XAdES
XML
XML Digital Signatures
XMP
Zip
curl

 

 

 

(Tcl) PDF Signature Page Location

See more PDF Signatures Examples

This example demonstrates how to specify the location of a PDF signature on a page.

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

Chilkat Tcl Extension Downloads

Chilkat Tcl Extension Downloads

load ./chilkat.dll

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

set pdf [new_CkPdf]

# Load a PDF to be signed.
# The "hello.pdf" is available at https://chilkatsoft.com/hello.pdf
set success [CkPdf_LoadFile $pdf "qa_data/pdf/hello.pdf"]
if {$success == 0} then {
    puts [CkPdf_lastErrorText $pdf]
    delete_CkPdf $pdf
    exit
}

set json [new_CkJsonObject]

# When cryptographically signing a PDF, the signature's appearance can be placed on a specific
# page in the PDF document, and at a specified location on the page.
# The 1st page of the PDF document is page number 1 (we don't use 0-based numbering for PDF page numbers).
# The PDF object has a NumPages property, so we can use it to sign on the last page of the PDF.
CkJsonObject_UpdateInt $json "page" [CkPdf_get_NumPages $pdf]

# appearance.y and appearance.x JSON properties control the x,y location of the signature.
# The "appearance.y" can be "top" or "bottom".
# The "appearance.x" can be "left", "middle", or "right".
# It is also possible to specify exact PDF location in user space coordinates, which is discussed below.
CkJsonObject_UpdateString $json "appearance.y" "bottom"
CkJsonObject_UpdateString $json "appearance.x" "middle"

# In this example, the fontScale (in combination with the number of appearance text lines and the length of the longest text line),
# automatically determine the width/height of the signature text box. Any included graphic (JPG image or built-in SVG) is automatically
# scaled to fit. It is alternatively possible to specify the desired width/height of the signature rectangle.  In that case
# you would NOT specify a fontScale because Chilkat would automatically chose a font scale to fit the text to the desired rectangle.
# This example demonstrates how to specify the exact width/height of the PDF signature text box.
CkJsonObject_UpdateString $json "appearance.fontScale" "9.0"

CkJsonObject_UpdateString $json "appearance.text[0]" "Digitally signed by: cert_cn"
CkJsonObject_UpdateString $json "appearance.text[1]" "current_dt"
CkJsonObject_UpdateString $json "appearance.image" "document-accepted"
CkJsonObject_UpdateString $json "appearance.imagePlacement" "left"
CkJsonObject_UpdateString $json "appearance.imageOpacity" "100"

# Load the signing certificate. (Use your own certificate.)
set cert [new_CkCert]

set success [CkCert_LoadPfxFile $cert "qa_data/pfx/myPdfSigningCert.pfx" "pfx_password"]
if {$success == 0} then {
    puts [CkCert_lastErrorText $cert]
    delete_CkPdf $pdf
    delete_CkJsonObject $json
    delete_CkCert $cert
    exit
}

# Tell the pdf object to use the certificate for signing.
set success [CkPdf_SetSigningCert $pdf $cert]
if {$success == 0} then {
    puts [CkPdf_lastErrorText $pdf]
    delete_CkPdf $pdf
    delete_CkJsonObject $json
    delete_CkCert $cert
    exit
}

set success [CkPdf_SignPdf $pdf $json "qa_output/hello_signed.pdf"]
if {$success == 0} then {
    puts [CkPdf_lastErrorText $pdf]
    delete_CkPdf $pdf
    delete_CkJsonObject $json
    delete_CkCert $cert
    exit
}

puts "The PDF has been successfully cryptographically signed."

# The appearance of the signature appears in Adobe Acrobat as shown here:

# ----------------------------------------------------------------------------------------------------
# *** Scroll down for information about specifying the PDF signature x,y location in user space coordinates.
# ----------------------------------------------------------------------------------------------------



# The x,y coordinates of a PDF page are in "user space", called "points", and there are 72 pointes per inch.
# A PDF page (8.5" x 11") is 612 points wide and 792 points high.
# The bottom left is at 0,0.    The top right is at 612,792.
# 
# To specify the location of a signature rectangle, the "appearance.y" is the y coordinate of the top of the signature rectangle,
# and the "appearance.x" is the x coordinate of the left of the signature rectangle.
# Therefore, to position the signature rectangle at the exact top/left of the page, we do this:

CkJsonObject_UpdateString $json "appearance.y" "792"
CkJsonObject_UpdateString $json "appearance.x" "0"

CkJsonObject_UpdateString $json "appearance.text[0]" "Digitally signed again by: cert_cn"
CkJsonObject_UpdateString $json "appearance.text[1]" "current_dt"
CkJsonObject_UpdateString $json "appearance.image" "document-accepted"
CkJsonObject_UpdateString $json "appearance.imagePlacement" "right"

set pdf2 [new_CkPdf]

set success [CkPdf_LoadFile $pdf2 "qa_output/hello_signed.pdf"]
set success [CkPdf_SetSigningCert $pdf2 $cert]

set success [CkPdf_SignPdf $pdf2 $json "qa_output/hello_signed2.pdf"]
if {$success == 0} then {
    puts [CkPdf_lastErrorText $pdf2]
    delete_CkPdf $pdf
    delete_CkJsonObject $json
    delete_CkCert $cert
    delete_CkPdf $pdf2
    exit
}

puts "The PDF has been successfully cryptographically signed again."

# Here we have the PDF with the signature just added at the exact top/left.


delete_CkPdf $pdf
delete_CkJsonObject $json
delete_CkCert $cert
delete_CkPdf $pdf2

 

© 2000-2021 Chilkat Software, Inc. All Rights Reserved.