HoughLine
Detects straight lines in the source image.
Syntax
IppStatus ippiHoughLine_8u32f_C1R(const Ipp8u*
pSrc
, int
srcStep
, IppiSize
roiSize
, IppPointPolar
delta
, int
threshold
, IppPointPolar*
pLine
, int
maxLineCount
, int*
pLineCount
, Ipp8u*
pBuffer
);
Include Files
ippcv.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
,
ipps.h
,
ippi.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
,
ippi.lib
Parameters
- pSrc
- Pointer to the source image ROI.
- srcStep
- Distance in bytes between starts of consecutive lines in the source image.
- roiSize
- Size of source image ROI in pixels.
- delta
- Step of discretization (delta.rho- radial increment,delta.theta- angular increment).
- threshold
- Minimum number of points that are required to detect the line.
- pLine
- Pointer to the destination buffer for lines.
- pLineCount
- Number of detected lines. If the value is more thanmaxLineCount, the function returns theippStsDstSizeLessExpectedstatus.
- maxLineCount
- Number of elements of the destination buffer.
- pBuffer
- Pointer to the working buffer.
Description
This function operates with ROI (see
Regions of Interest in Intel IPP
).
In the binarised source image
pSrc
, the function performs detection of the straight line defined by the
equation
given at the beginning of section Hough Transform. The level of discretization
delta
is specified as the input parameters. The performance and effectiveness of the function is strongly depends on this parameter. The function requires the external working buffer
pBuffer
, which size should be computed previously using the function
ippiHoughLineGetSize
.
The value of the parameter
delta
must not be greater than the value of the parameter
delta
set when the size of the working buffer is computed.
Return Values
- ippStsNoErr
- Indicates no error.
- ippStsNullPtrErr
- Indicates an error if one of the specified pointers isNULL.
- ippStsSizeErr
- Indicates an error condition ifroiSizehas a field with zero or negative value; or ifmaxLineCountis less than or equal to 0.
- ippStsStepErr
- Indicates an error condition ifsrcStephas an illegal value.
- ippStsBadArgErr
- Indicates an error condition ifthresholdis less than or equal to 0; ordelta.rhois less than 0, or greater than sum of the width and height of the ROI; ordelta.thetais less than 0, or greater thanp.
- ippStsDstSizeLessExpected
- Indicates a warning if number of the detected lines is greater than the size of the destination buffermaxLineCount.