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

# Put the signature on page 1, top left
CkJsonObject_UpdateInt $json "page" 1
CkJsonObject_UpdateString $json "appearance.y" "top"
CkJsonObject_UpdateString $json "appearance.x" "left"

# Add some text.
CkJsonObject_UpdateString $json "appearance.text[0]" "Digitally signed by: cert_cn"
CkJsonObject_UpdateString $json "appearance.text[1]" "current_dt"

# Add a built-in SVG graphic to the right.
CkJsonObject_UpdateString $json "appearance.image" "blue-check-mark"
CkJsonObject_UpdateString $json "appearance.imagePlacement" "right"
CkJsonObject_UpdateString $json "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.
CkJsonObject_UpdateInt $json "appearance.width" [expr 72 * 3]
CkJsonObject_UpdateInt $json "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".
CkJsonObject_UpdateInt $json "appearance.width" [expr 72 * 4]
CkJsonObject_UpdateString $json "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".
CkJsonObject_UpdateString $json "appearance.width" "auto"
CkJsonObject_UpdateInt $json "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.

# jAppearance is a CkJsonObject
set jAppearance [CkJsonObject_ObjectOf $json "appearance"]
CkJsonObject_Delete $jAppearance "width"
CkJsonObject_Delete $jAppearance "height"
delete_CkJsonObject $jAppearance

CkJsonObject_UpdateString $json "appearance.fontScale" "10.0"

# With fontScale = "10.0"


# 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."

delete_CkPdf $pdf
delete_CkJsonObject $json
delete_CkCert $cert

 

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