关键点描述符匹配的抽象基类。更多…

#include <opencv2/cudafeatures2d.hpp>

cv::cuda::DescriptorMatcher 的协作图

公有成员函数
virtual void	add (const std::vector< GpuMat > &descriptors)=0
	添加描述符以训练描述符集合。

virtual void	clear ()=0
	清除训练描述符集合。

virtual bool	empty () const =0
	如果集合中没有训练描述符，则返回 true。

virtual const std::vector< GpuMat > &	getTrainDescriptors () const =0
	返回指向训练描述符集合的常量链接。

virtual bool	isMaskSupported () const =0
	如果描述符匹配器支持掩码允许的匹配，则返回 true。

virtual void	knnMatch (InputArray queryDescriptors, InputArray trainDescriptors, std::vector< std::vector< DMatch > > &matches, int k, InputArray mask=noArray(), bool compactResult=false)=0
	为查询集中的每个描述符查找 k 个最佳匹配项（阻塞版本）。

virtual void	knnMatch (InputArray queryDescriptors, std::vector< std::vector< DMatch > > &matches, int k, const std::vector< GpuMat > &masks=std::vector< GpuMat >(), bool compactResult=false)=0

virtual void	knnMatchAsync (InputArray queryDescriptors, InputArray trainDescriptors, OutputArray matches, int k, InputArray mask=noArray(), Stream &stream=Stream::Null())=0
	为查询集中的每个描述符查找 k 个最佳匹配项（异步版本）。

virtual void	knnMatchAsync (InputArray queryDescriptors, OutputArray matches, int k, const std::vector< GpuMat > &masks=std::vector< GpuMat >(), Stream &stream=Stream::Null())=0

virtual void	knnMatchConvert (InputArray gpu_matches, std::vector< std::vector< DMatch > > &matches, bool compactResult=false)=0
	将匹配数组从内部表示转换为标准匹配向量。

virtual void	match (InputArray queryDescriptors, InputArray trainDescriptors, std::vector< DMatch > &matches, InputArray mask=noArray())=0
	为查询集中的每个描述符查找最佳匹配项（阻塞版本）。

virtual void	match (InputArray queryDescriptors, std::vector< DMatch > &matches, const std::vector< GpuMat > &masks=std::vector< GpuMat >())=0

virtual void	matchAsync (InputArray queryDescriptors, InputArray trainDescriptors, OutputArray matches, InputArray mask=noArray(), Stream &stream=Stream::Null())=0
	为查询集中的每个描述符查找最佳匹配项（异步版本）。

virtual void	matchAsync (InputArray queryDescriptors, OutputArray matches, const std::vector< GpuMat > &masks=std::vector< GpuMat >(), Stream &stream=Stream::Null())=0

virtual void	matchConvert (InputArray gpu_matches, std::vector< DMatch > &matches)=0
	将匹配数组从内部表示转换为标准匹配向量。

virtual void	radiusMatch (InputArray queryDescriptors, InputArray trainDescriptors, std::vector< std::vector< DMatch > > &matches, float maxDistance, InputArray mask=noArray(), bool compactResult=false)=0
	对于每个查询描述符，查找距离不超过指定距离的训练描述符（阻塞版本）。

virtual void	radiusMatch (InputArray queryDescriptors, std::vector< std::vector< DMatch > > &matches, float maxDistance, const std::vector< GpuMat > &masks=std::vector< GpuMat >(), bool compactResult=false)=0

virtual void	radiusMatchAsync (InputArray queryDescriptors, InputArray trainDescriptors, OutputArray matches, float maxDistance, InputArray mask=noArray(), Stream &stream=Stream::Null())=0
	对于每个查询描述符，查找距离不超过指定距离的训练描述符（异步版本）。

virtual void	radiusMatchAsync (InputArray queryDescriptors, OutputArray matches, float maxDistance, const std::vector< GpuMat > &masks=std::vector< GpuMat >(), Stream &stream=Stream::Null())=0

virtual void	radiusMatchConvert (InputArray gpu_matches, std::vector< std::vector< DMatch > > &matches, bool compactResult=false)=0
	将匹配数组从内部表示转换为标准匹配向量。

virtual void	训练 ()=0
	训练描述符匹配器。

从 cv::Algorithm 继承的公有成员函数
	算法 ()

虚函数	~Algorithm ()

virtual String	getDefaultName () const

virtual void	read (const FileNode &fn)
	从文件存储中读取算法参数。

virtual void	save (const String &filename) const

void	write (const Ptr< FileStorage > &fs, const String &name=String()) const

virtual void	write (FileStorage &fs) const
	将算法参数存储到文件存储中。

void	write (FileStorage &fs, const String &name) const

静态公有成员函数
static Ptr< cuda::DescriptorMatcher >	createBFMatcher (int normType=cv::NORM_L2)
	暴力匹配描述符匹配器。

从 cv::Algorithm 继承的静态公有成员函数
template<typename _Tp >
static Ptr< _Tp >	load (const String &filename, const String &objname=String())
	从文件中加载算法。

template<typename _Tp >
static Ptr< _Tp >	loadFromString (const String &strModel, const String &objname=String())
	从字符串中加载算法。

template<typename _Tp >
static Ptr< _Tp >	read (const FileNode &fn)
	从文件节点读取算法。

其他继承的成员
从 cv::Algorithm 继承的保护成员函数
void	writeFormat (FileStorage &fs) const

详细描述

匹配关键点描述符的抽象基类。

它有两组匹配方法：用于将图像的描述符与另一幅图像或一组图像进行匹配。

成员函数文档

◆ add()

virtual void cv::cuda::DescriptorMatcher::add ( const std::vector< GpuMat > & descriptors )

纯虚函数

添加描述符以训练描述符集合。

如果集合不为空，则将新的描述符添加到现有的训练描述符中。

参数

descriptors 要添加的描述符。每个 descriptors[i] 都是来自同一训练图像的一组描述符。

◆ clear()

virtual void cv::cuda::DescriptorMatcher::clear ( )

纯虚函数

清除训练描述符集合。

从 cv::Algorithm 重载。

◆ createBFMatcher()

static Ptr< cuda::DescriptorMatcher > cv::cuda::DescriptorMatcher::createBFMatcher ( int normType = cv::NORM_L2 )

静态

暴力匹配描述符匹配器。

对于第一组中的每个描述符，此匹配器都会尝试每个描述符，从而在第二组中找到最接近的描述符。此描述符匹配器支持对描述符集的可允许匹配进行掩码。

参数

normType NORM_L1、NORM_L2、NORM_HAMMING 之一。L1 和 L2 范数是 SIFT 和 SURF 描述符的较好选择，NORM_HAMMING 应与 ORB、BRISK 和 BRIEF 一起使用。

◆ empty()

virtual bool cv::cuda::DescriptorMatcher::empty ( ) const

纯虚函数

如果集合中没有训练描述符，则返回 true。

从 cv::Algorithm 重载。

◆ getTrainDescriptors()

virtual const std::vector< GpuMat > & cv::cuda::DescriptorMatcher::getTrainDescriptors ( ) const

纯虚函数

返回指向训练描述符集合的常量链接。

◆ isMaskSupported()

virtual bool cv::cuda::DescriptorMatcher::isMaskSupported ( ) const

纯虚函数

如果描述符匹配器支持掩码允许的匹配，则返回 true。

◆ knnMatch() [1/2]

virtual void cv::cuda::DescriptorMatcher::knnMatch	(	InputArray	queryDescriptors,
		InputArray	trainDescriptors,
		std::vector< std::vector< DMatch > > &	matches,
		int	k,
		InputArray	mask = noArray(),
		bool	compactResult = false )

纯虚函数

为查询集中的每个描述符查找 k 个最佳匹配项（阻塞版本）。

参数

queryDescriptors	查询描述符集。
trainDescriptors	训练描述符集。此集合不会添加到类对象中存储的训练描述符集合中。
matches	匹配结果。每个 matches[i] 包含针对相同查询描述符的 k 个或更少的匹配。
k	每个查询描述符找到的最佳匹配数，如果查询描述符的总匹配数少于 k，则更少。
mask	指定输入查询和训练描述符矩阵之间允许匹配的掩码。
compactResult	当掩码（或掩码）不为空时使用的参数。如果 compactResult 为 false，则 matches 向量的大小与 queryDescriptors 行数相同。如果 compactResult 为 true，则 matches 向量不包含完全被掩码遮蔽的查询描述符的匹配。

这些 DescriptorMatcher::match 方法的扩展变体为每个查询描述符查找多个最佳匹配。匹配结果按距离递增顺序返回。有关查询和训练描述符的详细信息，请参阅 DescriptorMatcher::match。

以下是此函数的调用图

◆ knnMatch() [2/2]

virtual void cv::cuda::DescriptorMatcher::knnMatch	(	InputArray	queryDescriptors,
		std::vector< std::vector< DMatch > > &	matches,
		int	k,
		const std::vector< GpuMat > &	masks = std::vector< GpuMat >(),
		bool	compactResult = false )

纯虚函数

这是一个重载的成员函数，为了方便起见而提供。它与上面的函数的区别仅在于它接受的参数。

◆ knnMatchAsync() [1/2]

virtual void cv::cuda::DescriptorMatcher::knnMatchAsync	(	InputArray	queryDescriptors,
		InputArray	trainDescriptors,
		OutputArray	matches,
		int	k,
		InputArray	mask = noArray(),
		Stream &	stream = Stream::Null() )

纯虚函数

为查询集中的每个描述符查找 k 个最佳匹配项（异步版本）。

参数

queryDescriptors	查询描述符集。
trainDescriptors	训练描述符集。此集合不会添加到类对象中存储的训练描述符集合中。
matches	存储在 GPU 内存中的匹配数组。内部表示未定义。使用 DescriptorMatcher::knnMatchConvert 方法以标准表示形式检索结果。
k	每个查询描述符找到的最佳匹配数，如果查询描述符的总匹配数少于 k，则更少。
mask	指定输入查询和训练描述符矩阵之间允许匹配的掩码。
stream	CUDA 流。

这些 DescriptorMatcher::matchAsync 方法的扩展变体为每个查询描述符查找多个最佳匹配。匹配结果按距离递增顺序返回。有关查询和训练描述符的详细信息，请参阅 DescriptorMatcher::matchAsync。

以下是此函数的调用图

◆ knnMatchAsync() [2/2]

virtual void cv::cuda::DescriptorMatcher::knnMatchAsync	(	InputArray	queryDescriptors,
		OutputArray	matches,
		int	k,
		const std::vector< GpuMat > &	masks = std::vector< GpuMat >(),
		Stream &	stream = Stream::Null() )

纯虚函数

这是一个重载的成员函数，为了方便起见而提供。它与上面的函数的区别仅在于它接受的参数。

◆ knnMatchConvert()

virtual void cv::cuda::DescriptorMatcher::knnMatchConvert	(	InputArray	gpu_matches,
		std::vector< std::vector< DMatch > > &	matches,
		bool	compactResult = false )

纯虚函数

将匹配数组从内部表示转换为标准匹配向量。

此方法应该与 DescriptorMatcher::knnMatchAsync 一起使用以获取最终结果。只有在 DescriptorMatcher::knnMatchAsync 完成后（即同步之后）才能调用此方法。

参数

gpu_matches	从 DescriptorMatcher::knnMatchAsync 返回的匹配结果。
matches	DMatch 对象向量。
compactResult	当掩码（或掩码）不为空时使用的参数。如果 compactResult 为 false，则 matches 向量的大小与 queryDescriptors 行数相同。如果 compactResult 为 true，则 matches 向量不包含完全被掩码遮蔽的查询描述符的匹配。

◆ match() [1/2]

virtual void cv::cuda::DescriptorMatcher::match	(	InputArray	queryDescriptors,
		InputArray	trainDescriptors,
		std::vector< DMatch > &	matches,
		InputArray	mask = noArray() )

纯虚函数

为查询集中的每个描述符查找最佳匹配项（阻塞版本）。

参数

queryDescriptors	查询描述符集。
trainDescriptors	训练描述符集。此集合不会添加到类对象中存储的训练描述符集合中。
matches	匹配结果。如果查询描述符在 mask 中被屏蔽，则不会为此描述符添加匹配。因此，matches 的大小可能小于查询描述符的数量。
mask	指定输入查询和训练描述符矩阵之间允许匹配的掩码。

在此方法的第一个变体中，训练描述符作为输入参数传递。在此方法的第二个变体中，使用由 DescriptorMatcher::add 设置的训练描述符集合。可以传递可选的掩码（或掩码）来指定哪些查询和训练描述符可以匹配。即，只有当 mask.at<uchar>(i,j) 非零时，queryDescriptors[i] 才能与 trainDescriptors[j] 匹配。

以下是此函数的调用图

◆ match() [2/2]

virtual void cv::cuda::DescriptorMatcher::match	(	InputArray	queryDescriptors,
		std::vector< DMatch > &	matches,
		const std::vector< GpuMat > &	masks = std::vector< GpuMat >() )

纯虚函数

这是一个重载的成员函数，为了方便起见而提供。它与上面的函数的区别仅在于它接受的参数。

◆ matchAsync() [1/2]

virtual void cv::cuda::DescriptorMatcher::matchAsync	(	InputArray	queryDescriptors,
		InputArray	trainDescriptors,
		OutputArray	matches,
		InputArray	mask = noArray(),
		Stream &	stream = Stream::Null() )

纯虚函数

为查询集中的每个描述符查找最佳匹配项（异步版本）。

参数

queryDescriptors	查询描述符集。
trainDescriptors	训练描述符集。此集合不会添加到类对象中存储的训练描述符集合中。
matches	匹配存储在GPU内存中的数组。内部表示未定义。使用DescriptorMatcher::matchConvert方法以标准表示形式检索结果。
mask	指定输入查询和训练描述符矩阵之间允许匹配的掩码。
stream	CUDA 流。

在此方法的第一个变体中，训练描述符作为输入参数传递。在此方法的第二个变体中，使用由 DescriptorMatcher::add 设置的训练描述符集合。可以传递可选的掩码（或掩码）来指定哪些查询和训练描述符可以匹配。即，只有当 mask.at<uchar>(i,j) 非零时，queryDescriptors[i] 才能与 trainDescriptors[j] 匹配。

以下是此函数的调用图

◆ matchAsync() [2/2]

virtual void cv::cuda::DescriptorMatcher::matchAsync	(	InputArray	queryDescriptors,
		OutputArray	matches,
		const std::vector< GpuMat > &	masks = std::vector< GpuMat >(),
		Stream &	stream = Stream::Null() )

纯虚函数

这是一个重载的成员函数，为了方便起见而提供。它与上面的函数的区别仅在于它接受的参数。

◆ matchConvert()

virtual void cv::cuda::DescriptorMatcher::matchConvert	(	InputArray	gpu_matches,
		std::vector< DMatch > &	matches )

纯虚函数

将匹配数组从内部表示转换为标准匹配向量。

此方法应与DescriptorMatcher::matchAsync一起使用以获得最终结果。只有在DescriptorMatcher::matchAsync完成后（即同步后）才调用此方法。

参数

gpu_matches	从DescriptorMatcher::matchAsync返回的匹配项。
matches	DMatch 对象向量。

◆ radiusMatch() [1/2]

virtual void cv::cuda::DescriptorMatcher::radiusMatch	(	InputArray	queryDescriptors,
		InputArray	trainDescriptors,
		std::vector< std::vector< DMatch > > &	matches,
		float	maxDistance,
		InputArray	mask = noArray(),
		bool	compactResult = false )

纯虚函数

对于每个查询描述符，查找距离不超过指定距离的训练描述符（阻塞版本）。

参数

queryDescriptors	查询描述符集。
trainDescriptors	训练描述符集。此集合不会添加到类对象中存储的训练描述符集合中。
matches	找到的匹配项。
maxDistance	匹配描述符之间距离的阈值。这里的距离是指度量距离（例如Hamming距离），而不是坐标之间的距离（以像素为单位测量）！
mask	指定输入查询和训练描述符矩阵之间允许匹配的掩码。
compactResult	当掩码（或掩码）不为空时使用的参数。如果 compactResult 为 false，则 matches 向量的大小与 queryDescriptors 行数相同。如果 compactResult 为 true，则 matches 向量不包含完全被掩码遮蔽的查询描述符的匹配。

对于每个查询描述符，该方法查找与查询描述符之间的距离等于或小于maxDistance的训练描述符。找到的匹配项按距离递增顺序返回。

以下是此函数的调用图

◆ radiusMatch() [2/2]

virtual void cv::cuda::DescriptorMatcher::radiusMatch	(	InputArray	queryDescriptors,
		std::vector< std::vector< DMatch > > &	matches,
		float	maxDistance,
		const std::vector< GpuMat > &	masks = std::vector< GpuMat >(),
		bool	compactResult = false )

纯虚函数

这是一个重载的成员函数，为了方便起见而提供。它与上面的函数的区别仅在于它接受的参数。

◆ radiusMatchAsync() [1/2]

virtual void cv::cuda::DescriptorMatcher::radiusMatchAsync	(	InputArray	queryDescriptors,
		InputArray	trainDescriptors,
		OutputArray	matches,
		float	maxDistance,
		InputArray	mask = noArray(),
		Stream &	stream = Stream::Null() )

纯虚函数

对于每个查询描述符，查找距离不超过指定距离的训练描述符（异步版本）。

参数

queryDescriptors	查询描述符集。
trainDescriptors	训练描述符集。此集合不会添加到类对象中存储的训练描述符集合中。
matches	匹配数组存储在GPU内存中。内部表示未定义。使用DescriptorMatcher::radiusMatchConvert方法以标准表示形式检索结果。
maxDistance	匹配描述符之间距离的阈值。这里的距离是指度量距离（例如Hamming距离），而不是坐标之间的距离（以像素为单位测量）！
mask	指定输入查询和训练描述符矩阵之间允许匹配的掩码。
stream	CUDA 流。

对于每个查询描述符，该方法查找与查询描述符之间的距离等于或小于maxDistance的训练描述符。找到的匹配项按距离递增顺序返回。

以下是此函数的调用图

◆ radiusMatchAsync() [2/2]

virtual void cv::cuda::DescriptorMatcher::radiusMatchAsync	(	InputArray	queryDescriptors,
		OutputArray	matches,
		float	maxDistance,
		const std::vector< GpuMat > &	masks = std::vector< GpuMat >(),
		Stream &	stream = Stream::Null() )

纯虚函数

这是一个重载的成员函数，为了方便起见而提供。它与上面的函数的区别仅在于它接受的参数。

◆ radiusMatchConvert()

virtual void cv::cuda::DescriptorMatcher::radiusMatchConvert	(	InputArray	gpu_matches,
		std::vector< std::vector< DMatch > > &	matches,
		bool	compactResult = false )

纯虚函数

将匹配数组从内部表示转换为标准匹配向量。

此方法应与DescriptorMatcher::radiusMatchAsync一起使用以获得最终结果。只有在DescriptorMatcher::radiusMatchAsync完成后（即同步后）才调用此方法。

参数

gpu_matches	从DescriptorMatcher::radiusMatchAsync返回的匹配项。
matches	DMatch 对象向量。
compactResult	当掩码（或掩码）不为空时使用的参数。如果 compactResult 为 false，则 matches 向量的大小与 queryDescriptors 行数相同。如果 compactResult 为 true，则 matches 向量不包含完全被掩码遮蔽的查询描述符的匹配。

◆ train()

virtual void cv::cuda::DescriptorMatcher::train ( )

纯虚函数

训练描述符匹配器。

训练描述符匹配器（例如，FLANN索引）。在所有匹配方法中，train()方法在每次匹配之前都会运行。

此类的文档是从以下文件生成的

opencv2/cudafeatures2d.hpp

公有成员函数

静态公有成员函数

其他继承的成员

详细描述

成员函数文档

◆ add()

◆ clear()

◆ createBFMatcher()

◆ empty()

◆ getTrainDescriptors()

◆ isMaskSupported()

◆ knnMatch() [1/2]

◆ knnMatch() [2/2]

◆ knnMatchAsync() [1/2]

◆ knnMatchAsync() [2/2]

◆ knnMatchConvert()

◆ match() [1/2]

◆ match() [2/2]

◆ matchAsync() [1/2]

◆ matchAsync() [2/2]

◆ matchConvert()

◆ radiusMatch() [1/2]

◆ radiusMatch() [2/2]

◆ radiusMatchAsync() [1/2]

◆ radiusMatchAsync() [2/2]

◆ radiusMatchConvert()

◆ train()