Visible to Intel only — GUID: GUID-53D5021A-D328-4CDD-97CE-9E345A5F797E
Visible to Intel only — GUID: GUID-53D5021A-D328-4CDD-97CE-9E345A5F797E
FastNGetSize
Computes the size of the FastN context structure.
Syntax
IppStatus ippiFastNGetSize(IppiSize srcSize, int circleRadius, int N, int orientationBins, int option, IppDataType dataType, int numChannels, int* pSpecSize);
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
- srcSize
-
Size of the source ROI, in pixels.
- circleRadius
-
Radius of the pixel circle. The radius value equal to 1 corresponds to the distance between the closest pixels from common row or column. Supported values are 1, 2, 3, 5, 7, 9.
- N
-
Critical number of serial pixels on circle for defining a corner. The ranges are as follows:
circleRadius N 1 5 ≤ N ≤ 8 2 7 ≤ N ≤ 12 3 9 ≤ N ≤ 16 5 15 ≤ N ≤ 28 7 21 ≤ N ≤ 40 9 27 ≤ N ≤ 52 - orientationBins
-
The number of bins to define direction. Supported values are from 2 to 64.
- option
-
Mode of processing. Supported values:
IPP_FASTN_CIRCLE
(IPP_FASTN_CIRCLE | IPP_FASTN_ORIENTATION)
(IPP_FASTN_CIRCLE | IPP_FASTN_SCORE_MODE0)
(IPP_FASTN_CIRCLE | IPP_FASTN_ORIENTATION | IPP_FASTN_SCORE_MODE0)
(IPP_FASTN_CIRCLE | IPP_FASTN_SCORE_MODE0 | IPP_FASTN_NMS)
(IPP_FASTN_CIRCLE | IPP_FASTN_ORIENTATION | IPP_FASTN_SCORE_MODE0 | IPP_FASTN_NMS)
- dataType
-
Data type of the source and destination images. Supported value is ipp8u.
- numChannels
-
Number of channels in the images. Supported value is 1.
- pSpecSize
-
Pointer to the computed size of the specification structure.
Description
This function computes the size of the FastN context structure for the FastN function. The result is stored in pSpecSize.
Use the computed pSpecSize value to allocate memory using the ippMalloc or ippsMalloc functions. The allocated memory can be freed only by the ippFree or ippsFree functions, respectively. For more information about the memory allocation functions, refer to the Support Functions section of the Intel IPP Developer Reference, vol. 1.
For an example on how to use this function, refer to the example provided with the FastN function description.
Return Values
- ippStsNoErr
- Indicates no error. Any other value indicates an error.
- ippStsNullPtrErr
- Indicates an error when pSpecSize is NULL.
- ippStsSizeErr
- Indicates an error when srcSize is less than, or equal to zero.
- ippDataTypeErr
- Indicates an error when dataType has an illegal value.
- ippNumChannelsErr
- Indicates an error when numChannels has an illegal value.
- ippOutOfRangeErr
- Indicates an error when orientationBins or N has an illegal value.
- ippBadArgErr
- Indicates an error when option or circleRadius has an illegal value.