Intel® Integrated Performance Primitives Developer Reference

Developer Reference

  • 2020
  • 07/15/2020
  • Public Content
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.

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