' +
400 | 'Options not specified should be the default value' +
401 | ' Status box should update with image and info whenever an image is taken or selected from library' +
402 | '
' +
403 | '
All default options. Should be able to edit once picture is taken and will be saved to library.
' +
404 | '
sourceType=PHOTOLIBRARY Should be able to see picture that was just taken in previous test and edit when selected
' +
405 | '
sourceType=Camera allowEdit=false saveToPhotoAlbum=false Should not be able to edit when taken and will not save to library
' +
406 | '
encodingType=PNG allowEdit=true saveToPhotoAlbum=true cameraDirection=FRONT Should bring up front camera. Verify in status box info URL that image is encoded as PNG.
' +
407 | '
sourceType=SAVEDPHOTOALBUM mediaType=VIDEO Should only be able to select a video
' +
408 | '
sourceType=SAVEDPHOTOALBUM mediaType=PICTURE allowEdit=false Should only be able to select a picture and not edit
' +
409 | '
sourceType=PHOTOLIBRARY mediaType=ALLMEDIA allowEdit=true Should be able to select pics and videos and edit picture if selected
' +
410 | '
sourceType=CAMERA targetWidth & targetHeight=50 allowEdit=false Do Get File Metadata test below and take note of size Repeat test but with width and height=800. Size should be significantly larger.
' +
411 | '
quality=0 targetWidth & targetHeight=default allowEdit=false Do Get File Metadata test below and take note of size Repeat test but with quality=80. Size should be significantly larger.
' +
412 | '
';
413 | const inputs_div = '
Native File Inputs
' +
414 | 'For the following tests, status box should update with file selected' +
415 | '
input type=file
' +
416 | '
capture=camera
' +
417 | '
capture=camcorder
' +
418 | '
capture=microphone
';
419 | const actions_div = '
Actions
' +
420 | 'For the following tests, ensure that an image is set in status box' +
421 | '' +
422 | 'Expected result: Get metadata about file selected. Status box will show, along with the metadata, "Call to FileEntry.getMetadata success, Call to FileEntry.setMetadata success, Call to FileEntry.getParent success"' +
423 | '' +
424 | 'Expected result: Read contents of file. Status box will show "Got file: {some metadata}, FileReader.readAsDataURL() - length = someNumber"' +
425 | '' +
426 | 'Expected result: Copy image to new location and move file to different location. Status box will show "Call to FileEntry.copyTo success:{some metadata}, Call to FileEntry.moveTo success:{some metadata}"' +
427 | '' +
428 | 'Expected result: Write image to library. Status box will show "Call to FileWriter.write success:{some metadata}, Call to FileWriter.truncate success:{some metadata}"' +
429 | '' +
430 | 'Expected result: Upload image to server. Status box may print out progress. Once finished will show "upload complete"' +
431 | '' +
432 | 'Expected result: Display image using canvas. Image will be displayed in status box under "canvas:"' +
433 | '' +
434 | 'Expected result: Remove image from library. Status box will show "FileEntry.remove success:["OK"]';
435 |
436 | contentEl.innerHTML = info_div + options_div + getpicture_div + test_procedure + inputs_div + actions_div;
437 |
438 | const elements = document.getElementsByClassName('testInputTag');
439 | const listener = function (e) {
440 | testInputTag(e.target);
441 | };
442 | for (let i = 0; i < elements.length; ++i) {
443 | const item = elements[i];
444 | item.addEventListener('change', listener, false);
445 | }
446 |
447 | createActionButton('Get picture', function () {
448 | getPicture();
449 | }, 'getpicture');
450 |
451 | createActionButton('Clear Status', function () {
452 | clearStatus();
453 | }, 'getpicture');
454 |
455 | createActionButton('Get File Metadata', function () {
456 | getFileInfo();
457 | }, 'metadata');
458 |
459 | createActionButton('Read with FileReader', function () {
460 | readFile();
461 | }, 'reader');
462 |
463 | createActionButton('Copy Image', function () {
464 | copyImage();
465 | }, 'copy');
466 |
467 | createActionButton('Write Image', function () {
468 | writeImage();
469 | }, 'write');
470 |
471 | createActionButton('Draw Using Canvas', function () {
472 | displayImageUsingCanvas();
473 | }, 'draw_canvas');
474 |
475 | createActionButton('Remove Image', function () {
476 | removeImage();
477 | }, 'remove');
478 | };
479 |
--------------------------------------------------------------------------------
/types/index.d.ts:
--------------------------------------------------------------------------------
1 | // Type definitions for Apache Cordova Camera plugin
2 | // Project: https://github.com/apache/cordova-plugin-camera
3 | // Definitions by: Microsoft Open Technologies Inc
4 | // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
5 | //
6 | // Copyright (c) Microsoft Open Technologies Inc
7 | // Licensed under the MIT license.
8 |
9 | interface Navigator {
10 | /**
11 | * This plugin provides an API for taking pictures and for choosing images from the system's image library.
12 | */
13 | camera: Camera;
14 | }
15 |
16 | /**
17 | * This plugin provides an API for taking pictures and for choosing images from the system's image library.
18 | */
19 | interface Camera {
20 | /**
21 | * Removes intermediate photos taken by the camera from temporary storage.
22 | * @param onSuccess Success callback, that called when cleanup succeeds.
23 | * @param onError Error callback, that get an error message.
24 | */
25 | cleanup(
26 | onSuccess: () => void,
27 | onError: (message: string) => void): void;
28 | /**
29 | * Takes a photo using the camera, or retrieves a photo from the device's image gallery.
30 | * @param cameraSuccess Success callback, that get the image
31 | * as a base64-encoded String, or as the URI for the image file.
32 | * @param cameraError Error callback, that get an error message.
33 | * @param cameraOptions Optional parameters to customize the camera settings.
34 | */
35 | getPicture(
36 | cameraSuccess: (data: string) => void,
37 | cameraError: (message: string) => void,
38 | cameraOptions?: CameraOptions): void;
39 | // Next will work only on iOS
40 | //getPicture(
41 | // cameraSuccess: (data: string) => void,
42 | // cameraError: (message: string) => void,
43 | // cameraOptions?: CameraOptions): CameraPopoverHandle;
44 | }
45 |
46 | interface CameraOptions {
47 | /** Picture quality in range 0-100. Default is 50 */
48 | quality?: number;
49 | /**
50 | * Choose the format of the return value.
51 | * Defined in navigator.camera.DestinationType. Default is FILE_URI.
52 | * DATA_URL : 0, Return image as base64-encoded string
53 | * FILE_URI : 1, Return image file URI
54 | */
55 | destinationType?: number;
56 | /**
57 | * Set the source of the picture.
58 | * Defined in navigator.camera.PictureSourceType. Default is CAMERA.
59 | * PHOTOLIBRARY : 0,
60 | * CAMERA : 1,
61 | * SAVEDPHOTOALBUM : 2
62 | */
63 | sourceType?: number;
64 | /** Allow simple editing of image before selection. */
65 | allowEdit?: boolean;
66 | /**
67 | * Choose the returned image file's encoding.
68 | * Defined in navigator.camera.EncodingType. Default is JPEG
69 | * JPEG : 0 Return JPEG encoded image
70 | * PNG : 1 Return PNG encoded image
71 | */
72 | encodingType?: number;
73 | /**
74 | * Width in pixels to scale image. Must be used with targetHeight.
75 | * Aspect ratio remains constant.
76 | */
77 | targetWidth?: number;
78 | /**
79 | * Height in pixels to scale image. Must be used with targetWidth.
80 | * Aspect ratio remains constant.
81 | */
82 | targetHeight?: number;
83 | /**
84 | * Set the type of media to select from. Only works when PictureSourceType
85 | * is PHOTOLIBRARY or SAVEDPHOTOALBUM. Defined in nagivator.camera.MediaType
86 | * PICTURE: 0 allow selection of still pictures only. DEFAULT.
87 | * Will return format specified via DestinationType
88 | * VIDEO: 1 allow selection of video only, WILL ALWAYS RETURN FILE_URI
89 | * ALLMEDIA : 2 allow selection from all media types
90 | */
91 | mediaType?: number;
92 | /** Rotate the image to correct for the orientation of the device during capture. */
93 | correctOrientation?: boolean;
94 | /** Save the image to the photo album on the device after capture. */
95 | saveToPhotoAlbum?: boolean;
96 | /**
97 | * Choose the camera to use (front- or back-facing).
98 | * Defined in navigator.camera.Direction. Default is BACK.
99 | * FRONT: 0
100 | * BACK: 1
101 | */
102 | cameraDirection?: number;
103 | /** iOS-only options that specify popover location in iPad. Defined in CameraPopoverOptions. */
104 | popoverOptions?: CameraPopoverOptions;
105 | }
106 |
107 | /**
108 | * A handle to the popover dialog created by navigator.camera.getPicture. Used on iOS only.
109 | */
110 | interface CameraPopoverHandle {
111 | /**
112 | * Set the position of the popover.
113 | * @param popoverOptions the CameraPopoverOptions that specify the new position.
114 | */
115 | setPosition(popoverOptions: CameraPopoverOptions): void;
116 | }
117 |
118 | /**
119 | * iOS-only parameters that specify the anchor element location and arrow direction
120 | * of the popover when selecting images from an iPad's library or album.
121 | */
122 | interface CameraPopoverOptions {
123 | x: number;
124 | y: number;
125 | width: number;
126 | height: number;
127 | /**
128 | * Direction the arrow on the popover should point. Defined in Camera.PopoverArrowDirection
129 | * Matches iOS UIPopoverArrowDirection constants.
130 | * ARROW_UP : 1,
131 | * ARROW_DOWN : 2,
132 | * ARROW_LEFT : 4,
133 | * ARROW_RIGHT : 8,
134 | * ARROW_ANY : 15
135 | */
136 | arrowDir : number;
137 | popoverWidth: number;
138 | popoverHeight: number;
139 | }
140 |
141 | declare class CameraPopoverOptions implements CameraPopoverOptions {
142 | constructor(x?: number, y?: number, width?: number, height?: number, arrowDir?: number);
143 | }
144 |
145 | declare var Camera: {
146 | // Camera constants, defined in Camera plugin
147 | DestinationType: {
148 | DATA_URL: number;
149 | FILE_URI: number;
150 | }
151 | Direction: {
152 | BACK: number;
153 | FRONT: number;
154 | }
155 | EncodingType: {
156 | JPEG: number;
157 | PNG: number;
158 | }
159 | MediaType: {
160 | PICTURE: number;
161 | VIDEO: number;
162 | ALLMEDIA: number;
163 | }
164 | PictureSourceType: {
165 | PHOTOLIBRARY: number;
166 | CAMERA: number;
167 | SAVEDPHOTOALBUM: number;
168 | }
169 | // Used only on iOS
170 | PopoverArrowDirection: {
171 | ARROW_UP: number;
172 | ARROW_DOWN: number;
173 | ARROW_LEFT: number;
174 | ARROW_RIGHT: number;
175 | ARROW_ANY: number;
176 | }
177 | };
178 |
--------------------------------------------------------------------------------
/www/Camera.js:
--------------------------------------------------------------------------------
1 | /*
2 | *
3 | * Licensed to the Apache Software Foundation (ASF) under one
4 | * or more contributor license agreements. See the NOTICE file
5 | * distributed with this work for additional information
6 | * regarding copyright ownership. The ASF licenses this file
7 | * to you under the Apache License, Version 2.0 (the
8 | * "License"); you may not use this file except in compliance
9 | * with the License. You may obtain a copy of the License at
10 | *
11 | * http://www.apache.org/licenses/LICENSE-2.0
12 | *
13 | * Unless required by applicable law or agreed to in writing,
14 | * software distributed under the License is distributed on an
15 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16 | * KIND, either express or implied. See the License for the
17 | * specific language governing permissions and limitations
18 | * under the License.
19 | *
20 | */
21 |
22 | const argscheck = require('cordova/argscheck');
23 | const exec = require('cordova/exec');
24 | const Camera = require('./Camera');
25 | // XXX: commented out
26 | // CameraPopoverHandle = require('./CameraPopoverHandle');
27 |
28 | /**
29 | * @namespace navigator
30 | */
31 |
32 | /**
33 | * @exports camera
34 | */
35 | const cameraExport = {};
36 |
37 | // Tack on the Camera Constants to the base camera plugin.
38 | for (const key in Camera) {
39 | cameraExport[key] = Camera[key];
40 | }
41 |
42 | /**
43 | * Callback function that provides an error message.
44 | * @callback module:camera.onError
45 | * @param {string} message - The message is provided by the device's native code.
46 | */
47 |
48 | /**
49 | * Callback function that provides the image data.
50 | * @callback module:camera.onSuccess
51 | * @param {string} imageData - Base64 encoding of the image data, _or_ the image file URI, depending on [`cameraOptions`]{@link module:camera.CameraOptions} in effect.
52 | * @example
53 | * // Show image
54 | * //
55 | * function cameraCallback(imageData) {
56 | * var image = document.getElementById('myImage');
57 | * image.src = "data:image/jpeg;base64," + imageData;
58 | * }
59 | */
60 |
61 | /**
62 | * Optional parameters to customize the camera settings.
63 | * * [Quirks](#CameraOptions-quirks)
64 | * @typedef module:camera.CameraOptions
65 | * @type {Object}
66 | * @property {number} [quality=50] - Quality of the saved image, expressed as a range of 0-100, where 100 is typically full resolution with no loss from file compression. (Note that information about the camera's resolution is unavailable.)
67 | * @property {module:Camera.DestinationType} [destinationType=FILE_URI] - Choose the format of the return value.
68 | * @property {module:Camera.PictureSourceType} [sourceType=CAMERA] - Set the source of the picture.
69 | * @property {Boolean} [allowEdit=false] - Allow simple editing of image before selection.
70 | * @property {module:Camera.EncodingType} [encodingType=JPEG] - Choose the returned image file's encoding.
71 | * @property {number} [targetWidth] - Width in pixels to scale image. Must be used with `targetHeight`. Aspect ratio remains constant.
72 | * @property {number} [targetHeight] - Height in pixels to scale image. Must be used with `targetWidth`. Aspect ratio remains constant.
73 | * @property {module:Camera.MediaType} [mediaType=PICTURE] - Set the type of media to select from. Only works when `PictureSourceType` is `PHOTOLIBRARY` or `SAVEDPHOTOALBUM`.
74 | * @property {Boolean} [correctOrientation] - Rotate the image to correct for the orientation of the device during capture.
75 | * @property {Boolean} [saveToPhotoAlbum] - Save the image to the photo album on the device after capture.
76 | * @property {module:CameraPopoverOptions} [popoverOptions] - iOS-only options that specify popover location in iPad.
77 | * @property {module:Camera.Direction} [cameraDirection=BACK] - Choose the camera to use (front- or back-facing).
78 | */
79 |
80 | /**
81 | * @description Takes a photo using the camera, or retrieves a photo from the device's
82 | * image gallery. The image is passed to the success callback as a
83 | * Base64-encoded `String`, or as the URI for the image file.
84 | *
85 | * The `camera.getPicture` function opens the device's default camera
86 | * application that allows users to snap pictures by default - this behavior occurs,
87 | * when `Camera.sourceType` equals [`Camera.PictureSourceType.CAMERA`]{@link module:Camera.PictureSourceType}.
88 | * Once the user snaps the photo, the camera application closes and the application is restored.
89 | *
90 | * If `Camera.sourceType` is `Camera.PictureSourceType.PHOTOLIBRARY` or
91 | * `Camera.PictureSourceType.SAVEDPHOTOALBUM`, then a dialog displays
92 | * that allows users to select an existing image.
93 | *
94 | * The return value is sent to the [`cameraSuccess`]{@link module:camera.onSuccess} callback function, in
95 | * one of the following formats, depending on the specified
96 | * `cameraOptions`:
97 | *
98 | * - A `String` containing the Base64-encoded photo image.
99 | * - A `String` representing the image file location on local storage (default).
100 | *
101 | * You can do whatever you want with the encoded image or URI, for
102 | * example:
103 | *
104 | * - Render the image in an `` tag, as in the example below
105 | * - Save the data locally (`LocalStorage`, [Lawnchair](http://brianleroux.github.com/lawnchair/), etc.)
106 | * - Post the data to a remote server
107 | *
108 | * __NOTE__: Photo resolution on newer devices is quite good. Photos
109 | * selected from the device's gallery are not downscaled to a lower
110 | * quality, even if a `quality` parameter is specified. To avoid common
111 | * memory problems, set `Camera.destinationType` to `FILE_URI` rather
112 | * than `DATA_URL`.
113 | *
114 | * __Supported Platforms__
115 | *
116 | * - Android
117 | * - Browser
118 | * - iOS
119 | *
120 | * More examples [here](#camera-getPicture-examples). Quirks [here](#camera-getPicture-quirks).
121 | *
122 | * @example
123 | * navigator.camera.getPicture(cameraSuccess, cameraError, cameraOptions);
124 | * @param {module:camera.onSuccess} successCallback
125 | * @param {module:camera.onError} errorCallback
126 | * @param {module:camera.CameraOptions} options CameraOptions
127 | */
128 | cameraExport.getPicture = function (successCallback, errorCallback, options) {
129 | argscheck.checkArgs('fFO', 'Camera.getPicture', arguments);
130 | options = options || {};
131 | const getValue = argscheck.getValue;
132 |
133 | const quality = getValue(options.quality, 50);
134 | const destinationType = getValue(options.destinationType, Camera.DestinationType.FILE_URI);
135 | const sourceType = getValue(options.sourceType, Camera.PictureSourceType.CAMERA);
136 | const targetWidth = getValue(options.targetWidth, -1);
137 | const targetHeight = getValue(options.targetHeight, -1);
138 | const encodingType = getValue(options.encodingType, Camera.EncodingType.JPEG);
139 | const mediaType = getValue(options.mediaType, Camera.MediaType.PICTURE);
140 | const allowEdit = !!options.allowEdit;
141 | const correctOrientation = !!options.correctOrientation;
142 | const saveToPhotoAlbum = !!options.saveToPhotoAlbum;
143 | const popoverOptions = getValue(options.popoverOptions, null);
144 | const cameraDirection = getValue(options.cameraDirection, Camera.Direction.BACK);
145 |
146 | if (allowEdit) {
147 | console.warn('allowEdit is deprecated. It does not work reliably on all platforms. Utilise a dedicated image editing library instead. allowEdit functionality is scheduled to be removed in a future release.');
148 | }
149 |
150 | const args = [quality, destinationType, sourceType, targetWidth, targetHeight, encodingType,
151 | mediaType, allowEdit, correctOrientation, saveToPhotoAlbum, popoverOptions, cameraDirection];
152 |
153 | exec(successCallback, errorCallback, 'Camera', 'takePicture', args);
154 | // XXX: commented out
155 | // return new CameraPopoverHandle();
156 | };
157 |
158 | /**
159 | * Removes intermediate image files that are kept in temporary storage
160 | * after calling [`camera.getPicture`]{@link module:camera.getPicture}. Applies only when the value of
161 | * `Camera.sourceType` equals `Camera.PictureSourceType.CAMERA` and the
162 | * `Camera.destinationType` equals `Camera.DestinationType.FILE_URI`.
163 | *
164 | * __Supported Platforms__
165 | *
166 | * - iOS
167 | *
168 | * @example
169 | * navigator.camera.cleanup(onSuccess, onFail);
170 | *
171 | * function onSuccess() {
172 | * console.log("Camera cleanup success.")
173 | * }
174 | *
175 | * function onFail(message) {
176 | * alert('Failed because: ' + message);
177 | * }
178 | */
179 | cameraExport.cleanup = function (successCallback, errorCallback) {
180 | exec(successCallback, errorCallback, 'Camera', 'cleanup', []);
181 | };
182 |
183 | module.exports = cameraExport;
184 |
--------------------------------------------------------------------------------
/www/CameraConstants.js:
--------------------------------------------------------------------------------
1 | /*
2 | *
3 | * Licensed to the Apache Software Foundation (ASF) under one
4 | * or more contributor license agreements. See the NOTICE file
5 | * distributed with this work for additional information
6 | * regarding copyright ownership. The ASF licenses this file
7 | * to you under the Apache License, Version 2.0 (the
8 | * "License"); you may not use this file except in compliance
9 | * with the License. You may obtain a copy of the License at
10 | *
11 | * http://www.apache.org/licenses/LICENSE-2.0
12 | *
13 | * Unless required by applicable law or agreed to in writing,
14 | * software distributed under the License is distributed on an
15 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16 | * KIND, either express or implied. See the License for the
17 | * specific language governing permissions and limitations
18 | * under the License.
19 | *
20 | */
21 |
22 | /**
23 | * @module Camera
24 | */
25 | module.exports = {
26 | /**
27 | * @description
28 | * Defines the output format of `Camera.getPicture` call.
29 | *
30 | * @enum {number}
31 | */
32 | DestinationType: {
33 | /** Return base64 encoded string. DATA_URL can be very memory intensive and cause app crashes or out of memory errors. Use FILE_URI if possible */
34 | DATA_URL: 0,
35 | /** Return file uri (content://media/external/images/media/2 for Android) */
36 | FILE_URI: 1
37 | },
38 | /**
39 | * @enum {number}
40 | */
41 | EncodingType: {
42 | /** Return JPEG encoded image */
43 | JPEG: 0,
44 | /** Return PNG encoded image */
45 | PNG: 1
46 | },
47 | /**
48 | * @enum {number}
49 | */
50 | MediaType: {
51 | /** Allow selection of still pictures only. DEFAULT. Will return format specified via DestinationType */
52 | PICTURE: 0,
53 | /** Allow selection of video only, ONLY RETURNS URL */
54 | VIDEO: 1,
55 | /** Allow selection from all media types */
56 | ALLMEDIA: 2
57 | },
58 | /**
59 | * @description
60 | * Defines the output format of `Camera.getPicture` call.
61 | *
62 | * @enum {number}
63 | */
64 | PictureSourceType: {
65 | /** Choose image from the device's photo library (same as SAVEDPHOTOALBUM for Android) */
66 | PHOTOLIBRARY: 0,
67 | /** Take picture from camera */
68 | CAMERA: 1,
69 | /** Choose image only from the device's Camera Roll album (same as PHOTOLIBRARY for Android) */
70 | SAVEDPHOTOALBUM: 2
71 | },
72 | /**
73 | * Matches iOS UIPopoverArrowDirection constants to specify arrow location on popover.
74 | * @enum {number}
75 | */
76 | PopoverArrowDirection: {
77 | ARROW_UP: 1,
78 | ARROW_DOWN: 2,
79 | ARROW_LEFT: 4,
80 | ARROW_RIGHT: 8,
81 | ARROW_ANY: 15
82 | },
83 | /**
84 | * @enum {number}
85 | */
86 | Direction: {
87 | /** Use the back-facing camera */
88 | BACK: 0,
89 | /** Use the front-facing camera */
90 | FRONT: 1
91 | }
92 | };
93 |
--------------------------------------------------------------------------------
/www/CameraPopoverHandle.js:
--------------------------------------------------------------------------------
1 | /*
2 | *
3 | * Licensed to the Apache Software Foundation (ASF) under one
4 | * or more contributor license agreements. See the NOTICE file
5 | * distributed with this work for additional information
6 | * regarding copyright ownership. The ASF licenses this file
7 | * to you under the Apache License, Version 2.0 (the
8 | * "License"); you may not use this file except in compliance
9 | * with the License. You may obtain a copy of the License at
10 | *
11 | * http://www.apache.org/licenses/LICENSE-2.0
12 | *
13 | * Unless required by applicable law or agreed to in writing,
14 | * software distributed under the License is distributed on an
15 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16 | * KIND, either express or implied. See the License for the
17 | * specific language governing permissions and limitations
18 | * under the License.
19 | *
20 | */
21 |
22 | /**
23 | * @ignore in favour of iOS' one
24 | * A handle to an image picker popover.
25 | */
26 | const CameraPopoverHandle = function () {
27 | this.setPosition = function (popoverOptions) {
28 | console.log('CameraPopoverHandle.setPosition is only supported on iOS.');
29 | };
30 | };
31 |
32 | module.exports = CameraPopoverHandle;
33 |
--------------------------------------------------------------------------------
/www/CameraPopoverOptions.js:
--------------------------------------------------------------------------------
1 | /*
2 | *
3 | * Licensed to the Apache Software Foundation (ASF) under one
4 | * or more contributor license agreements. See the NOTICE file
5 | * distributed with this work for additional information
6 | * regarding copyright ownership. The ASF licenses this file
7 | * to you under the Apache License, Version 2.0 (the
8 | * "License"); you may not use this file except in compliance
9 | * with the License. You may obtain a copy of the License at
10 | *
11 | * http://www.apache.org/licenses/LICENSE-2.0
12 | *
13 | * Unless required by applicable law or agreed to in writing,
14 | * software distributed under the License is distributed on an
15 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16 | * KIND, either express or implied. See the License for the
17 | * specific language governing permissions and limitations
18 | * under the License.
19 | *
20 | */
21 |
22 | const Camera = require('./Camera');
23 |
24 | /**
25 | * @namespace navigator
26 | */
27 |
28 | /**
29 | * iOS-only parameters that specify the anchor element location and arrow
30 | * direction of the popover when selecting images from an iPad's library
31 | * or album.
32 | * Note that the size of the popover may change to adjust to the
33 | * direction of the arrow and orientation of the screen. Make sure to
34 | * account for orientation changes when specifying the anchor element
35 | * location.
36 | * @module CameraPopoverOptions
37 | * @param {Number} [x=0] - x pixel coordinate of screen element onto which to anchor the popover.
38 | * @param {Number} [y=32] - y pixel coordinate of screen element onto which to anchor the popover.
39 | * @param {Number} [width=320] - width, in pixels, of the screen element onto which to anchor the popover.
40 | * @param {Number} [height=480] - height, in pixels, of the screen element onto which to anchor the popover.
41 | * @param {module:Camera.PopoverArrowDirection} [arrowDir=ARROW_ANY] - Direction the arrow on the popover should point.
42 | * @param {Number} [popoverWidth=0] - width of the popover (0 or not specified will use apple's default width).
43 | * @param {Number} [popoverHeight=0] - height of the popover (0 or not specified will use apple's default height).
44 | */
45 | const CameraPopoverOptions = function (x, y, width, height, arrowDir, popoverWidth, popoverHeight) {
46 | // information of rectangle that popover should be anchored to
47 | this.x = x || 0;
48 | this.y = y || 32;
49 | this.width = width || 320;
50 | this.height = height || 480;
51 | this.arrowDir = arrowDir || Camera.PopoverArrowDirection.ARROW_ANY;
52 | this.popoverWidth = popoverWidth || 0;
53 | this.popoverHeight = popoverHeight || 0;
54 | };
55 |
56 | module.exports = CameraPopoverOptions;
57 |
--------------------------------------------------------------------------------
/www/ios/CameraPopoverHandle.js:
--------------------------------------------------------------------------------
1 | /*
2 | *
3 | * Licensed to the Apache Software Foundation (ASF) under one
4 | * or more contributor license agreements. See the NOTICE file
5 | * distributed with this work for additional information
6 | * regarding copyright ownership. The ASF licenses this file
7 | * to you under the Apache License, Version 2.0 (the
8 | * "License"); you may not use this file except in compliance
9 | * with the License. You may obtain a copy of the License at
10 | *
11 | * http://www.apache.org/licenses/LICENSE-2.0
12 | *
13 | * Unless required by applicable law or agreed to in writing,
14 | * software distributed under the License is distributed on an
15 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16 | * KIND, either express or implied. See the License for the
17 | * specific language governing permissions and limitations
18 | * under the License.
19 | *
20 | */
21 |
22 | const exec = require('cordova/exec');
23 |
24 | /**
25 | * @namespace navigator
26 | */
27 |
28 | /**
29 | * A handle to an image picker popover.
30 | *
31 | * __Supported Platforms__
32 | *
33 | * - iOS
34 | *
35 | * @example
36 | * navigator.camera.getPicture(onSuccess, onFail,
37 | * {
38 | * destinationType: Camera.DestinationType.FILE_URI,
39 | * sourceType: Camera.PictureSourceType.PHOTOLIBRARY,
40 | * popoverOptions: new CameraPopoverOptions(300, 300, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY, 300, 600)
41 | * });
42 | *
43 | * // Reposition the popover if the orientation changes.
44 | * window.onorientationchange = function() {
45 | * var cameraPopoverHandle = new CameraPopoverHandle();
46 | * var cameraPopoverOptions = new CameraPopoverOptions(0, 0, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY, 400, 500);
47 | * cameraPopoverHandle.setPosition(cameraPopoverOptions);
48 | * }
49 | * @module CameraPopoverHandle
50 | */
51 | const CameraPopoverHandle = function () {
52 | /**
53 | * Can be used to reposition the image selection dialog,
54 | * for example, when the device orientation changes.
55 | * @memberof CameraPopoverHandle
56 | * @instance
57 | * @method setPosition
58 | * @param {module:CameraPopoverOptions} popoverOptions
59 | */
60 | this.setPosition = function (popoverOptions) {
61 | const args = [popoverOptions];
62 | exec(null, null, 'Camera', 'repositionPopover', args);
63 | };
64 | };
65 |
66 | module.exports = CameraPopoverHandle;
67 |
--------------------------------------------------------------------------------