find_chessboard_corners.hh

#pragma once

#include <vector>
#include <opencv2/core/core.hpp>
#include "point.hh"


namespace mrgingham
{

// these all output the points scaled by FIND_GRID_SCALE in points[].
bool find_chessboard_corners_from_image_array( // out

                                               // integers scaled up by
                                               // FIND_GRID_SCALE to get more
                                               // resolution
                                               std::vector<mrgingham::PointInt>* points_scaled_out,

                                               // in
                                               const cv::Mat& image_input,

                                               // set to 0 to just use the
                                               // image. Values > 0 cut down the
                                               // image by a factor of 2 that
                                               // many times. So for example,
                                               // level==2 means each dimension
                                               // is cut down by a factor of 4
                                               int image_pyramid_level,
                                               bool debug = false,
                                               const char* debug_image_filename = NULL);

bool find_chessboard_corners_from_image_file( // out

                                              // integers scaled up by
                                              // FIND_GRID_SCALE to get more
                                              // resolution
                                              std::vector<mrgingham::PointInt>* points,

                                              // in
                                              const char* filename,

                                              // set to 0 to just use the
                                              // image. Values > 0 cut down the
                                              // image by a factor of 2 that
                                              // many times. So for example,
                                              // level==2 means each dimension
                                              // is cut down by a factor of 4
                                              int image_pyramid_level,
                                              bool debug = false);

int refine_chessboard_corners_from_image_array( // out/int

                                                // initial coordinates on input,
                                                // refined coordinates on output
                                                std::vector<mrgingham::PointDouble>* points,

                                                // level[ipoint] is the
                                                // decimation level used to
                                                // compute that point.
                                                // if(level[ipoint] ==
                                                // image_pyramid_level+1) then
                                                // that point could be refined.
                                                // If I successfully refine a
                                                // point, I update level[ipoint]
                                                signed char* level,

                                                // in
                                                const cv::Mat& image_input,

                                                int image_pyramid_level,
                                                bool debug = false,
                                                const char* debug_image_filename = NULL);

};