2016-02-09 06:30:01 +08:00
|
|
|
export interface CameraOptions {
|
|
|
|
/** Picture quality in range 0-100. Default is 50 */
|
|
|
|
quality?: number;
|
|
|
|
/**
|
|
|
|
* Choose the format of the return value.
|
|
|
|
* Defined in navigator.camera.DestinationType. Default is FILE_URI.
|
|
|
|
* DATA_URL : 0, Return image as base64-encoded string
|
|
|
|
* FILE_URI : 1, Return image file URI
|
|
|
|
* NATIVE_URI : 2 Return image native URI
|
|
|
|
* (e.g., assets-library:// on iOS or content:// on Android)
|
|
|
|
*/
|
|
|
|
destinationType?: number;
|
|
|
|
/**
|
|
|
|
* Set the source of the picture.
|
|
|
|
* Defined in navigator.camera.PictureSourceType. Default is CAMERA.
|
|
|
|
* PHOTOLIBRARY : 0,
|
|
|
|
* CAMERA : 1,
|
|
|
|
* SAVEDPHOTOALBUM : 2
|
|
|
|
*/
|
|
|
|
sourceType?: number;
|
|
|
|
/** Allow simple editing of image before selection. */
|
|
|
|
allowEdit?: boolean;
|
|
|
|
/**
|
|
|
|
* Choose the returned image file's encoding.
|
|
|
|
* Defined in navigator.camera.EncodingType. Default is JPEG
|
|
|
|
* JPEG : 0 Return JPEG encoded image
|
|
|
|
* PNG : 1 Return PNG encoded image
|
|
|
|
*/
|
|
|
|
encodingType?: number;
|
|
|
|
/**
|
|
|
|
* Width in pixels to scale image. Must be used with targetHeight.
|
|
|
|
* Aspect ratio remains constant.
|
|
|
|
*/
|
|
|
|
targetWidth?: number;
|
|
|
|
/**
|
|
|
|
* Height in pixels to scale image. Must be used with targetWidth.
|
|
|
|
* Aspect ratio remains constant.
|
|
|
|
*/
|
|
|
|
targetHeight?: number;
|
|
|
|
/**
|
|
|
|
* Set the type of media to select from. Only works when PictureSourceType
|
|
|
|
* is PHOTOLIBRARY or SAVEDPHOTOALBUM. Defined in nagivator.camera.MediaType
|
|
|
|
* PICTURE: 0 allow selection of still pictures only. DEFAULT.
|
|
|
|
* Will return format specified via DestinationType
|
|
|
|
* VIDEO: 1 allow selection of video only, WILL ALWAYS RETURN FILE_URI
|
|
|
|
* ALLMEDIA : 2 allow selection from all media types
|
|
|
|
*/
|
|
|
|
mediaType?: number;
|
|
|
|
/** Rotate the image to correct for the orientation of the device during capture. */
|
|
|
|
correctOrientation?: boolean;
|
|
|
|
/** Save the image to the photo album on the device after capture. */
|
|
|
|
saveToPhotoAlbum?: boolean;
|
|
|
|
/**
|
|
|
|
* Choose the camera to use (front- or back-facing).
|
|
|
|
* Defined in navigator.camera.Direction. Default is BACK.
|
|
|
|
* FRONT: 0
|
|
|
|
* BACK: 1
|
|
|
|
*/
|
|
|
|
cameraDirection?: number;
|
|
|
|
/** iOS-only options that specify popover location in iPad. Defined in CameraPopoverOptions. */
|
|
|
|
popoverOptions?: CameraPopoverOptions;
|
|
|
|
}
|
|
|
|
/**
|
|
|
|
* iOS-only parameters that specify the anchor element location and arrow direction
|
|
|
|
* of the popover when selecting images from an iPad's library or album.
|
|
|
|
*/
|
|
|
|
export interface CameraPopoverOptions {
|
|
|
|
x: number;
|
|
|
|
y: number;
|
|
|
|
width: number;
|
|
|
|
height: number;
|
|
|
|
/**
|
|
|
|
* Direction the arrow on the popover should point. Defined in Camera.PopoverArrowDirection
|
|
|
|
* Matches iOS UIPopoverArrowDirection constants.
|
|
|
|
* ARROW_UP : 1,
|
|
|
|
* ARROW_DOWN : 2,
|
|
|
|
* ARROW_LEFT : 4,
|
|
|
|
* ARROW_RIGHT : 8,
|
|
|
|
* ARROW_ANY : 15
|
|
|
|
*/
|
|
|
|
arrowDir: number;
|
|
|
|
}
|
2016-02-06 05:06:03 +08:00
|
|
|
/**
|
|
|
|
* Take a photo or capture video.
|
|
|
|
*
|
|
|
|
* Requires Cordova plugin: `cordova-plugin-camera`. For more info, please see the [Cordova Camera Plugin Docs](https://github.com/apache/cordova-plugin-camera).
|
|
|
|
*
|
|
|
|
* @usage
|
|
|
|
* ```js
|
|
|
|
* Camera.getPicture(options).then((imageData) => {
|
|
|
|
* // imageData is either a base64 encoded string or a file URI
|
|
|
|
* // If it's base64:
|
|
|
|
* let base64Image = "data:image/jpeg;base64," + imageData;
|
|
|
|
* }, (err) => {
|
|
|
|
* });
|
|
|
|
* ```
|
|
|
|
*/
|
2015-11-29 08:26:55 +08:00
|
|
|
export declare class Camera {
|
2016-02-09 06:30:01 +08:00
|
|
|
/**
|
|
|
|
* Take a picture or video, or load one from the library.
|
|
|
|
* @param {CameraOptions} options
|
|
|
|
* @return Returns a Promise that resolves with Base64 encoding of the image data, or the image file URI, depending on cameraOptions, otherwise rejects with an error.
|
|
|
|
*/
|
|
|
|
static getPicture(options: CameraOptions): Promise<any>;
|
|
|
|
/**
|
|
|
|
* Remove intermediate image files that are kept in temporary storage after calling camera.getPicture.
|
|
|
|
* Applies only when the value of Camera.sourceType equals Camera.PictureSourceType.CAMERA and the Camera.destinationType equals Camera.DestinationType.FILE_URI.
|
|
|
|
* @return Returns a Promise
|
|
|
|
*/
|
2015-11-30 09:54:45 +08:00
|
|
|
static cleanup(): void;
|
2015-11-29 08:26:55 +08:00
|
|
|
}
|