Features2d_draw

列挙型
enum struct	cv::DrawMatchesFlags { cv::DrawMatchesFlags::DEFAULT = 0 , cv::DrawMatchesFlags::DRAW_OVER_OUTIMG = 1 , cv::DrawMatchesFlags::NOT_DRAW_SINGLE_POINTS = 2 , cv::DrawMatchesFlags::DRAW_RICH_KEYPOINTS = 4 }

関数
CV_EXPORTS_W void	cv::drawKeypoints (InputArray image, const std::vector< KeyPoint > &keypoints, InputOutputArray outImage, const Scalar &color=Scalar::all(-1), DrawMatchesFlags flags=DrawMatchesFlags::DEFAULT)
	Draws keypoints. [詳解]
CV_EXPORTS_W void	cv::drawMatches (InputArray img1, const std::vector< KeyPoint > &keypoints1, InputArray img2, const std::vector< KeyPoint > &keypoints2, const std::vector< DMatch > &matches1to2, InputOutputArray outImg, const Scalar &matchColor=Scalar::all(-1), const Scalar &singlePointColor=Scalar::all(-1), const std::vector< char > &matchesMask=std::vector< char >(), DrawMatchesFlags flags=DrawMatchesFlags::DEFAULT)
	Draws the found matches of keypoints from two images. [詳解]
CV_EXPORTS_W void	cv::drawMatches (InputArray img1, const std::vector< KeyPoint > &keypoints1, InputArray img2, const std::vector< KeyPoint > &keypoints2, const std::vector< DMatch > &matches1to2, InputOutputArray outImg, const int matchesThickness, const Scalar &matchColor=Scalar::all(-1), const Scalar &singlePointColor=Scalar::all(-1), const std::vector< char > &matchesMask=std::vector< char >(), DrawMatchesFlags flags=DrawMatchesFlags::DEFAULT)
	cv::CV_EXPORTS_AS (drawMatchesKnn) void drawMatches(InputArray img1

変数
const std::vector< KeyPoint > &	cv::keypoints1
const std::vector< KeyPoint > InputArray	cv::img2
const std::vector< KeyPoint > InputArray const std::vector< KeyPoint > &	cv::keypoints2
const std::vector< KeyPoint > InputArray const std::vector< KeyPoint > const std::vector< std::vector< DMatch > > &	cv::matches1to2
const std::vector< KeyPoint > InputArray const std::vector< KeyPoint > const std::vector< std::vector< DMatch > > InputOutputArray	cv::outImg
const std::vector< KeyPoint > InputArray const std::vector< KeyPoint > const std::vector< std::vector< DMatch > > InputOutputArray const Scalar &	cv::matchColor =Scalar::all(-1)
const std::vector< KeyPoint > InputArray const std::vector< KeyPoint > const std::vector< std::vector< DMatch > > InputOutputArray const Scalar const Scalar &	cv::singlePointColor =Scalar::all(-1)
const std::vector< KeyPoint > InputArray const std::vector< KeyPoint > const std::vector< std::vector< DMatch > > InputOutputArray const Scalar const Scalar const std::vector< std::vector< char > > &	cv::matchesMask =std::vector<std::vector<char> >()

詳解

列挙型詳解

DrawMatchesFlags

enum struct cv::DrawMatchesFlags

strong

列挙値
DEFAULT	Output image matrix will be created (Mat::create), i.e. existing memory of output image may be reused. Two source image, matches and single keypoints will be drawn. For each keypoint only the center point will be drawn (without the circle around keypoint with keypoint size and orientation).
DRAW_OVER_OUTIMG	Output image matrix will not be created (Mat::create). Matches will be drawn on existing content of output image.
NOT_DRAW_SINGLE_POINTS	Single keypoints will not be drawn.
DRAW_RICH_KEYPOINTS	For each keypoint the circle around keypoint with keypoint size and orientation will be drawn.

関数詳解

drawKeypoints()

CV_EXPORTS_W void cv::drawKeypoints	(	InputArray	image,
		const std::vector< KeyPoint > &	keypoints,
		InputOutputArray	outImage,
		const Scalar &	color = Scalar::all(-1),
		DrawMatchesFlags	flags = DrawMatchesFlags::DEFAULT
	)

Draws keypoints.

引数

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 .

覚え書き

For Python API, flags are modified as cv.DRAW_MATCHES_FLAGS_DEFAULT, cv.DRAW_MATCHES_FLAGS_DRAW_RICH_KEYPOINTS, cv.DRAW_MATCHES_FLAGS_DRAW_OVER_OUTIMG, cv.DRAW_MATCHES_FLAGS_NOT_DRAW_SINGLE_POINTS

drawMatches() [1/2]

CV_EXPORTS_W void cv::drawMatches	(	InputArray	img1,
		const std::vector< KeyPoint > &	keypoints1,
		InputArray	img2,
		const std::vector< KeyPoint > &	keypoints2,
		const std::vector< DMatch > &	matches1to2,
		InputOutputArray	outImg,
		const int	matchesThickness,
		const Scalar &	matchColor = Scalar::all(-1),
		const Scalar &	singlePointColor = Scalar::all(-1),
		const std::vector< char > &	matchesMask = std::vector< char >(),
		DrawMatchesFlags	flags = DrawMatchesFlags::DEFAULT
	)

これはオーバーロードされたメンバ関数です。利便性のために用意されています。元の関数との違いは引き数のみです。

drawMatches() [2/2]

CV_EXPORTS_W void cv::drawMatches	(	InputArray	img1,
		const std::vector< KeyPoint > &	keypoints1,
		InputArray	img2,
		const std::vector< KeyPoint > &	keypoints2,
		const std::vector< DMatch > &	matches1to2,
		InputOutputArray	outImg,
		const Scalar &	matchColor = Scalar::all(-1),
		const Scalar &	singlePointColor = Scalar::all(-1),
		const std::vector< char > &	matchesMask = std::vector< char >(),
		DrawMatchesFlags	flags = DrawMatchesFlags::DEFAULT
	)

Draws the found matches of keypoints from two images.

引数

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.

This function draws matches of keypoints from two images in the output image. Match is a line connecting two keypoints (circles). See cv::DrawMatchesFlags.