Skip to content
On this page

Auto-Sizing Signatures to Fit a Signature Area

There are many cases where you must work with existing forms or documents which were designed for paper presentation. The signature locations as well as related data (printed name, title, organization, etc.) may be in confined spaces and you do not want signature images, signature text, or other signature block data to overprint any adjacent information. The solution is AutoFit.

Data Block Elements

AutoFit is a property that allows you to automatically fit any AlphaTrust® e-Sign signature data block element into a defined rectangular space. AlphaTrust® e-Sign signature block elements include:

  • The signature (image or font signature)
  • Email address
  • Title
  • Organization
  • and then three additional fields that may be used for any of the following:
    • Printed name
    • Date
    • IP address
    • the AlphaTrust® e-Sign DocumentID
    • the AlphaTrust® e-Sign TaskID
    • or even just arbitrary text that you define.

Any or all of these data elements may be auto-sized to fit a confined space in your PDF document.

When you request AutoFit for a data element, you specify the following values:

Properties

PropertyDescriptionType
AutoFitTurns the auto-sizing functionality on or off.bool
FontSizeMinimumThe minimum font size that the text may be reduced to (for printed text data, not images) when auto-fitting the text to the specified size constraints.integer
MaxWidthSet the maximum width the the signature or the additional signature block data can be. This value may be inherited from the width of the PDF field defined as the location for the data element by leaving this field null when using a PDF Form Field as the method of placement.short
MaxHeightSet the maximum height the the signature or the additional signature block data can be. This value may be inherited from the height of the PDF field defined as the location for the data element by leaving this field null when using a PDF Form Field as the method of placement.short
FontNameThis is the font to use for printed data. Only these three fonts are supported; Courier, Helvetica, or Times. These choices are to allow a mono-spaced font, a sans-serif font, and a serif font option. Helvetica is defaulted if not defined. NOTE: applies to additional signature block data only - not signaturesFontNames
FontColorThis is the font color to use for printed data. Only these three colors are supported; blue, black or red. Blue is defaulted if not defined. NOTE: applies to additional signature block data only - not signaturesSignatureBlockColor

If you specify a PDF field name as the location reference and you do not supply a value or supply a 0 value for MaxWidth or MaxHeight then the width and/or height will be taken from the width and/or height of the PDF field specified. In this way you can use the PDF field dimensions to define the auto fit bounding box.

If you do not specifically set the AutoFit flag for a data element, but you do specify a value for MaxWidth and MaxHeight, then AutoFit will be turned on. You must always specifically set the AutoFit Flag when you want to inherit the width and height from a PDF form field.

Rules

The rules for AutoFit processing by AlphaTrust® e-Sign are as follows:

  1. Print the data on one line at the normal, or requested, font size.
  2. If that will not "fit" then test to see if the data will fit on one line at a reduced font size, and also if it will fit on two lines at a reduced font size, however the font size will not be reduced below the size specified for FontSizeMinimum.
  3. When auto-fitting lines will be broken only at whole words boundaries.
  4. If the data can fit using both one line (reduced font size) and using two lines (at regular or reduced font size), then use the option that prints at the largest font size.
  5. If the data cannot fit at the minimum font size, then the data will be printed on two lines at the minimum font size and will extend to the right of the bounding box.

For images (i.e. signature images from Registered user's profiles, or Mouse-Drawn signatures) the image will be resized to fit in the bounding box. The aspect ratio of the image will be maintained.