org.openimaj.image.objectdetection

Interface ObjectDetector<IMAGE extends Image<?,IMAGE>,DETECTED_OBJECT>

Type Parameters:

IMAGE - The image on which to perform the detection

DETECTED_OBJECT - the type of object representing a detection.

All Known Subinterfaces:

MultiScaleObjectDetector<IMAGE,DETECTED_OBJECT>

All Known Implementing Classes:

AbstractMultiScaleObjectDetector, Detector, FilteringObjectDetector, HOGDetector, MultiThreadedDetector, RotationSimulationObjectDetector

public interface ObjectDetector<IMAGE extends Image<?,IMAGE>,DETECTED_OBJECT>

Interface describing a basic object detector for images. Any type of Java object can be used to represent a detection; this could be something as simple as a Rectangle representing the spatial location of the detection, or it could be much more complex.

The interface allows for multiple detections to be returned from the input image. If required, these detections could be filtered by a DetectionFilter as a post-processing operation.

This interface is implicitly for single-scale detection. If your detector works at multiple scales, then implementing the MultiScaleObjectDetector would be a better idea.

Author:

Jonathon Hare (jsh2@ecs.soton.ac.uk)

Method Summary

Modifier and Type	Method and Description
List<DETECTED_OBJECT>	detect(IMAGE image) Detect objects in the given image and return representations of them.
void	setROI(Rectangle roi) (Optional operation).

Method Detail

detect

List<DETECTED_OBJECT> detect(IMAGE image)

Detect objects in the given image and return representations of them. Representations often cover things like the spatial location in the image of the detected object, however, this is implementation defined.

If no objects are detected, null or an empty list may be returned.

Parameters:

image - the image to detect the object in.

Returns:

a list of detections or null if none are found.

setROI

void setROI(Rectangle roi)

(Optional operation).

Set the region of interest within the image to search for objects. Setting to null means to search the whole image.

Parameters:

roi - the region of interest