CameraControl.autoFocus()

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

• CameraControl