MRGINGHAM(1)

📦
version 1.27 · 6 versions
, in ubuntu stonking

✨ NAME ✨

mrgingham-rotate-corners — bestie, this is the lil tool that fixes up your mrgingham corner detections when some of your cameras are literally sideways 💅

📸 SYNOPSIS 📸

  # camera A is rightside-up
  # camera B is mounted sideways
  # cameras C,D are upside-down
  mrgingham --gridn N                \
    'frame.*-cameraA.jpg'            \
    'frame.*-cameraB.jpg'            \
    'frame.*-cameraC.jpg'            \
    'frame.*-cameraD.jpg' |          \
  mrgingham-rotate-corners --gridn N \
    --90 cameraB --180 'camera[CD]'

🎀 DESCRIPTION 🎀

ok so picture this: the mrgingham chessboard detector finds a chessboard in an image, slay, iconic, no notes 💖 but it has absolutely zero way of knowing whether that chessboard it found was upside-down or rotated some other way. and honestly? not its fault. the chessboard itself has no detectable marking to make this clear. like there's just no way to tell 🙈

in the normal, chill, unproblematic case, all the cameras are mounted in the same orientation, so they all detect the same orientation of the chessboard, and everything is fine and nothing is a problem ✨ but the SECOND some of your cameras are mounted sideways or upside-down, it's over — the sequence of corners will correspond to different corners between the cameras with different orientations. it's giving chaos 😭

and that's exactly what this tool is here for, bestie. this tool ingests mrgingham detections, and outputs them after correcting the chessboard observations produced by rotated cameras. periodt. 👑

each rotation option is an awk regular expression used to select images from specific cameras. the regular expression is tested against the image filenames. each rotation option may be given multiple times. any files not matched by any rotation option are passed through unrotated — no touchy, just vibes 🦋

--gridn defaults to 10, for a 10x10 board.

🌈 REPOSITORY 🌈

<https://github.com/dkogan/mrgingham>

👑 AUTHOR 👑

Dima Kogan, "<dima@secretsauce.net>"

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

Copyright 2017-2018 California Institute of Technology

Copyright 2017-2018 Dima Kogan ("dima@secretsauce.net")

this was mrgingham 1.27, dated 2026-08-16 — tysm for reading, bestie, go fix those sideways cameras 🫶✨
📦 where this page comes from