GroupDocs.Signature for .NET 21.11 Release Notes

Major Features

This release contains new features with Pdf and Spreadsheet documents processing, new method with Image signatures and enhancements with customizing Digital Signature appearance. New barcode type Mailmark was added to support signing and searching. Also this update contains few fixed issues with document processing. Below the list of most notable changes in release of GroupDocs.Signature for .NET 21.11:

• Involved new settings for Pdf Digital Signature Appearance.
• Added new Barcode potal type Mailmark.
• Implemented a way to compose Image siganture from base64 string content.
• New export types were added for Spreadsheet documents.
• Few issues were fixed.

Full List of Issues Covering all Changes in this Release

Public API and Backward Incompatible Changes

Public class PdfDigitalSignatureAppearance was updated with new property that allows to specify foreground color of Digital Signature appearance on Pdf document page

Public class PdfDigitalSignatureAppearance was updated with propery

• property Color [Foreground] that allows to specify foreground text color of signature labels.

New properties of PdfDigitalSignatureAppearance class

    public class PdfDigitalSignatureAppearance
    {
        /// <summary>
        /// Get or set foreground text color of signature appearance.
        /// By default the value is Color.FromArgb(76, 100, 255)
        /// </summary>
        public Color Foreground { get; set; }
   }

Public class BarcodeTypes was updated with new static BarcodeType property that describes postal barcode Mailmark

This property defines support of new postal barcode Mailmark.

New static property

    
    public static class BarcodeTypes
    {
        ...
        /// <summary>
        /// Royal Mail 2D Mailmark Barcode Type object.
        /// </summary>
        public static readonly BarcodeType Mailmark;
        ...
    }
}

Public enum SpreadsheetSaveFileFormat was updated with new supported save format types like Emf, Jpg and Png

Newly added format types SpreadsheetSaveFileFormat.Emf, SpreadsheetSaveFileFormat.Jpg and SpreadsheetSaveFileFormat.Png allow to save signed document to rquired format.

New enumeration values

    
    public enum SpreadsheetSaveFileFormat
    {
        ...
        /// <summary>Saves the document in Windows Enhanced Metafile format.</summary>
        Emf = 31,

        /// <summary>Saves the document in Jpeg format.</summary>
        Jpg = 33,

        /// <summary>Saves the document in Portable Network Graphics format.</summary>
        Png = 34
    }
}

Public class ImageSignOption was extended with static method to create ImageSignOptions instance from base64 image string content and updated to implement IDisposable interface

The ImageSignOptions class implements IDisposable interface and contains static method FromBase64(string base64Content) to create ImageSignOptions from base64 string

Public class ImageSignOption

    
    public class ImageSignOptions : SignOptions, IRectangle, IAlignment, IRotation, ITransparency, IDisposable
    {
        /// <summary>
        /// Creates a new instance of the ImageSignOptions class with predefined Image from Base64.
        /// </summary>
        /// <param name="base64Content"></param>
        /// <returns></returns>
        public static ImageSignOptions FromBase64(string base64Content);
    }
}

Following example demonstrates how to create ImageSignOptions from base64 string.

Create Image signature from base64 string

public static void Run()
{
    using (Stream source = new FileStream("sample.pdf", FileMode.Open, FileAccess.Read))
    {
        using (Stream destin = new MemoryStream())
        {
            using (Signature.Signature signature = new Signature.Signature(source))
            {
                string base64Content = @"iVBORw0KGgoAAAANSUhEUg....AAAPoAAACSCAYAAABsS9cKAAAAGXRF";
                using (ImageSignOptions options = ImageSignOptions.FromBase64(base64Content))
                {
                    options.Left = 100;
                    options.Top = 100;
                    SignResult result = signature.Sign(destin, options);
                }
            }
        }
    }
}