org.bytedeco.javacpp

Class opencv_core.KeyPoint

java.lang.Object

org.bytedeco.javacpp.Pointer

org.bytedeco.javacpp.opencv_core.KeyPoint

All Implemented Interfaces:

AutoCloseable

Direct Known Subclasses:

opencv_xfeatures2d.Elliptic_KeyPoint

Enclosing class:

opencv_core

@Namespace(value="cv")
 @NoOffset
public static class opencv_core.KeyPoint
extends org.bytedeco.javacpp.Pointer

\brief Data structure for salient point detectors.

The class instance stores a keypoint, i.e. a point feature found by one of many available keypoint detectors, such as Harris corner detector, #FAST, %StarDetector, %SURF, %SIFT etc.

The keypoint is characterized by the 2D position, scale (proportional to the diameter of the neighborhood that needs to be taken into account), orientation and some other parameters. The keypoint neighborhood is then analyzed by another algorithm that builds a descriptor (usually represented as a feature vector). The keypoints representing the same object in different images can then be matched using %KDTree or another method.

Nested Class Summary

Nested classes/interfaces inherited from class org.bytedeco.javacpp.Pointer

org.bytedeco.javacpp.Pointer.CustomDeallocator, org.bytedeco.javacpp.Pointer.Deallocator, org.bytedeco.javacpp.Pointer.NativeDeallocator

Field Summary

Fields inherited from class org.bytedeco.javacpp.Pointer

address, capacity, limit, position

Constructor Summary

Constructors

Constructor and Description
KeyPoint() the default constructor
KeyPoint(float x, float y, float _size)
KeyPoint(float x, float y, float _size, float _angle, float _response, int _octave, int _class_id)
KeyPoint(long size) Native array allocator.
KeyPoint(opencv_core.Point2f _pt, float _size)
KeyPoint(opencv_core.Point2f _pt, float _size, float _angle, float _response, int _octave, int _class_id)
KeyPoint(org.bytedeco.javacpp.Pointer p) Pointer cast constructor.

Method Summary

Modifier and Type	Method and Description
float	angle() computed orientation of the keypoint (-1 if not applicable); it's in [0,360) degrees and measured relative to image coordinate system, ie in clockwise.
opencv_core.KeyPoint	angle(float angle)
int	class_id() object class (if the keypoints need to be clustered by an object they belong to)
opencv_core.KeyPoint	class_id(int class_id)
static void	convert(opencv_core.KeyPointVector keypoints, opencv_core.Point2fVector points2f)
static void	convert(opencv_core.KeyPointVector keypoints, opencv_core.Point2fVector points2f, int[] keypointIndexes)
static void	convert(opencv_core.KeyPointVector keypoints, opencv_core.Point2fVector points2f, IntBuffer keypointIndexes)
static void	convert(opencv_core.KeyPointVector keypoints, opencv_core.Point2fVector points2f, org.bytedeco.javacpp.IntPointer keypointIndexes) This method converts vector of keypoints to vector of points or the reverse, where each keypoint is assigned the same size and the same orientation.
static void	convert(opencv_core.Point2fVector points2f, opencv_core.KeyPointVector keypoints)
static void	convert(opencv_core.Point2fVector points2f, opencv_core.KeyPointVector keypoints, float size, float response, int octave, int class_id) \overload
long	hash()
int	octave() octave (pyramid layer) from which the keypoint has been extracted
opencv_core.KeyPoint	octave(int octave)
static float	overlap(opencv_core.KeyPoint kp1, opencv_core.KeyPoint kp2) This method computes overlap for pair of keypoints.
opencv_core.KeyPoint	position(long position)
opencv_core.Point2f	pt() coordinates of the keypoints
opencv_core.KeyPoint	pt(opencv_core.Point2f pt)
float	response() the response by which the most strong keypoints have been selected.
opencv_core.KeyPoint	response(float response)
float	size() diameter of the meaningful keypoint neighborhood
opencv_core.KeyPoint	size(float size)

Methods inherited from class org.bytedeco.javacpp.Pointer

address, asBuffer, asByteBuffer, availablePhysicalBytes, calloc, capacity, capacity, close, deallocate, deallocate, deallocateReferences, deallocator, deallocator, equals, fill, formatBytes, free, hashCode, isNull, limit, limit, malloc, maxBytes, maxPhysicalBytes, memchr, memcmp, memcpy, memmove, memset, offsetof, parseBytes, physicalBytes, position, put, realloc, setNull, sizeof, toString, totalBytes, totalPhysicalBytes, withDeallocator, zero

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

KeyPoint

public KeyPoint(org.bytedeco.javacpp.Pointer p)

Pointer cast constructor. Invokes Pointer.Pointer(Pointer).

KeyPoint

public KeyPoint(long size)

Native array allocator. Access with Pointer.position(long).

KeyPoint

public KeyPoint()

the default constructor

KeyPoint

public KeyPoint(@ByVal
                opencv_core.Point2f _pt,
                float _size,
                float _angle,
                float _response,
                int _octave,
                int _class_id)

Parameters:

_pt - x & y coordinates of the keypoint

_size - keypoint diameter

_angle - keypoint orientation

_response - keypoint detector response on the keypoint (that is, strength of the keypoint)

_octave - pyramid octave in which the keypoint has been detected

_class_id - object id

KeyPoint

public KeyPoint(@ByVal
                opencv_core.Point2f _pt,
                float _size)

KeyPoint

public KeyPoint(float x,
                float y,
                float _size,
                float _angle,
                float _response,
                int _octave,
                int _class_id)

Parameters:

x - x-coordinate of the keypoint

y - y-coordinate of the keypoint

_size - keypoint diameter

_angle - keypoint orientation

_response - keypoint detector response on the keypoint (that is, strength of the keypoint)

_octave - pyramid octave in which the keypoint has been detected

_class_id - object id

KeyPoint

public KeyPoint(float x,
                float y,
                float _size)

Method Detail

position

public opencv_core.KeyPoint position(long position)

Overrides:

position in class org.bytedeco.javacpp.Pointer

hash

@Cast(value="size_t")
public long hash()

convert

public static void convert(@Const @ByRef
                           opencv_core.KeyPointVector keypoints,
                           @ByRef
                           opencv_core.Point2fVector points2f,
                           @StdVector
                           org.bytedeco.javacpp.IntPointer keypointIndexes)

This method converts vector of keypoints to vector of points or the reverse, where each keypoint is assigned the same size and the same orientation.

Parameters:

keypoints - Keypoints obtained from any feature detection algorithm like SIFT/SURF/ORB

points2f - Array of (x,y) coordinates of each keypoint

keypointIndexes - Array of indexes of keypoints to be converted to points. (Acts like a mask to convert only specified keypoints)

convert

public static void convert(@Const @ByRef
                           opencv_core.KeyPointVector keypoints,
                           @ByRef
                           opencv_core.Point2fVector points2f)

convert

public static void convert(@Const @ByRef
                           opencv_core.KeyPointVector keypoints,
                           @ByRef
                           opencv_core.Point2fVector points2f,
                           @StdVector
                           IntBuffer keypointIndexes)

convert

public static void convert(@Const @ByRef
                           opencv_core.KeyPointVector keypoints,
                           @ByRef
                           opencv_core.Point2fVector points2f,
                           @StdVector
                           int[] keypointIndexes)

convert

public static void convert(@Const @ByRef
                           opencv_core.Point2fVector points2f,
                           @ByRef
                           opencv_core.KeyPointVector keypoints,
                           float size,
                           float response,
                           int octave,
                           int class_id)

\overload

Parameters:

points2f - Array of (x,y) coordinates of each keypoint

keypoints - Keypoints obtained from any feature detection algorithm like SIFT/SURF/ORB

size - keypoint diameter

response - keypoint detector response on the keypoint (that is, strength of the keypoint)

octave - pyramid octave in which the keypoint has been detected

class_id - object id

convert

public static void convert(@Const @ByRef
                           opencv_core.Point2fVector points2f,
                           @ByRef
                           opencv_core.KeyPointVector keypoints)

overlap

public static float overlap(@Const @ByRef
                            opencv_core.KeyPoint kp1,
                            @Const @ByRef
                            opencv_core.KeyPoint kp2)

This method computes overlap for pair of keypoints. Overlap is the ratio between area of keypoint regions' intersection and area of keypoint regions' union (considering keypoint region as circle). If they don't overlap, we get zero. If they coincide at same location with same size, we get 1.

Parameters:

kp1 - First keypoint

kp2 - Second keypoint

pt

@ByRef
public opencv_core.Point2f pt()

coordinates of the keypoints

pt

public opencv_core.KeyPoint pt(opencv_core.Point2f pt)

size

public float size()

diameter of the meaningful keypoint neighborhood

size

public opencv_core.KeyPoint size(float size)

angle

public float angle()

computed orientation of the keypoint (-1 if not applicable); it's in [0,360) degrees and measured relative to image coordinate system, ie in clockwise.

angle

public opencv_core.KeyPoint angle(float angle)

response

public float response()

the response by which the most strong keypoints have been selected. Can be used for the further sorting or subsampling

response

public opencv_core.KeyPoint response(float response)

octave

public int octave()

octave (pyramid layer) from which the keypoint has been extracted

octave

public opencv_core.KeyPoint octave(int octave)

class_id

public int class_id()

object class (if the keypoints need to be clustered by an object they belong to)

class_id

public opencv_core.KeyPoint class_id(int class_id)