Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of 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.

See Also