Search for Image e-Signatures Leave feedback
GroupDocs.Signature provides the ability to search for image electronic signatures in documents. Image signatures allow you to add visual elements like logos, stamps, or handwritten signatures to your documents.
An image signature is a graphical element that can be added to a document to represent a signature. It can be:
- A scanned handwritten signature
- A company logo
- A stamp or seal
- Any other graphical element used for signing
The Signature class provides the search method which allows you to search for image signatures in documents. Here’s how to use it:
- Create a new instance of the Signature class and pass the source document path as a parameter.
- Create an instance of ImageSearchOptions class.
- Call the search method of the Signature class instance and pass a list with the search options to it.
- Process the search results: the
signaturesproperty of the returned SearchResult holds the found ImageSignature objects.
Here’s an example of how to search for image signatures in a document:
from groupdocs.signature import Signature
from groupdocs.signature.options import ImageSearchOptions
def search_images():
with Signature("signed.pdf") as signature:
result = signature.search([ImageSearchOptions()])
print(f"Found {len(result.signatures)} image signature(s)")
for image in result.signatures:
print(f"Page {image.page_number}: {image.size} bytes at ({image.left}, {image.top}), "
f"size {image.width}x{image.height}")
if __name__ == "__main__":
search_images()
signed.pdf is the sample file used in this example. Click here to download it.
Found 1 image signature(s)
Page 1: 14552 bytes at (50, 415), size 150x50
You can customize the search process with the properties of ImageSearchOptions:
min_content_sizeandmax_content_sizelimit the size of the image data, in bytes;return_contentreturns the image data in thecontentproperty of each found signature, andreturn_content_typeconverts it to the given FileType;all_pagesandpage_numbersearch a single page instead of the whole document (page numbers start at 1).
This example saves every image signature found on the first page to a PNG file:
from groupdocs.signature import Signature
from groupdocs.signature.domain import FileType
from groupdocs.signature.options import ImageSearchOptions
def extract_image_signatures():
with Signature("signed.pdf") as signature:
options = ImageSearchOptions()
# Search the first page only
options.all_pages = False
options.page_number = 1
# Skip images smaller than 1 KB
options.min_content_size = 1024
# Return the image data as PNG
options.return_content = True
options.return_content_type = FileType.PNG
result = signature.search([options])
print(f"Found {len(result.signatures)} matching image signature(s)")
for number, image in enumerate(result.signatures, start=1):
file_name = f"image_signature_{number}.png"
with open(file_name, "wb") as output:
output.write(image.content)
print(f"Saved {file_name} ({len(image.content)} bytes)")
if __name__ == "__main__":
extract_image_signatures()
signed.pdf is the sample file used in this example. Click here to download it.
Binary file (PNG, 14 KB)
You may easily run the code above and see the feature in action in our GitHub examples:
Along with the full-featured Python library, we provide simple but powerful free online apps.
To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the GroupDocs.Signature App Product Family.
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.
