imgfeatures.h File Reference

#include <mrpt/otherlibs/do_opencv_includes.h>

Go to the source code of this file.

Classes
struct	feature
	Structure to represent an affine invariant image feature. More...

Macros
#define	FEATURE_OXFD_COLOR   CV_RGB(255, 255, 0)
#define	FEATURE_LOWE_COLOR   CV_RGB(255, 0, 255)
#define	FEATURE_MAX_D   128
	max feature descriptor length More...

Enumerations
enum	feature_type { FEATURE_OXFD, FEATURE_LOWE }
	FEATURE_OXFD FEATURE_LOWE. More...
enum	feature_match_type { FEATURE_FWD_MATCH, FEATURE_BCK_MATCH, FEATURE_MDL_MATCH }
	FEATURE_FWD_MATCH FEATURE_BCK_MATCH FEATURE_MDL_MATCH. More...

Functions
int	import_features (char *filename, int type, struct feature **feat)
	Reads image features from file. More...
int	export_features (char *filename, struct feature *feat, int n)
	Exports a feature set to a file formatted depending on the type of features, as specified in the feature struct's type field. More...
void	draw_features (IplImage *img, struct feature *feat, int n)
	Displays a set of features on an image More...
double	descr_dist_sq (struct feature *f1, struct feature *f2)
	Calculates the squared Euclidian distance between two feature descriptors. More...

Macro Definition Documentation

FEATURE_LOWE_COLOR

#define FEATURE_LOWE_COLOR   CV_RGB(255, 0, 255)

Definition at line 38 of file imgfeatures.h.

FEATURE_MAX_D

#define FEATURE_MAX_D   128

max feature descriptor length

Definition at line 41 of file imgfeatures.h.

FEATURE_OXFD_COLOR

#define FEATURE_OXFD_COLOR   CV_RGB(255, 255, 0)

Definition at line 37 of file imgfeatures.h.

Enumeration Type Documentation

feature_match_type

enum feature_match_type

FEATURE_FWD_MATCH
FEATURE_BCK_MATCH
FEATURE_MDL_MATCH.

Enumerator
FEATURE_FWD_MATCH
FEATURE_BCK_MATCH
FEATURE_MDL_MATCH

Definition at line 29 of file imgfeatures.h.

feature_type

enum feature_type

FEATURE_OXFD
FEATURE_LOWE.

Enumerator
FEATURE_OXFD
FEATURE_LOWE

Definition at line 22 of file imgfeatures.h.

Function Documentation

descr_dist_sq()

double descr_dist_sq	(	struct feature *	f1,
		struct feature *	f2
	)

Calculates the squared Euclidian distance between two feature descriptors.

Parameters

f1	first feature
f2	second feature

Returns

Returns the squared Euclidian distance between the descriptors of f1 and f2.

draw_features()

void draw_features	(	IplImage *	img,
		struct feature *	feat,
		int	n
	)

Displays a set of features on an image

Parameters

img	image on which to display features
feat	array of Oxford-type features
n	number of features

export_features()

int export_features	(	char *	filename,
		struct feature *	feat,
		int	n
	)

Exports a feature set to a file formatted depending on the type of features, as specified in the feature struct's type field.

Parameters

filename	name of file to which to export features
feat	feature array
n	number of features

Returns

Returns 0 on success or 1 on error

import_features()

int import_features	(	char *	filename,
		int	type,
		struct feature **	feat
	)

Reads image features from file.

The file should be formatted as from the code provided by the Visual Geometry Group at Oxford or from the code provided by David Lowe.

Parameters

filename	location of a file containing image features
type	determines how features are input. If type is FEATURE_OXFD, the input file is treated as if it is from the code provided by the VGG at Oxford: http://www.robots.ox.ac.uk:5000/~vgg/research/affine/index.html If type is FEATURE_LOWE, the input file is treated as if it is from David Lowe's SIFT code: http://www.cs.ubc.ca/~lowe/keypoints
feat	pointer to an array in which to store imported features

Returns

Returns the number of features imported from filename or -1 on error