Decapod Stereo 3D Dewarp Guide

Table of Contents

What is Dewarp?

Dewarp is the process of taking a set of stereo images and its camera calibration data to produce a flattened version of the content.

This documentation applies to Decapod 0.7.

Example Input Stereo 3D Pair:

An example input image to dewarp - an image of an open book as captured by the left camera of a stereo pair. An example input image to dewarp - an image of an open book as captured by the right camera of a stereo pair.

Example Dewarp Output:

An example dewarp output - the left page of the book is separated and dewarped. An example dewarp output - the right page of the book is separated and dewarped.

How to Dewarp Stero 3D Captures

  1. Create a ZIP file containing properly named stereo images (see "Note" below). If the stereo images were captured using Decapod’s Capture tool, the images should already be in a ZIP file called “”.
  2. Locate the ZIP file containing the stereo images that are to be dewarped.
  3. Locate calibration data generated by the Stereo 3D Calibration tool. The filename should be called "".
  4. Specify the page seperator and background colour. (For more information, see "Page Seperator and Background Colour Picker" below).
  5. Select "Dewarp" to begin the dewarp process.
  6. When prompted, save the dewarped file to a safe location.


Stereo 3D images should follow a required file naming pattern before being ZIP'ed. Refer to Decapod Stereo 3D Capture Guide on how this is done.

Page Seperator and Background Colour Picker

To properly split the left and right pages, and to remove the background, the user must specify the background and page seperator colour using the colour picker. The colour picker is launched by selecting the "Pick Colour" button.

  1. When the Pick Colour window loads, there will be an image shown.
  2. The first mouse click will choose the page seperator colour. Do this by positioning the mouse pointer over the seperator and click once.
  3. The second mouse click will choose the background colour. Do this by clicking the dominant background colour.
  4. The Pick Colour window will then close.
  5. Dewarp can begin by selecting the Dewarp button.

How Long Does Dewarp Take?

The dewarping process can take a long time. On a modern Intel i7 8-core system with 16GB of RAM, dewarping can take anywhere from 25 minutes to 1 hour per page spread.

What if Dewarp Fails?

It is possible that dewarping process fails and no useful output is delivered at the end. Some possible solutions to try:

  • Is the environment well lit? The content and the background should be evenly lit with little glare or hard shadows.
  • Try choosing the colour separator and background colour again using the Colour Picker.
  • Is there sufficient disk space?