ResolutionBiasConstraint

interface ResolutionBiasConstraint

A constraint to bias the resolution of the given CameraOutput over other constraints.

Discussion

The resolution bias goes both ways; for example, if the given CameraOutput's resolution is very low, a Camera configuration most closely matching that low resolution will be used.

If there are two resolution bias constraints, one with a very high, and one with a very low output target resolution, a good "middle-ground" will be chosen.

Discussion

For outputs with an explicit target resolution (e.g. CameraVideoOutput or CameraPhotoOutput), resolution negotiation prefers aspect ratio matches over raw pixel count differences first, then uses a logarithmic scale to compare resolution differences. A CameraPreviewOutput instead only prefers Formats at least as large as the screen, ignoring aspect ratio (it fills the screen either way).

Examples

If Photo is more important than Video:

[
  { resolutionBias: photoOutput },
  { resolutionBias: videoOutput }
]

If Video is more important than Photo:

[
  { resolutionBias: videoOutput },
  { resolutionBias: photoOutput }
]

Properties

resolutionBias

resolutionBias: CameraOutput