Voussoir, for Semi-Automated De-keystoning and Cropping of Images
Posted: 15 Apr 2017, 22:32
As part of the "Impost" scanner project, I have been working to document and add to "bookscan," a piece of software written in one day in 2012 by Yutaka Tsutano. I have added a full command-line interface and documentation to the program, and have renamed the fork "Voussoir". It should work across platforms, and can run separate from the scanning process or be built into it, depending on whether one's camera can directly deposit images into a directory that a provided example script is watching.
Voussoir looks at images and recognizes special "Glyphs", similar to QR Codes, that are in the image. The user affixes these glyphs at the corners (or at any fixed locations along the perimeter) of the book or platen before scanning and then informs Voussoir of the dimensions of the book (Really, the user informs Voussoir of the dimensions of space between the markers). With these pieces of information, Voussoir can recognize the book's pages and digitally separate, crop, and de-keystone them, making it look as though each page were photographed face-on.
Example output from the program is included in the "Impost" scanner thread.
Voussoir's source code and marker glyphs are available under a permissive license on GitHub. The GitHub repository also contains example scripts for (a) watching a folder for auto-processing images, and (b) invoking the program with several of its features.
I've been adding to this program in what feels like a primarily custodial way; I would be happy to collaborate on additional contributions to it!
Voussoir looks at images and recognizes special "Glyphs", similar to QR Codes, that are in the image. The user affixes these glyphs at the corners (or at any fixed locations along the perimeter) of the book or platen before scanning and then informs Voussoir of the dimensions of the book (Really, the user informs Voussoir of the dimensions of space between the markers). With these pieces of information, Voussoir can recognize the book's pages and digitally separate, crop, and de-keystone them, making it look as though each page were photographed face-on.
Example output from the program is included in the "Impost" scanner thread.
Voussoir's source code and marker glyphs are available under a permissive license on GitHub. The GitHub repository also contains example scripts for (a) watching a folder for auto-processing images, and (b) invoking the program with several of its features.
I've been adding to this program in what feels like a primarily custodial way; I would be happy to collaborate on additional contributions to it!