CameraControl.exposureCompensation

Non-standard
This feature is not on a current W3C standards track, but it is supported on the Firefox OS platform. Although implementations may change in the future and it is not supported widely across browsers, it is suitable for use in code dedicated to Firefox OS apps.

This API is available on Firefox OS for privileged or certified applications only.

Summary

The exposureCompensation property value is a number used to compensate the camera exposure.

This property is read-only; to change the exposure, you need to call the CameraControl.setExposureCompensation() method.

Acceptable values for this property must range from the value of the CameraCapabilities.minExposureCompensation property to the value of the CameraCapabilities.maxExposureCompensation property in steps of the CameraCapabilities.stepExposureCompensation property.

Invalid values are rounded to the nearest valid value.

Syntax

var exposure = instanceOfCameraControl.exposureCompensation

Value

Return a number representing the current exposure compensation.

Example

var options = {
  camera: navigator.mozCameras.getListOfCameras()[0]
};
 
function onSuccess( camera ) {
  var exposure = camera.exposureCompensation;

  console.log('Exposure compensation: ' + exposure);
};

navigator.mozCameras.getCamera(options, onSuccess)

Specification

Not part of any specification; however, this API should be removed when the WebRTC Capture and Stream API has been implemented.

See also

Document Tags and Contributors

Contributors to this page: chrisdavidmills, teoli, abhishekp, ajaybhat, kscarfone, Sheppy, Jeremie
Last updated by: chrisdavidmills,