CameraControl.autoFocus Redirect 1

Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

This API is available on Firefox OS for 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

Contributors to this page: Sheppy
Last updated by: Sheppy,