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

ID 790148
Date 6/24/2024
Public

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

Document Table of Contents

FastN2DToVec

Converts corners from two-dimensional image to an array of structures.

Syntax

IppStatus ippiFastN2DToVec_8u(const Ipp8u* pSrcCorner, int srcCornerStep, const Ipp8u* pSrcScore, int srcScoreStep, IppiCornerFastN* pDst, IppiSize srcRoiSize, int maxLen, int* pNumCorners, IppiFastNSpec* pSpec);

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

pSrcCorner

Pointer to the source image with corners.

srcCornerStep

Distance, in bytes, between the starting points of consecutive lines in the source image with corners.

pSrcScore

Pointer to the source image with scores.

srcScoreStep

Distance, in bytes, between the starting points of consecutive lines in the source image with score.

pDst

Pointer to the destination vector of structures.

srcRoiSize

Size of the source ROI, in pixels.

maxLen

Length of the array of structures.

pNumCorners

Pointer to the number of corners in the source image.

pSpec

Pointer to the specification structure.

Description

This function converts two-dimensional image with corners to an array of structures. The result is stored in pDst.

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:
  • pSrcCorner, pDst, pNumCorners, or pSpec is NULL

  • pSrcScore is NULL if option is not equal to IPP_FASTN_SCORE_MODE0

ippStsSizeErr
Indicates an error when srcRoiSize is less than, or equal to zero.
ippContextMatchErr
Indicates an error when the specification structure does not match the operation.
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.
ippBadArgsErr
Indicates an error when option or circleRadius has an illegal value.
ippThresholdErr
Indicates an error when threshold is negative.

See Also