59 lines
1.7 KiB
C++
59 lines
1.7 KiB
C++
/*
|
|
* Copyright 2016 Nu-book Inc.
|
|
* Copyright 2016 ZXing authors
|
|
*/
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
#pragma once
|
|
|
|
#include "DetectorResult.h"
|
|
#include "PerspectiveTransform.h"
|
|
|
|
namespace ZXing {
|
|
|
|
/**
|
|
* Samples an image for a rectangular matrix of bits of the given dimension. The sampling
|
|
* transformation is determined by the coordinates of 4 points, in the original and transformed
|
|
* image space.
|
|
*
|
|
* The following figure is showing the layout a 'pixel'. The point (0,0) is the upper left corner
|
|
* of the first pixel. (1,1) is its lower right corner.
|
|
*
|
|
* 0 1 ... w
|
|
* 0 #----#-- ... --#
|
|
* | | ... |
|
|
* | | ... |
|
|
* 1 #----# ... --#
|
|
* | | ... |
|
|
*
|
|
* | | ... |
|
|
* h #----#-- ... --#
|
|
*
|
|
* @param image image to sample
|
|
* @param width width of {@link BitMatrix} to sample from image
|
|
* @param height height of {@link BitMatrix} to sample from image
|
|
* @param mod2Pix transforming a module (grid) coordinate into an image (pixel) coordinate
|
|
* @return {@link DetectorResult} representing a grid of points sampled from the image within a region
|
|
* defined by the "src" parameters. Result is empty if transformation is invalid (out of bound access).
|
|
*/
|
|
DetectorResult SampleGrid(const BitMatrix& image, int width, int height, const PerspectiveTransform& mod2Pix);
|
|
|
|
template <typename PointT = PointF>
|
|
Quadrilateral<PointT> Rectangle(int x0, int x1, int y0, int y1, typename PointT::value_t o = 0.5)
|
|
{
|
|
return {PointT{x0 + o, y0 + o}, {x1 + o, y0 + o}, {x1 + o, y1 + o}, {x0 + o, y1 + o}};
|
|
}
|
|
|
|
class ROI
|
|
{
|
|
public:
|
|
int x0, x1, y0, y1;
|
|
PerspectiveTransform mod2Pix;
|
|
};
|
|
|
|
using ROIs = std::vector<ROI>;
|
|
|
|
DetectorResult SampleGrid(const BitMatrix& image, int width, int height, const ROIs& rois);
|
|
|
|
} // ZXing
|