/*
* Copyright (C) 2018 dimercur
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see .
*/
#ifndef __IMG_H__
#define __IMG_H__
#include
#include
#include
#include
#include
#include
#ifdef __WITH_ARUCO__
#include
#include
#include
#endif // __WITH_ARUCO__
#define ARENA_NOT_DETECTED -1
using namespace std;
/**
* Redefinition of cv::Mat type
*/
typedef cv::Mat ImageMat;
/**
* Declaration of Jpg type
*/
typedef vector Jpg;
/**
* Position type used for store robot coordinates
*
* @brief Position type used for store robot coordinates
*/
typedef struct {
cv::Point2f center;
cv::Point2f direction;
float angle;
int robotId;
} Position;
/**
* Class arena, used for holding outline of arena on image and cropping image to only usefull area
*
* @brief Class arena, used for holding outline of arena on image and cropping image to only usefull area
*/
class Arena {
public:
/**
* Constructor of Arena object
*/
Arena() {}
/**
* Coordinate of arena, empty if no arena found
*/
cv::Rect arena;
/**
* Tell if arena is empty (not found) or not
* @return true if no arena found, false otherwise
*/
bool IsEmpty();
};
/**
* Class for image storage and treatment
*
* @brief Class for image storage and treatment
*/
class Img {
public:
/**
* Image data
*/
ImageMat img;
/**
* Create new Img object based on image data
*
* @param imgMatrice Image data to be stored (raw data)
*/
Img(ImageMat imgMatrice);
/**
* Convert object to a string representation
*
* @return String containing information on contained image (size and number of channel)
*/
string ToString();
/**
* Create a copy of current object
*
* @return New Img object, copy of current
*/
Img* Copy();
/**
* Compress current image to JPEG
* @return Image compressed as JPEG
*/
Jpg ToJpg();
/**
* Search arena outline in current image
* @return Arena object with coordinate of outline, empty if no arena found
*/
Arena SearchArena();
/**
* Draw an oriented arrow at robot position
* @param robot Position of robot
*/
void DrawRobot(Position robot);
/**
* Draw an oriented arrow for each position provided
* @param robots List of robot positions
* @return Number of position drawn
*/
int DrawAllRobots(std::list robots);
/**
* Draw arena outline
* @param arenaToDraw Arena position
*/
void DrawArena(Arena arenaToDraw);
/**
* Search available robots in an image
* @param arena Arena position for cropping image
* @return list of position, empty if no robot found
*/
std::list SearchRobot(Arena arena);
#ifdef __WITH_ARUCO__
/**
* Dictionary to be used for aruco recognition
*/
cv::Ptr dictionary;
#endif // __WITH_ARUCO__
private:
#ifdef __WITH_ARUCO__
/**
* Find center point of given aruco
* @param aruco Aruco coordinates
* @return Center point coordinate
*/
cv::Point2f FindArucoCenter(std::vector aruco);
/**
* Find direction of given aruco
* @param aruco Aruco coordinates
* @return Orientation of aruco
*/
cv::Point2f FindArucoDirection(std::vector aruco);
#endif // __WITH_ARUCO__
/**
* Function for computing angle
* @param robots Position of robot
* @return Angle
*/
float CalculAngle(Position robots);
/**
* Function for computing angle
* @param pt1 ???
* @param pt2 ???
* @return Angle
*/
float CalculAngle2(cv::Point2f pt1, cv::Point2f pt2);
/**
* Used for computing distance
* @param p ???
* @param q ???
* @return Distance
*/
float EuclideanDistance(cv::Point2f p, cv::Point2f q);
/**
* Crop image around detected arena
* @param arena Coordinate of arena
* @return Reduced image, focused on arena
*/
ImageMat CropArena(Arena arena);
};
#endif //__IMG_H__