CameraControl.takePicture()

Summary

Captures a still image from the camera and passes it as a Blob to a success callback handler, which can manipulate the image as you wish (for example, by manipulating its pixel data or storing it).

If the camera supports doing so, you may call this method while the camera is already recording video.

Syntax

CameraControl.takePicture(options, onsuccess[, onerror]);

Parameters

options

An object specifying options for the photo capture operation; see Options below.

onsuccess

A callback function to be invoked once the image has been captured. The function receives one parameter: a Blob containing a JPEG formatted image.

onerror Optional

An optional callback function that's invoked if an error occurs; it receives one parameter: an error string.

Options

The options object passed to this method has the following properties:

 

dateTime Optional

The time at which the image was captured, in seconds since the beginning of January 1, 1970 UTC. This date will be add to the EXIF header as the recording time of the photo.

fileFormat Optional

A string indicated the file format of the picture. This object must match one of the supported file format described in the CameraCapabilities object's fileFormats property.

pictureSize Optional

An object with two properties—width and height—indicating the size of image to capture. This object must match one of the supported image sizes described in the CameraCapabilities object's pictureSizes property. You may specify null to use the default size.

position Optional

An optional object that contains metadata that can be added to the captured image; this information describes geolocation data about where and when the photo was taken, as described in Position.

rotation Optional

The number of degrees clockwise to rotate the image upon capture.

Position

The position object, specified as a property of the options object, provides optional additional GPS metadata that can be attached to the captured image.

timestamp Optional

The time at which the image was captured, in seconds since the beginning of January 1, 1970 UTC.

altitude Optional

The altitude at which the image was captured, in meters above sea level.

latitude Optional

The latitude at which the image was captured, in degrees.

longitude Optional

The longitude at which the image was captured, in degrees.

Example

var storage = navigator.getDeviceStorage('pictures');
var cameraOptions = {
  camera: navigator.mozCameras.getListOfCameras()[0]
};
var pictureOptions = {
  rotation: 90,
  pictureSize: null,
  fileFormat: null
}

function onPictureTaken( blob ) {
  storage.addNamed(blob, 'myImage.jpg');
}

function onAccessCamera( camera ) {
  pictureOptions.pictureSize = camera.capabilities.pictureSizes[0];
  pictureOptions.fileformat  = camera.capabilities.fileFormats[0];

  camera.takePicture(pictureOptions, onPictureTaken);
};

navigator.mozCameras.getCamera(cameraOptions, 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
• CameraControl.resumePreview()
• Blob
• The DeviceStorage API