CameraControl.autoFocus()

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

This method attempts to focus the camera. If the camera is able to attempt to focus, a success callback is issued, regardless of whether or not the focusing attempt succeeds. If unable to attempt to focus, an error callback is performed instead.

The success or failure of the focus operation is indicated by the value of a parameter passed into the callback function.

Syntax

CameraControl.autoFocus(onsuccess[, onerror]);

Parameters

onsuccess
A callback function called when a focus attempt is made
onerror Optional
An optional callback function that accepts an error string as an input parameter; this is called if it's not possible to attempt to focus the camera.

Example

function onFocusPossible( success ) {
  if ( success ) {
    console.log("The image has been focused");
  } else {
    console.log("The image has not been focused");
  }
}

function onFocusNotPossible( error ) {
  console.log("The camera is not able to focus anything");
  console.log( error );
}

function onAccessCamera( camera ) {
  camera.autoFocus(onFocusPossible, onFocusNotPossible);
};

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

navigator.mozCameras.getCamera(options, onAccessCamera)

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

Last updated by: chrisdavidmills,