PMGS StampFix

Resources

PMGS StampFix is a Java app that takes scans of stamps, rotates them, then crops them.

pmgssf_demo_07

Compatibility:

  • Windows 7+
  • MAC OSX 10.9+
  • Linux (coming soon)

Downloads:

As new features have been added to the app, the memory requirements to run it have increased dramatically. For this reason, users on computers without a lot of RAM may have difficulty running newer versions of the app. If the app is not processing images correctly for you, consider reverting to a previous version to see if it helps. You will lose some of the newer functionality, but you should still be able to do basic processing with earlier versions.

Version 1.08 is the basic app. it will do single and batch processing of images on a black background.

Version 1.09 is 1.08 with a few bug fixes, and limited ability to process diamond- and triangle-shaped stamps. It should have roughly the same memory requirements.

Version 1.10 adds the ability to process images on a white background. It has increased memory requirements.

Version 1.11 adds the ability to extract multiple stamps from a single scan, then process them individually. It has high memory requirements.

  • Light package (no Java Runtime Environment bundled with the app — for use only if you already have JRE installed)

Installation:

  • Windows — Double-click the .exe file to install.
  • Mac OSX — Double-click the .dmg file to install.

Uninstalling:

  • Windows — Uninstaller should be installed alongside the application, or use Add/Remove Programs in the Control Panel.
  • Mac OSX — You can’t drag the app from the Launchpad to the Trash since the app is not from the App Store.  Instead, go to Finder/Applications, and drag the app to the Trash from there.

Setting User Defaults:

Before using the program, it’s best to set your user default settings.  This is done in three places.

Set your File/Folder Chooser default folder.  When you click the buttons which allow you to select a file or folder, your operating system displays the file/folder chooser.  PMGS StampFix allows you to control which folder is displayed as a default when you open the file/folder chooser.  To set this default, select Interface Settings from the Settings menu.

pmgssf_demo_01
pmgssf_demo_02
There are three options for default file/folder chooser behavior.

  • Open to OS Default Folder
    • In Windows, the file/folder chooser will always open to the user’s Home folder.
    • In Mac OSX, the file/folder chooser will always open to the last folder the user had open.
  • Open to user Default Folder
    • The file/folder chooser will always open to the user default.  The user default can be seen in the white text box, and can be changed by clicking the button with a folder on it.
  • Open to Last Folder
    • The file/folder chooser will always open to the last folder the user had open.  This option has no effect on a Mac, since the default Mac behavior is already to open to the last opened folder.

Set Your Thresholds

To set the thresholds, go to Settings, Threshold Settings.  The threshold settings are the key to the accuracy of the rotation and cropping, but they vary based upon the background that you’re using.  For this reason, you have the option of manually changing these settings.

The White threshold setting is used when you are scanning with a white background, and the Black setting is used when you are scanning with a black background.  The settings, will vary, however, based on whether you are scanning a white or black stamp.

In general, the following settings should be close to correct:

  • White stamp on a white background — White 240
  • White stamp on a black background — Black 100
  • Black stamp on a white background — White 100
  • Black stamp on a black background — Black 35

These may vary significantly based on the shade of white/black that you are using as a background (for example, a white scanner lid will typically require White ~240, while white printer paper may require White ~215).

You will need to play with these settings to find the correct one for your setup.  Once you find it, though, it shouldn’t need to be changed unless you vary your background.

For a demo, see the video below:

 

pmgssf_demo_08
Set your Image Processing defaults.
  Click on the Image button (purple wrench icon).  The image processing options are:

  • Resizing option — this controls whether the image is resized upon saving.  Options are:
    • None — no resizing
    • Percentage — resize to a percentage of original size
    • Max H — resize to a set height in pixels
    • Max W — resize to a set width in pixels
    • Longest side — resize to a set height/width, depending on orientation (tall stamps will be resized based on height and wide stamps based on width)
  • Resizing size — controls the percentage or maximum height/width in pixels
  • Initial Rotation Adj. — controls rotation adjustment before the image is processed.  This setting is useful if the stamp is wildly out of alignment in the raw scan.  Recommended default is “0”.  See example below where the stamp was rotated 180° prior to processing so that the end product was correctly oriented.

pmgssf_demo_09

  • Final Rotation Adj. — controls rotation adjustment after the image is processed.  This setting allows you to fine-tune the rotation of an image.  Recommended default is “0”.
  • Padding — controls padding between the edges of the stamp and the edge of the cropped image

pmgssf_demo_04

Set your Batch processing defaults.  Click on the Batch button (orange wrench icon).  The batch processing options are:

  • Prefix — set a filename prefix for use during batch processing. The prefix will be prepended before the existing filename.
  • Suffix — set a filename suffix for use during batch processing.  The suffix will be appended after the existing filename, but before the filename extension (ex. image.jpg becomes image_fixed.jpg).
  • Filename Extension — if set to Source, the filetype will remain the same.  If not, the file will be converted to the specified filetype during batch processing.  Supported filetypes are .jpg, .jpeg, .png, .tiff, and .bmp.
  • Use Target Folder — if this box is checked, the batch process will save the resulting images to the selected folder.  The user default folder is displayed in the white text box, and can be changed using the button with a folder on it.  If the box is left unchecked, the batch processed images will output to the source folder.

WARNING: If the Prefix & Suffix are left blank and Use Target Folder is not selected, the original image will be overwritten during batch processing.

When done setting defaults, select Save Default Settings from the Settings menu.  To later reload your default settings, select Load Default Settings from the Settings menu.

Demo of the Basic App Functions:

Using the App:

To process a single image, click the Load button and select your image.  The adjusted image will appear to the right of the original.  To fine-tune the rotation or padding, edit those options on the Image settings toolbar and click the Reprocess button.

To save the image, click the Save button.

To batch process an entire folder of images, click the Batch Folder button and select the folder of images.  While processing, a progress bar at lower right will show the progress.  Upon completion a popup will show the results.

pmgssf_demo_05
If any images were unable to be processed for whatever reason, a summary of which images were skipped will also be included.  (Some images cause errors when the algorithm is unable to find the edges of the stamp.)

pmgssf_demo_06Tips:

For best results, the stamps need to be on a clean background.  The software works by identifying the edges, so debris in the background will throw off the calculations and lead to inconsistent results.

Batch Processing from a Single Scan:

Beginning with v1.11, the app is able to extract multiple stamp images from a single scan, then rotate/crop the individual stamps and save them. This process is complicated, so rather than attempt to type a summary of the steps, here’s a demo video of the Batch Image process.

Price:

The app is free to download and use. There was significant cost in creating the app, so it you’d like to make a donation, feel free.