com.otaliastudios.cameraview

Class SizeSelectors

java.lang.Object

com.otaliastudios.cameraview.SizeSelectors

public class SizeSelectors
extends java.lang.Object

Static utilities to create, join and merge SizeSelectors instances.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SizeSelectors.Filter A size constraint to easily filter out sizes in a list.

Constructor Summary

Constructors

Constructor and Description
SizeSelectors()

Method Summary

Modifier and Type	Method and Description
static SizeSelector	and(SizeSelector... selectors) Joins all the given selectors to create a new one that returns the intersection of all the inputs.
static SizeSelector	aspectRatio(AspectRatio ratio, float delta) Returns a new SizeSelector that keeps only sizes which respect the given AspectRatio.
static SizeSelector	biggest() Returns a SizeSelector that will order sizes from the biggest to the smallest.
static SizeSelector	maxArea(int area) Returns a new SizeSelector that keeps only sizes whose area is at most equal to the given area in pixels.
static SizeSelector	maxHeight(int height) Returns a new SizeSelector that keeps only sizes whose height is at most equal to the given height.
static SizeSelector	maxWidth(int width) Returns a new SizeSelector that keeps only sizes whose width is at most equal to the given width.
static SizeSelector	minArea(int area) Returns a new SizeSelector that keeps only sizes whose area is at least equal to the given area in pixels.
static SizeSelector	minHeight(int height) Returns a new SizeSelector that keeps only sizes whose height is at least equal to the given height.
static SizeSelector	minWidth(int width) Returns a new SizeSelector that keeps only sizes whose width is at least equal to the given width.
static SizeSelector	or(SizeSelector... selectors) Creates a new SizeSelector that 'or's the given filters.
static SizeSelector	smallest() Returns a SizeSelector that will order sizes from the smallest to the biggest.
static SizeSelector	withFilter(SizeSelectors.Filter filter) Returns a new SizeSelector with the given SizeSelectors.Filter.

Methods inherited from class java.lang.Object

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

Constructor Detail

SizeSelectors

public SizeSelectors()

Method Detail

withFilter

public static SizeSelector withFilter(@NonNull
                                      SizeSelectors.Filter filter)

Returns a new SizeSelector with the given SizeSelectors.Filter. This kind of selector will respect the order in the source array.

Parameters:

filter - a filter

Returns:

a new selector

maxWidth

public static SizeSelector maxWidth(int width)

Returns a new SizeSelector that keeps only sizes whose width is at most equal to the given width.

Parameters:

width - the max width

Returns:

a new selector

minWidth

public static SizeSelector minWidth(int width)

Returns a new SizeSelector that keeps only sizes whose width is at least equal to the given width.

Parameters:

width - the min width

Returns:

a new selector

maxHeight

public static SizeSelector maxHeight(int height)

Returns a new SizeSelector that keeps only sizes whose height is at most equal to the given height.

Parameters:

height - the max height

Returns:

a new selector

minHeight

public static SizeSelector minHeight(int height)

Returns a new SizeSelector that keeps only sizes whose height is at least equal to the given height.

Parameters:

height - the min height

Returns:

a new selector

aspectRatio

public static SizeSelector aspectRatio(AspectRatio ratio,
                                       float delta)

Returns a new SizeSelector that keeps only sizes which respect the given AspectRatio. You can pass a tolerance value to include aspect ratios that are slightly different.

Parameters:

ratio - the desired aspect ratio

delta - a small tolerance value

Returns:

a new selector

biggest

public static SizeSelector biggest()

Returns a SizeSelector that will order sizes from the biggest to the smallest. This means that the biggest size will be taken.

Returns:

a new selector

smallest

public static SizeSelector smallest()

Returns a SizeSelector that will order sizes from the smallest to the biggest. This means that the smallest size will be taken.

Returns:

a new selector

maxArea

public static SizeSelector maxArea(int area)

Returns a new SizeSelector that keeps only sizes whose area is at most equal to the given area in pixels.

Parameters:

area - the max area

Returns:

a new selector

minArea

public static SizeSelector minArea(int area)

Returns a new SizeSelector that keeps only sizes whose area is at least equal to the given area in pixels.

Parameters:

area - the min area

Returns:

a new selector

and

public static SizeSelector and(SizeSelector... selectors)

Joins all the given selectors to create a new one that returns the intersection of all the inputs. Basically, all constraints are respected. Keep in mind there is good chance that the final list will be empty.

Parameters:

selectors - input selectors

Returns:

a new selector

or

public static SizeSelector or(SizeSelector... selectors)

Creates a new SizeSelector that 'or's the given filters. If the first selector returns an empty list, the next selector is queried, and so on until a non-empty list is found.

Parameters:

selectors - input selectors

Returns:

a new selector