ResolutionStrategy

const val FALLBACK_RULE_CLOSEST_HIGHER = 2: Int

When the specified bound size is unavailable, CameraX falls back to the closest higher resolution size.

const val FALLBACK_RULE_CLOSEST_HIGHER_THEN_LOWER = 1: Int

When the specified bound size is unavailable, CameraX falls back to select the closest higher resolution size. If CameraX still cannot find any available resolution, it will fallback to select other lower resolutions.

const val FALLBACK_RULE_CLOSEST_LOWER = 4: Int

When the specified bound size is unavailable, CameraX falls back to the closest lower resolution size.

const val FALLBACK_RULE_CLOSEST_LOWER_THEN_HIGHER = 3: Int

When the specified bound size is unavailable, CameraX falls back to select the closest lower resolution size. If CameraX still cannot find any available resolution, it will fallback to select other higher resolutions.

const val FALLBACK_RULE_NONE = 0: Int

CameraX doesn't select an alternate size when the specified bound size is unavailable.

Applications will receive IllegalArgumentException when binding the UseCases with this fallback rule if the device doesn't support the specified bound size.

const val HIGHEST_AVAILABLE_STRATEGY: ResolutionStrategy

A resolution strategy chooses the highest available resolution. This strategy does not have a bound size or fallback rule. When using this strategy, CameraX selects the available resolutions to use in descending order, starting with the highest quality resolution available.

ResolutionStrategy(boundSize: Size, fallbackRule: Int)

Creates a new ResolutionStrategy instance, configured with the specified bound size and fallback rule.

If the resolution candidate list contains the bound size and the bound size can fulfill all resolution selector settings, CameraX can also select the specified bound size as the result for the UseCase.

Some devices may have issues using sizes of the preferred aspect ratios. CameraX recommends that applications use the following fallback rule setting to avoid no resolution being available, as an IllegalArgumentException may be thrown when calling bindToLifecycle to bind UseCases with the ResolutionStrategy specified in the ResolutionSelector.

• FALLBACK_RULE_CLOSEST_HIGHER_THEN_LOWER
• FALLBACK_RULE_CLOSEST_LOWER_THEN_HIGHER

fun getBoundSize(): Size?

Returns the specified bound size.

fun getFallbackRule(): Int

Returns the fallback rule for choosing an alternate size when the specified bound size is unavailable.