# EdgesSubPix

**Repository Path**: songyuncen/EdgesSubPix

## Basic Information

- **Project Name**: EdgesSubPix
- **Description**: Sub-Pixel Edge Detection Using OpenCV
- **Primary Language**: C++
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2020-09-11
- **Last Updated**: 2024-12-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Sub-Pixel Edge Detection using OpenCV 
===

# Description

- Edge detection operator return subpixel level edge position.
- Using Canny filter as differential operator.
- Implementing according to [Carsten Steger's method][1].
- Interpolation of second partial derivatives with [Facet Model method][2].

# API

```cpp
struct Contour
{
    std::vector<cv::Point2f> points;  // edge location
    std::vector<float> direction;     // direction of the gradient in edge point, 
                                      // starting from y axis, counter-clockwise
    std::vector<float> response;      // amptitude of the gradient in edge point
};
// gray             - only support 8-bit grayscale
// hierarchy, mode  - have the same meanings as in cv::findContours
CV_EXPORTS void EdgesSubPix(cv::Mat &gray, double alpha, int low, int high,
                            std::vector<Contour> &contours, cv::OutputArray hierarchy,
                            int mode);

// mode = RETR_LIST
CV_EXPORTS void EdgesSubPix(cv::Mat &gray, double alpha, int low, int high, 
                           std::vector<Contour> &contours);
```

# Test

```shell
Edge --data=edge.yml avatar.jpg edge.jpg
```

# License

3-clause BSD License

[1]:http://iuks.informatik.tu-muenchen.de/_media/members/steger/publications/1996/fgbv-96-03-steger.pdf
[2]:http://haralick.org/journals/topographic_primal_sketch.pdf