Developer Reference

  • 2020
  • 07/15/2020
  • Public Content
Contents

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.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804