{"id":68394,"date":"2022-11-05T09:02:27","date_gmt":"2022-11-05T09:02:27","guid":{"rendered":"https:\/\/www.cryptocabaret.com\/?p=68394"},"modified":"2022-11-05T09:02:27","modified_gmt":"2022-11-05T09:02:27","slug":"fix-scanned-images-with-imagemagick","status":"publish","type":"post","link":"https:\/\/www.cryptocabaret.com\/?p=68394","title":{"rendered":"Fix scanned images with ImageMagick"},"content":{"rendered":"

Fix scanned images with ImageMagick<\/span>
\nSeth Kenlon<\/a><\/span>
\nSat, 11\/05\/2022 – 03:00<\/span><\/p>\n

\n

Years ago while rummaging through the contents of a shelf in a used bookstore, I happened upon a booklet titled “UNIX System Command Summary for Berkeley 4.2 & 4.3 BSD,” published by\u00a0Specialized Systems Consultants. I bought it as a curiosity item because it was nearly 20 years old yet still largely applicable to modern Linux and BSD.<\/p>\n

That amused me then and now. A booklet written in 1986 was still largely relevant in 2016, while books on the same shelf about a proprietary OS weren’t worth the paper they were printed on. (Think about it: What technology do\u00a0you<\/em>\u00a0think is going to survive a zombie apocalypse?) I’ve had the booklet on my own bookshelf for several years now, but it occurred to me that it’s probably worth doing a little digital preservation of this artifact, so I decided to scan the booklet to create a\u00a0CBZ ebook<\/a>.<\/p>\n

Scanning was easy, albeit time-consuming, with\u00a0Skanlite<\/a>. After I was finished, however, I discovered that some pages weren’t quite level.<\/p>\n

\n
\"A<\/div>\n
Image by: <\/span><\/p>\n

(Seth Kenlon, CC BY-SA 4.0)<\/p>\n<\/div>\n<\/article>\n

In printing, this is called a registration problem, meaning that the position of what’s being printed isn’t correctly orientated on the page.<\/p>\n<\/p>\n

\n
More open source alternatives<\/div>\n
\n
Open source project management tools<\/a><\/div>\n
Trello alternatives<\/a><\/div>\n
Linux video editors<\/a><\/div>\n
Open source alternatives to Photoshop<\/a><\/div>\n
List of open source alternatives<\/a><\/div>\n
Latest articles about open source alternatives<\/a><\/div>\n<\/p><\/div>\n<\/p><\/div>\n

ImageMagick<\/h2>\n

ImageMagick<\/a>\u00a0is a non-interactive terminal-based graphics editor. It might seem counterintuitive to try to edit a graphic in a graphic-less environment like a text-only terminal, but it’s actually very common. For instance, when you upload an image to use as a profile picture to a web application, it’s likely that a script on the application’s server processes your image using ImageMagick or its libraries. The advantage of a non-interactive editor is that you can formulate what needs to be done to a sample image, then apply those effects to hundreds of other images at the press of a button.<\/p>\n

ImageMagick is generally just as capable as any graphics editor, as long as you take the time to uncover its many functions and how to combine them to achieve the desired effects. In this case, I want to rotate pages that are askew. After searching through ImageMagick’s documentation, I discovered that the ImageMagick term for the solution I needed was called deskew. Aligning your terminology with somebody else’s terminology is a challenge in anything that you don’t already know, so when you approach ImageMagick (or anything), keep in mind that the word\u00a0you’ve<\/em>\u00a0decided describes a problem or solution may not be the same word used by someone else.<\/p>\n

To deskew an image with crooked text using ImageMagick:<\/p>\n

\n$ <\/span>convert page_0052.webp -deskew<\/span> 25<\/span>%<\/span> fix_0052.webp<\/code><\/span><\/pre>\n
The\u00a0-deskew<\/code>\u00a0option represents the threshold of acceptable skew. A skew is determined by tracing peaks and valleys of objects that appear to be letters. Depending on how crooked your scan is, you may need more or less than 25% threshold. I’ve gone as high as 80%, and so far nothing under 25% has had an effect.<\/p>\n
Here’s the result:<\/p>\n
\n
  \"The<\/div>\n
Image by: <\/span><\/p>\n
(Seth Kenlon, CC BY-SA 4.0)<\/p>\n<\/div>\n<\/article>\n
Fixed! Applying this to the remaining 55 pages of the document fixed skewed pages while doing nothing to pages that were already straight. In other words, it was safe to run this command on pages that needed no adjustment, thanks to my threshold setting.<\/p>\n
Cropping an image with ImageMagick<\/h2>\n
After correcting for a skew, and because I scanned more of each page than necessary anyway to prevent accidentally cutting off words, I decided that it made sense to crop my corrected pages. I was happy to keep some space around the margins, but not quite as much as I had. I use the\u00a0crop<\/code>\u00a0function of ImageMagick often enough for images on this very website, so I was familiar with the option. However, I needed to determine how to crop each page.<\/p>\n
First, I needed the size of the image:<\/p>\n
\n
$ identify fixed_0052.webp
\nWEBP 1128x2593 1128x2593+0<\/span>+0<\/span> 8<\/span>-bit sRGB 114732B 0.020u 0<\/span>:00.021<\/span><\/div><\/div><\/pre>\n
Knowing the size, I was able to make some estimations about how many pixels I could stand to lose. After a few trial runs, I came up with this:<\/p>\n
\nconvert fix_0052.webp -gravity<\/span> Center -crop<\/span> 950x2450+0<\/span>+0<\/span> crop_0052.webp<\/code><\/span><\/pre>\n
This isn’t an exact fit, but it proved important when I applied it to other images in the booklet. The pages varied in content and scanner placement here and there, so I was happy to give each one a little breathing room.<\/p>\n
Here’s the corrected and cropped image:<\/p>\n
\n
  \"The<\/div>\n
Image by: <\/span><\/p>\n
(Seth Kenlon, CC BY-SA 4.0)<\/p>\n<\/div>\n<\/article>\n
Batch image editing with open source<\/h2>\n
The beauty of ImageMagick is that once you’ve figured out the formula for fixing your image, you can apply that fix to\u00a0all\u00a0images requiring the same fix. I do this with\u00a0GNU Parallel<\/a>, which uses all my CPU cores to finish image correction across hundreds of pages. It doesn’t take long, and the results speak for themselves. More importantly, I’ve got a digital archive of a fun artifact of UNIX history.<\/p>\n<\/div>\n
\n
It’s easy to correct images, even in batches, with this open source tool.<\/p>\n<\/div>\n
\n
\n
  \"Woman<\/div>\n
Image by: <\/span><\/p>\n
Ray Smith <\/p>\n<\/div>\n<\/article>\n<\/div>\n
\n
Tools<\/a><\/div>\n
Art and design<\/a><\/div>\n<\/p><\/div>\n
What to read next<\/div>\n

\n        \"Creative<\/a>This work is licensed under a Creative Commons Attribution-Share Alike 4.0 International License.<\/div>\n
\n
\n
5014 points<\/a><\/p>\n
\n
\n
\n
  \"photo<\/div>\n<\/article>\n<\/div>\n
Minnesota<\/div>\n
\n
Jim Hall is an open source software advocate and developer, best known for usability testing in GNOME<\/a> and as the founder + project coordinator of FreeDOS<\/a>. At work, Jim is CEO of Hallmentum<\/a>, an IT executive consulting company that provides hands-on IT Leadership training, workshops, and coaching.<\/p>\n<\/div>\n
| Follow jimfhall<\/div>\n
| Connect  jimfhall<\/div>\n
\n
User Attributes<\/div>\n
\n
Correspondent<\/a><\/div>\n<\/p><\/div>\n<\/p><\/div>\n<\/p><\/div>\n
\n
  Open Sourcerer<\/a><\/p>\n
  People’s Choice Award<\/a><\/p>\n
  People’s Choice Award 2018<\/a><\/p>\n
  Author<\/a><\/p>\n
  Correspondent<\/a><\/p>\n
  Contributor Club<\/a><\/p>\n<\/div>\n<\/article>\n<\/div><\/div>\n
\n
\n
Register<\/a> or Login<\/a> to post a comment.<\/div>\n<\/p><\/div>\n<\/section>\n
Powered by WPeMatico<\/a><\/small><\/p>\n","protected":false},"excerpt":{"rendered":"
Fix scanned images with ImageMagick Seth Kenlon Sat, 11\/05\/2022 – 03:00 Years ago while rummaging through the contents of a shelf in a used bookstore, I happened upon a booklet titled “UNIX System Command Summary for Berkeley 4.2 & 4.3 BSD,” published by\u00a0Specialized Systems Consultants. I bought it as a curiosity item because it was […]<\/p>\n","protected":false},"author":1,"featured_media":68395,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[307],"tags":[],"class_list":["post-68394","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-open-source"],"_links":{"self":[{"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=\/wp\/v2\/posts\/68394","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=68394"}],"version-history":[{"count":0,"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=\/wp\/v2\/posts\/68394\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=\/wp\/v2\/media\/68395"}],"wp:attachment":[{"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=68394"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=68394"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.cryptocabaret.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=68394"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}