Класс ContourHandler

Класс для создания объектов-обработчиков контуров. Подробнее...

#include <contour_handler.h>

Открытые члены
	ContourHandler (Mat frame, Rect *ROI=nullptr)
	Конструктор этого класса Подробнее...
void	DrawContours (Mat &frame)
	Отрисовывает контура на изображении Подробнее...
std::vector< std::vector< Point2i > >	GetContours ()
	Возвращает найденные контура в виде { { contour_1 }, { contour_2 }, ... , { contour_n } }. Подробнее...
std::vector< Point2f >	GetContinousContours ()
	Возвращает найденные контура в виде { contour_1, contour_2, ... , contour_n }. Подробнее...

Закрытые члены
template<typename T >
std::vector< T >	MakeTwiceThinner (std::vector< T > src)
	Удаляет каждый второй элемент вектора (уменьшает размер в два раза) Подробнее...
template<typename T >
float	CalculateDistance (T point1, T point2)
	Вычисляет расстояние между двумя точками Подробнее...

Закрытые данные
std::vector< std::vector< Point > >	contour_shapes_
	Контуры в виде { { contour_1 }, { contour_2 }, ... , { contour_n } }. Подробнее...
float	minimal_distance_
	Минимальное расстояние между точками контура, при котором "левая" ("первая") точка будет сохранена Подробнее...

Подробное описание

Класс для создания объектов-обработчиков контуров.

Способен найти контура на входном изображении (принимается в конструкторе), отрисовать их, и произвести определенные операции над ними (например, уменьшить размер или плотность точек в контуре

См. определение в файле contour_handler.h строка 22

Конструктор(ы)

ContourHandler()

ContourHandler::ContourHandler	(	Mat	frame,
		Rect *	ROI = nullptr
	)

Конструктор этого класса

Аргументы

frame	Mat-instance изображения, на котором будет выполнен поиск контуров. Изображение может быть в RGB/gray-scale (в первом случае будет сконвертировано внутри)
ROI	регион интереса, на котором будут найдены контуры.

См. определение в файле contour_handler.cpp строка 3

                                                   :
    minimal_distance_{ 5.0f }
{
    Mat prep_frame;
    std::vector<Vec4i> hierarchy = { 0 };
 
    // Проверка на то, был ли послан ROI или нет
    if (ROI != nullptr)
        prep_frame = Mat(frame, *ROI);
    else
        frame.copyTo(prep_frame);
 
    // Проверка на грейскейл
    if (frame.channels() > 2)
        cvtColor(prep_frame, prep_frame, COLOR_BGR2GRAY);
 
    // Имаге процессинг
    GaussianBlur(prep_frame, prep_frame, Size(7, 7), 0);
    threshold(prep_frame, prep_frame, 80, 255, cv::THRESH_BINARY);
    Canny(prep_frame, prep_frame, 64, 192);
    Canny(prep_frame, prep_frame, 64, 192);
 
    // Находим контуры и дополнительно, если ROI не пустой
    // транслируем координаты из координат "ROI-куска" в координаты исходного изображения (аналог contour_shapes_[i][j] += ROI.tl())
    if (ROI != nullptr)
        findContours(prep_frame, contour_shapes_, hierarchy, RETR_EXTERNAL, CHAIN_APPROX_SIMPLE, ROI->tl());
    else
        findContours(prep_frame, contour_shapes_, hierarchy, RETR_EXTERNAL, CHAIN_APPROX_SIMPLE);
}

Методы

CalculateDistance()

template<typename T >

float ContourHandler::CalculateDistance ( T  point1, T  point2  )

private

Вычисляет расстояние между двумя точками

Аргументы

point1	первая точка
point2	вторая точка

Возвращает

Расстояние между точками

См. определение в файле contour_handler.cpp строка 94

{
    return sqrt((point1.x - point2.x) * (point1.x - point2.x) + (point1.y - point2.y) * (point1.y - point2.y));
}

DrawContours()

void ContourHandler::DrawContours

(

Mat &

frame

)

Отрисовывает контура на изображении

Аргументы

frame

адрес изображения, на котором будет отрисованы найденные контура

См. определение в файле contour_handler.cpp строка 33

{
    for (int i = 0; i < contour_shapes_.size(); i++)
    {
        drawContours(frame, contour_shapes_, i, Scalar(255, 0, 0), 6);
    }
}

GetContinousContours()

std::vector< Point2f > ContourHandler::GetContinousContours

(

)

Возвращает найденные контура в виде { contour_1, contour_2, ... , contour_n }.

Фактически выполняет "склеивание" найденных контуров в один вектор

Возвращает

Изображение с нарисованными контурами

См. определение в файле contour_handler.cpp строка 46

{
    std::vector<Point2f> continous_contour_shapes;
 
    // Проходимся по вектору контуров (std::vector<std::vector>>) и проверяем на соответствие условию ниже
    auto extern_itt = contour_shapes_.begin();
    while (extern_itt != contour_shapes_.end())
    {
        std::vector<Point> shape = *extern_itt;
 
        auto intern_itt = shape.begin();
        while (intern_itt != shape.end())
        {
            // То самое условие: минимальная дистанция между точками + размер контура
            if (CalculateDistance(*intern_itt, *(intern_itt + 1)) > minimal_distance_ && (contourArea(*extern_itt) > 100))
            {
                continous_contour_shapes.push_back(*intern_itt);
            }
            intern_itt++;
        }
 
        extern_itt++;
    }
 
    // Ограничиваем длину контуров
    while (continous_contour_shapes.size() > 500)
        continous_contour_shapes = MakeTwiceThinner(continous_contour_shapes);
 
    return continous_contour_shapes;
}

GetContours()

std::vector< std::vector< Point2i > > ContourHandler::GetContours

(

)

Возвращает найденные контура в виде { { contour_1 }, { contour_2 }, ... , { contour_n } }.

Возвращает

Контуры

См. определение в файле contour_handler.cpp строка 41

{
    return contour_shapes_;
}

MakeTwiceThinner()

template<typename T >

std::vector< T > ContourHandler::MakeTwiceThinner ( std::vector< T >  src )

private

Удаляет каждый второй элемент вектора (уменьшает размер в два раза)

Аргументы

src	вектор, который будет "проряжён"

См. определение в файле contour_handler.cpp строка 78

{
    std::vector<T> dst;
 
    auto it = src.begin();
    while (it != src.end() - 1)
    {
        if ((std::distance(src.begin(), it)) % 2 == 0)
            dst.push_back(*(it));
        it++;
    }
 
    return dst;
}

Данные класса

contour_shapes_

std::vector<std::vector<Point> > ContourHandler::contour_shapes_

private

Контуры в виде { { contour_1 }, { contour_2 }, ... , { contour_n } }.

См. определение в файле contour_handler.h строка 69

minimal_distance_

float ContourHandler::minimal_distance_

private

Минимальное расстояние между точками контура, при котором "левая" ("первая") точка будет сохранена

См. также

Используется в GetContinousContours()

См. определение в файле contour_handler.h строка 74

---

Объявления и описания членов классов находятся в файлах:

• C:/Users/seeyo/source/repos/Visual-Vibration-Tracking-V2/include/VVT-V2/contour_handler.h
• C:/Users/seeyo/source/repos/Visual-Vibration-Tracking-V2/source/contour_handler.cpp