OpenCV 2.4.3 (RC)

org.opencv.features2d
Class Features2d

java.lang.Object
  extended by org.opencv.features2d.Features2d

public class Features2d
extends java.lang.Object


Field Summary
static int DRAW_OVER_OUTIMG
           
static int DRAW_RICH_KEYPOINTS
           
static int NOT_DRAW_SINGLE_POINTS
           
 
Constructor Summary
Features2d()
           
 
Method Summary
static void drawKeypoints(Mat image, MatOfKeyPoint keypoints, Mat outImage)
          Draws keypoints.
static void drawKeypoints(Mat image, MatOfKeyPoint keypoints, Mat outImage, Scalar color, int flags)
          Draws keypoints.
static void drawMatches(Mat img1, MatOfKeyPoint keypoints1, Mat img2, MatOfKeyPoint keypoints2, MatOfDMatch matches1to2, Mat outImg)
          Draws the found matches of keypoints from two images.
static void drawMatches(Mat img1, MatOfKeyPoint keypoints1, Mat img2, MatOfKeyPoint keypoints2, MatOfDMatch matches1to2, Mat outImg, Scalar matchColor, Scalar singlePointColor, MatOfByte matchesMask, int flags)
          Draws the found matches of keypoints from two images.
static void drawMatches2(Mat img1, MatOfKeyPoint keypoints1, Mat img2, MatOfKeyPoint keypoints2, java.util.List<MatOfDMatch> matches1to2, Mat outImg)
          Draws the found matches of keypoints from two images.
static void drawMatches2(Mat img1, MatOfKeyPoint keypoints1, Mat img2, MatOfKeyPoint keypoints2, java.util.List<MatOfDMatch> matches1to2, Mat outImg, Scalar matchColor, Scalar singlePointColor, java.util.List<MatOfByte> matchesMask, int flags)
          Draws the found matches of keypoints from two images.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DRAW_OVER_OUTIMG

public static final int DRAW_OVER_OUTIMG
See Also:
Constant Field Values

DRAW_RICH_KEYPOINTS

public static final int DRAW_RICH_KEYPOINTS
See Also:
Constant Field Values

NOT_DRAW_SINGLE_POINTS

public static final int NOT_DRAW_SINGLE_POINTS
See Also:
Constant Field Values
Constructor Detail

Features2d

public Features2d()
Method Detail

drawKeypoints

public static void drawKeypoints(Mat image,
                                 MatOfKeyPoint keypoints,
                                 Mat outImage)

Draws keypoints.

Parameters:
image - Source image.
keypoints - Keypoints from the source image.
outImage - Output image. Its content depends on the flags value defining what is drawn in the output image. See possible flags bit values below.
See Also:
org.opencv.features2d.Features2d.drawKeypoints

drawKeypoints

public static void drawKeypoints(Mat image,
                                 MatOfKeyPoint keypoints,
                                 Mat outImage,
                                 Scalar color,
                                 int flags)

Draws keypoints.

Parameters:
image - Source image.
keypoints - Keypoints from the source image.
outImage - Output image. Its content depends on the flags value defining what is drawn in the output image. See possible flags bit values below.
color - Color of keypoints.
flags - Flags setting drawing features. Possible flags bit values are defined by DrawMatchesFlags. See details above in "drawMatches".
See Also:
org.opencv.features2d.Features2d.drawKeypoints

drawMatches

public static void drawMatches(Mat img1,
                               MatOfKeyPoint keypoints1,
                               Mat img2,
                               MatOfKeyPoint keypoints2,
                               MatOfDMatch matches1to2,
                               Mat outImg)

Draws the found matches of keypoints from two images.

This function draws matches of keypoints from two images in the output image. Match is a line connecting two keypoints (circles). The structure DrawMatchesFlags is defined as follows: struct DrawMatchesFlags

// C++ code:

enum

DEFAULT = 0, // Output image matrix will be created (Mat.create),

// i.e. existing memory of output image may be reused.

// Two source images, matches, and single keypoints

// will be drawn.

// For each keypoint, only the center point will be

// drawn (without a circle around the keypoint with the

// keypoint size and orientation).

DRAW_OVER_OUTIMG = 1, // Output image matrix will not be

// created (using Mat.create). Matches will be drawn

// on existing content of output image.

NOT_DRAW_SINGLE_POINTS = 2, // Single keypoints will not be drawn.

DRAW_RICH_KEYPOINTS = 4 // For each keypoint, the circle around

// keypoint with keypoint size and orientation will

// be drawn.

};

};

Parameters:
img1 - First source image.
keypoints1 - Keypoints from the first source image.
img2 - Second source image.
keypoints2 - Keypoints from the second source image.
matches1to2 - Matches from the first image to the second one, which means that keypoints1[i] has a corresponding point in keypoints2[matches[i]].
outImg - Output image. Its content depends on the flags value defining what is drawn in the output image. See possible flags bit values below.
See Also:
org.opencv.features2d.Features2d.drawMatches

drawMatches

public static void drawMatches(Mat img1,
                               MatOfKeyPoint keypoints1,
                               Mat img2,
                               MatOfKeyPoint keypoints2,
                               MatOfDMatch matches1to2,
                               Mat outImg,
                               Scalar matchColor,
                               Scalar singlePointColor,
                               MatOfByte matchesMask,
                               int flags)

Draws the found matches of keypoints from two images.

This function draws matches of keypoints from two images in the output image. Match is a line connecting two keypoints (circles). The structure DrawMatchesFlags is defined as follows: struct DrawMatchesFlags

// C++ code:

enum

DEFAULT = 0, // Output image matrix will be created (Mat.create),

// i.e. existing memory of output image may be reused.

// Two source images, matches, and single keypoints

// will be drawn.

// For each keypoint, only the center point will be

// drawn (without a circle around the keypoint with the

// keypoint size and orientation).

DRAW_OVER_OUTIMG = 1, // Output image matrix will not be

// created (using Mat.create). Matches will be drawn

// on existing content of output image.

NOT_DRAW_SINGLE_POINTS = 2, // Single keypoints will not be drawn.

DRAW_RICH_KEYPOINTS = 4 // For each keypoint, the circle around

// keypoint with keypoint size and orientation will

// be drawn.

};

};

Parameters:
img1 - First source image.
keypoints1 - Keypoints from the first source image.
img2 - Second source image.
keypoints2 - Keypoints from the second source image.
matches1to2 - Matches from the first image to the second one, which means that keypoints1[i] has a corresponding point in keypoints2[matches[i]].
outImg - Output image. Its content depends on the flags value defining what is drawn in the output image. See possible flags bit values below.
matchColor - Color of matches (lines and connected keypoints). If matchColor==Scalar.all(-1), the color is generated randomly.
singlePointColor - Color of single keypoints (circles), which means that keypoints do not have the matches. If singlePointColor==Scalar.all(-1), the color is generated randomly.
matchesMask - Mask determining which matches are drawn. If the mask is empty, all matches are drawn.
flags - Flags setting drawing features. Possible flags bit values are defined by DrawMatchesFlags.
See Also:
org.opencv.features2d.Features2d.drawMatches

drawMatches2

public static void drawMatches2(Mat img1,
                                MatOfKeyPoint keypoints1,
                                Mat img2,
                                MatOfKeyPoint keypoints2,
                                java.util.List<MatOfDMatch> matches1to2,
                                Mat outImg)

Draws the found matches of keypoints from two images.

This function draws matches of keypoints from two images in the output image. Match is a line connecting two keypoints (circles). The structure DrawMatchesFlags is defined as follows: struct DrawMatchesFlags

// C++ code:

enum

DEFAULT = 0, // Output image matrix will be created (Mat.create),

// i.e. existing memory of output image may be reused.

// Two source images, matches, and single keypoints

// will be drawn.

// For each keypoint, only the center point will be

// drawn (without a circle around the keypoint with the

// keypoint size and orientation).

DRAW_OVER_OUTIMG = 1, // Output image matrix will not be

// created (using Mat.create). Matches will be drawn

// on existing content of output image.

NOT_DRAW_SINGLE_POINTS = 2, // Single keypoints will not be drawn.

DRAW_RICH_KEYPOINTS = 4 // For each keypoint, the circle around

// keypoint with keypoint size and orientation will

// be drawn.

};

};

Parameters:
img1 - First source image.
keypoints1 - Keypoints from the first source image.
img2 - Second source image.
keypoints2 - Keypoints from the second source image.
matches1to2 - Matches from the first image to the second one, which means that keypoints1[i] has a corresponding point in keypoints2[matches[i]].
outImg - Output image. Its content depends on the flags value defining what is drawn in the output image. See possible flags bit values below.
See Also:
org.opencv.features2d.Features2d.drawMatches

drawMatches2

public static void drawMatches2(Mat img1,
                                MatOfKeyPoint keypoints1,
                                Mat img2,
                                MatOfKeyPoint keypoints2,
                                java.util.List<MatOfDMatch> matches1to2,
                                Mat outImg,
                                Scalar matchColor,
                                Scalar singlePointColor,
                                java.util.List<MatOfByte> matchesMask,
                                int flags)

Draws the found matches of keypoints from two images.

This function draws matches of keypoints from two images in the output image. Match is a line connecting two keypoints (circles). The structure DrawMatchesFlags is defined as follows: struct DrawMatchesFlags

// C++ code:

enum

DEFAULT = 0, // Output image matrix will be created (Mat.create),

// i.e. existing memory of output image may be reused.

// Two source images, matches, and single keypoints

// will be drawn.

// For each keypoint, only the center point will be

// drawn (without a circle around the keypoint with the

// keypoint size and orientation).

DRAW_OVER_OUTIMG = 1, // Output image matrix will not be

// created (using Mat.create). Matches will be drawn

// on existing content of output image.

NOT_DRAW_SINGLE_POINTS = 2, // Single keypoints will not be drawn.

DRAW_RICH_KEYPOINTS = 4 // For each keypoint, the circle around

// keypoint with keypoint size and orientation will

// be drawn.

};

};

Parameters:
img1 - First source image.
keypoints1 - Keypoints from the first source image.
img2 - Second source image.
keypoints2 - Keypoints from the second source image.
matches1to2 - Matches from the first image to the second one, which means that keypoints1[i] has a corresponding point in keypoints2[matches[i]].
outImg - Output image. Its content depends on the flags value defining what is drawn in the output image. See possible flags bit values below.
matchColor - Color of matches (lines and connected keypoints). If matchColor==Scalar.all(-1), the color is generated randomly.
singlePointColor - Color of single keypoints (circles), which means that keypoints do not have the matches. If singlePointColor==Scalar.all(-1), the color is generated randomly.
matchesMask - Mask determining which matches are drawn. If the mask is empty, all matches are drawn.
flags - Flags setting drawing features. Possible flags bit values are defined by DrawMatchesFlags.
See Also:
org.opencv.features2d.Features2d.drawMatches

Official OpenCV 2.4 Documentation