surf
Class SURF

java.lang.Object
  surf.SURF

All Implemented Interfaces:

SURF_Factory

public class SURF
extends java.lang.Object
implements SURF_Factory

A standard implementation of the SURF_Factory interface.

Author:

Alessandro Martini, Claudio Fantacci

Method Summary

Descriptor	createDescriptor(java.util.ArrayList<Interest_Point> interest_points) Create the correct Descriptor.
Detector	createDetector() Create the correct Detector.
static SURF	createInstance(processing.core.PImage img, float balanceValue, float threshold, int octaves, processing.core.PApplet parent) Application of the Singleton Pattern.
static SURF	createInstance(processing.core.PImage img, float threshold, int octaves, processing.core.PApplet parent) Application of the Singleton Pattern.
float	getBalanceValue() Getter for the Balance Value.
Integral_Image	getIntegralImage() Getter for the Integral Image.
int	getOctaves() Getter for the octaves.
float	getThreshold() Getter for the threshold.
void	setBalanceValue(float balanceValue) Setter for the Balance Value.
void	setIntegralImage(processing.core.PImage img) Setter for the Integral Image.
void	setOctaves(int octaves) Setter for the octaves.
void	setThreshold(float threshold) Setter for the threshold.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createInstance

public static SURF createInstance(processing.core.PImage img,
                                  float balanceValue,
                                  float threshold,
                                  int octaves,
                                  processing.core.PApplet parent)

Application of the Singleton Pattern. Returns an instance of the class making sure that it is the only one. The method is STATIC so that any subclass that extends Singleton retains ownership of uniqueness of the instance.

Parameters:

img - PImage that is converted into Integral Image before it's assigned to SURF.

balanceValue - Value used to calculate the Laplacian of Gaussian response.

threshold - Value used to filter the Laplacian of Gaussian.

octaves - Number of octaves that you want to compute.

parent - PApplet where you display your video output.

Returns:

The single instance of SURF.

createInstance

public static SURF createInstance(processing.core.PImage img,
                                  float threshold,
                                  int octaves,
                                  processing.core.PApplet parent)

Application of the Singleton Pattern. Returns an instance of the class making sure that it is the only one. The method is STATIC so that any subclass that extends Singleton retains ownership of uniqueness of the instance. Here, the Balance Value has a standard value of 0.9.

Parameters:

img - PImage that is converted into Integral Image before it's assigned to SURF.

threshold - Value used to filter the Laplacian of Gaussian.

octaves - Number of octaves that you want to compute.

parent - PApplet where you display your video output.

Returns:

The single instance of SURF.

createDetector

public Detector createDetector()

Description copied from interface: SURF_Factory

Create the correct Detector.

Specified by:

createDetector in interface SURF_Factory

Returns:

A Detector object.

createDescriptor

public Descriptor createDescriptor(java.util.ArrayList<Interest_Point> interest_points)

Description copied from interface: SURF_Factory

Create the correct Descriptor.

Specified by:

createDescriptor in interface SURF_Factory

Parameters:

interest_points - ArrayList of Interest Point on which the descriptor will compute the descriptors.

Returns:

A Descriptor object.

getIntegralImage

public Integral_Image getIntegralImage()

Description copied from interface: SURF_Factory

Getter for the Integral Image.

Specified by:

getIntegralImage in interface SURF_Factory

Returns:

The Integral Image used by SURF.

setIntegralImage

public void setIntegralImage(processing.core.PImage img)

Description copied from interface: SURF_Factory

Setter for the Integral Image.

Specified by:

setIntegralImage in interface SURF_Factory

Parameters:

img - PImage that is converted into Integral Image before it's assigned to SURF.

getBalanceValue

public float getBalanceValue()

Description copied from interface: SURF_Factory

Getter for the Balance Value.

Specified by:

getBalanceValue in interface SURF_Factory

Returns:

The Balance Value. Its default value is 0.9.

setBalanceValue

public void setBalanceValue(float balanceValue)

Description copied from interface: SURF_Factory

Setter for the Balance Value.

Specified by:

setBalanceValue in interface SURF_Factory

Parameters:

balanceValue - Value used to calculate the Laplacian of Gaussian response.

getThreshold

public float getThreshold()

Description copied from interface: SURF_Factory

Getter for the threshold.

Specified by:

getThreshold in interface SURF_Factory

Returns:

The threshold value.

setThreshold

public void setThreshold(float threshold)

Description copied from interface: SURF_Factory

Setter for the threshold.

Specified by:

setThreshold in interface SURF_Factory

Parameters:

threshold - Value used to filter the Laplacian of Gaussian.

getOctaves

public int getOctaves()

Description copied from interface: SURF_Factory

Getter for the octaves.

Specified by:

getOctaves in interface SURF_Factory

Returns:

Number of octaves computed in SURF.

setOctaves

public void setOctaves(int octaves)

Description copied from interface: SURF_Factory

Setter for the octaves.

Specified by:

setOctaves in interface SURF_Factory

Parameters:

octaves - Number of octaves that you want to compute.