NAME

       mrgingham-rotate-corners - Adjust mrgingham corner detections from rotated cameras

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

       The mrgingham chessboard detector finds a chessboard in an image, but it has no way to know whether the
       detected chessboard was upside-down or otherwise rotated: the chessboard itself has no detectable marking
       to make this clear. In the usual case, the cameras as all mounted in the same orientation, so they all
       detect the same orientation of the chessboard, and there is no problem. However, if some cameras are
       mounted sideways or upside-down, the sequence of corners will correspond to different corners between the
       cameras with different orientations. This can be addressed by this tool. This tool ingests mrgingham
       detections, and outputs them after correcting the chessboard observations produced by rotated cameras.

       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.

REPOSITORY

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

AUTHOR

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

LICENSE AND COPYRIGHT

       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")

mrgingham 1.26                                     2025-03-19                                       MRGINGHAM(1)