V2: Stamping Data Onto Images

 

About

 

ProntoForms allows you to configure the Image and Sketch Pad tools to stamp data directly onto images in a form submission. This can provide additional context for the image: common uses include stamping the date/time an image was taken onto the image, or adding a label to the image.

Data stamping happens in the background when the form is submitted, meaning it is not visible to the mobile user, nor is the mobile user required to complete any extra steps before sending the form. Data stamping will also increase the file size of images by a small amount.

[ top ]

 

Before Using This Feature

As images/sketches can vary in size/quality between devices and settings, you should consider the following points before using data stamping:

  • When choosing a font color, consider what images your mobile users are normally using/photographing, and choose a color that contrasts.
  • When choosing a font size, ensure that the stamped data (whether a date/time, geolocation, or DREL expression) will fit on the image. Any stamped data will not continue onto the next line if it reaches the edge of the image; it will be cut off.
  • The size that the stamped text appears on the images in your data record documents depends on the size and resolution of the original images. On the default Form Builder setting of Small file (lower quality), a font size of 40 may take up half the image. On larger files, 40-point font may be too small to read.
    • Setting the picture quality will standardize the size of the image. As follows:
      • Small file (lower quality): maximum of 640px on the longest side.
      • Average quality and file size: maximum of 1024px on the longest side.
      • High quality (Larger file): maximum of 4032px on the longest side.
      • Use device settings: Uses the setting from the app (Small, Medium, Original, or Custom).

[ top ]

 

Setting up Data Stamping

This feature is available on Image or Sketch Pad questions in the Form Builder.  Toggling on Stamp Data on Images in the Properties tab will open the configuration menu:

2019-01-25-FB-StampData01.png

Font and Positioning Options

These settings allow you to adjust your font choices and positioning to best show up on images generated by your mobile users.

2019-01-25-FB-StampData02.png

Font options:

  • Serif, Sans Serif, Monospaced. 
  • Size slider: 8-40 point.
  • Color: Choose from preset colors, or enter the hex code of a custom color.
    • Choose a color that will contrast with the most common images or photographs your mobile users will be taking.
  • Bold or Italic.

Position:

  • Top Left, Top Right, Bottom Left, Bottom Right.
  • X / Y Offset: Add space between the edge of the image and your text using X,Y coordinates.

[ top ]

 

Stamped Text Options

This section allows you to select what data is stamped on images. 

Image Properties

Stamping this data on images draws from image metadata captured by the camera, rather than by ProntoForms. They use EXIF data.

2019-01-25-FB-StampData05.png

  • Date: This will stamp the image with the date/time the photo was taken; useful for forms requiring more strict compliance with date/time information.
  • Geo Location: This will stamp the image with the location the photo was taken in.

If you do not have EXIF data enabled on your camera, or your camera does not use EXIF data, these stamp properties will not work. ProntoForms recommends testing the form on the type of device most commonly used in the field before deploying the form for use in production.

2019-01-25-AND-StampData07.png

[ top ]

 

System Properties

This data comes from information collected by the ProntoForms app. Selecting any of the following properties will stamp information/metadata from the form onto the image:

2019-01-25-FB-StampData06.png

  • Reference Number: The ProntoForms system's unique identifier for a form submission.
  • Geo Stamp: A location stamp taken when the form is submitted.
  • FormSpace Name: Which FormSpace the form and its submissions belongs to.
  • Submitter Name: The username and name of the person submitting the form.
  • Entry Timestamp: The date/time when the form was submitted. Equivalent to %d in Data Record Expression Language (DREL).
  • Form Name: The name of the form. 
  • Custom Expression: The user-supplied answer to specified questions in the form can also be stamped onto the image. Use DREL and static text in the Custom Expression box to reference the desired answer or form metadata. For example:
    • %a[Location] will stamp the answer to a question with the unique ID "Location" onto the photo.
    • %u[name] on %d will stamp the image with a string like, "Jane Smith on 2019-01-28".

The example below uses:

  • Form Submission Reference Number
  • Submitter Name
  • Custom Expression: %d-%f
  • (Image Properties): Geo Location

2019-01-28-AND-StampData08.png

[ top ]

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

  • Avatar
    Paul Lawson

    I don't see the EXIF data (Geo-stamping) currently working for my device (Samsung S8). I have a help ticket open for this issue currently and have verified that yes, the Samsung camera does have EXIF data enabled and accessible when the photo is not taken via the app.

    Also, the EXIF data is still not accessible when the photo is selected from gallery.