Finds robust features in the image. For each feature it returns its location, size, orientation and optionally the descriptor, basic or extended. The function can be used for object tracking and localization, image stitching etc

Namespace: Emgu.CV
Assembly: Emgu.CV (in Emgu.CV.dll) Version: 2.2.1.1150 (2.2.1.1150)

Syntax

         
 C#  Visual Basic  Visual C++ 
public static void cvExtractSURF(
	IntPtr image,
	IntPtr mask,
	ref IntPtr keypoints,
	ref IntPtr descriptors,
	IntPtr storage,
	SURFDetector parameters,
	int useProvidedKeyPoints
)
Public Shared Sub cvExtractSURF ( _
	image As IntPtr, _
	mask As IntPtr, _
	ByRef keypoints As IntPtr, _
	ByRef descriptors As IntPtr, _
	storage As IntPtr, _
	parameters As SURFDetector, _
	useProvidedKeyPoints As Integer _
)
public:
static void cvExtractSURF(
	IntPtr image, 
	IntPtr mask, 
	IntPtr% keypoints, 
	IntPtr% descriptors, 
	IntPtr storage, 
	SURFDetector parameters, 
	int useProvidedKeyPoints
)

Parameters

image
IntPtr
The input 8-bit grayscale image
mask
IntPtr
The optional input 8-bit mask. The features are only found in the areas that contain more than 50% of non-zero mask pixels
keypoints
IntPtr%
The output parameter; double pointer to the sequence of keypoints. This will be the sequence of MCvSURFPoint structures
descriptors
IntPtr%
The optional output parameter; double pointer to the sequence of descriptors; Depending on the params.extended value, each element of the sequence will be either 64-element or 128-element floating-point (CV_32F) vector. If the parameter is IntPtr.Zero, the descriptors are not computed
storage
IntPtr
Memory storage where keypoints and descriptors will be stored
parameters
SURFDetector
Various algorithm parameters put to the structure CvSURFParams
useProvidedKeyPoints
Int32
If 1, the provided key points are locations for computing SURF descriptors

See Also