mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-01 06:35:42 +00:00
76 lines
2.3 KiB
Plaintext
76 lines
2.3 KiB
Plaintext
/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* vim: set ts=2 et sw=2 tw=80: */
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
|
|
* You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
*/
|
|
|
|
dictionary CameraPictureOptions {
|
|
|
|
/* an object with a combination of 'height' and 'width' properties
|
|
chosen from nsICameraCapabilities.pictureSizes */
|
|
// XXXbz this should be a CameraSize dictionary, but we don't have that yet.
|
|
any pictureSize = null;
|
|
|
|
/* one of the file formats chosen from
|
|
nsICameraCapabilities.fileFormats */
|
|
DOMString fileFormat = "";
|
|
|
|
/* the rotation of the image in degrees, from 0 to 270 in
|
|
steps of 90; this doesn't affect the image, only the
|
|
rotation recorded in the image header.*/
|
|
long rotation = 0;
|
|
|
|
/* an object containing any or all of 'latitude', 'longitude',
|
|
'altitude', and 'timestamp', used to record when and where
|
|
the image was taken. e.g.
|
|
{
|
|
latitude: 43.647118,
|
|
longitude: -79.3943,
|
|
altitude: 500
|
|
// timestamp not specified, in this case, and
|
|
// won't be included in the image header
|
|
}
|
|
|
|
can be null in the case where position information isn't
|
|
available/desired.
|
|
|
|
'altitude' is in metres; 'timestamp' is UTC, in seconds from
|
|
January 1, 1970.
|
|
*/
|
|
any position = null;
|
|
|
|
/* the number of seconds from January 1, 1970 UTC. This can be
|
|
different from the positional timestamp (above). */
|
|
// XXXbz this should really accept a date too, no?
|
|
long long dateTime = 0;
|
|
};
|
|
|
|
// If we start using CameraPictureOptions here, remove it from DummyBinding.
|
|
|
|
interface GetCameraCallback;
|
|
interface CameraErrorCallback;
|
|
|
|
/* Select a camera to use. */
|
|
dictionary CameraSelector {
|
|
DOMString camera = "back";
|
|
};
|
|
|
|
interface CameraManager {
|
|
/* get a camera instance; options will be used to specify which
|
|
camera to get from the list returned by getListOfCameras(), e.g.:
|
|
{
|
|
camera: "front"
|
|
}
|
|
*/
|
|
[Throws]
|
|
void getCamera(CameraSelector options, GetCameraCallback callback,
|
|
optional CameraErrorCallback errorCallback);
|
|
|
|
/* return an array of camera identifiers, e.g.
|
|
[ "front", "back" ]
|
|
*/
|
|
[Throws]
|
|
sequence<DOMString> getListOfCameras();
|
|
};
|