Package boofcv.alg.feature.detect.selector

Interface FeatureSelectLimitIntensity<Point>

All Known Implementing Classes:

ConvertLimitToIntensity, FeatureSelectNBest, FeatureSelectUniformBest

public interface FeatureSelectLimitIntensity<Point>

Selects features inside the image until it hits a limit. Feature intensity is available to aide in the selection process. By using SampleIntensity it's possible to support approaches which use the intensity image and ones which have features with intensity image and no access to an intensity image.

Method Summary

Modifier and Type	Method	Description
void	select(@Nullable GrayF32 intensity, int width, int height, boolean positive, @Nullable FastAccess<Point> prior, FastAccess<Point> detected, int limit, FastArray<Point> selected)	Selects features using a rule given the limit on detection objects.
void	setSampler(SampleIntensity<Point> sampler)	Specifies how the intensity will be sampled.

Method Details

select

void select(@Nullable
 @Nullable GrayF32 intensity,
 int width,
 int height,
 boolean positive,
 @Nullable
 @Nullable FastAccess<Point> prior,
 FastAccess<Point> detected,
 int limit,
 FastArray<Point> selected)

Selects features using a rule given the limit on detection objects. If the limit is higher than the number of detected features and prior is null then the detected features should be copied into selected. How prior features are used is dependent upon the implementation and their affect isn't specified in general.

NOTE: The reason a null input image is supported is for the situation where the intensity image is no longer available and intensity has been copied into points. See SIFT

Parameters:

intensity - (Input) Intensity image. If null that means the point will provide intensity information. Nullable.

width - (Input) if image is null then this must be the image's width

height - (Input) if image is null then this must be the image's height

positive - (Input) true if better features have more positive values, false if it's more negative values

prior - (Input) Locations of previously detected features. Nullable

detected - (Input) Locations of newly detected features

limit - (Input) The maximum number of new features detected

selected - (Output) Selected features. Element count not exceed the limit. Reset on every call.

setSampler

void setSampler(SampleIntensity<Point> sampler)

Specifies how the intensity will be sampled.