You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by st...@apache.org on 2013/12/07 01:17:28 UTC
[12/12] docs commit: Version 3.3.0
Version 3.3.0
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/c6219cfc
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/c6219cfc
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/c6219cfc
Branch: refs/heads/master
Commit: c6219cfc76e070df7ddc0a79b97e99ef856e86c6
Parents: bbde834
Author: Steven Gill <st...@gmail.com>
Authored: Fri Dec 6 16:16:58 2013 -0800
Committer: Steven Gill <st...@gmail.com>
Committed: Fri Dec 6 16:16:58 2013 -0800
----------------------------------------------------------------------
VERSION | 2 +-
docs/en/3.3.0/config.json | 190 +++++
docs/en/3.3.0/config_ref/images.md | 198 +++++
docs/en/3.3.0/config_ref/index.md | 197 +++++
.../accelerometer/acceleration/acceleration.md | 104 +++
.../accelerometer/accelerometer.clearWatch.md | 111 +++
.../accelerometer.getCurrentAcceleration.md | 109 +++
.../cordova/accelerometer/accelerometer.md | 86 +++
.../accelerometer.watchAcceleration.md | 142 ++++
.../parameters/accelerometerError.md | 26 +
.../parameters/accelerometerOptions.md | 26 +
.../parameters/accelerometerSuccess.md | 39 +
docs/en/3.3.0/cordova/camera/camera.cleanup.md | 48 ++
.../3.3.0/cordova/camera/camera.getPicture.md | 255 +++++++
docs/en/3.3.0/cordova/camera/camera.md | 103 +++
.../camera/parameter/CameraPopoverHandle.md | 63 ++
.../camera/parameter/CameraPopoverOptions.md | 77 ++
.../cordova/camera/parameter/cameraError.md | 30 +
.../cordova/camera/parameter/cameraOptions.md | 136 ++++
.../cordova/camera/parameter/cameraSuccess.md | 39 +
.../3.3.0/cordova/compass/compass.clearWatch.md | 108 +++
.../cordova/compass/compass.clearWatchFilter.md | 22 +
.../compass/compass.getCurrentHeading.md | 96 +++
docs/en/3.3.0/cordova/compass/compass.md | 100 +++
.../cordova/compass/compass.watchHeading.md | 148 ++++
.../compass/compass.watchHeadingFilter.md | 22 +
.../compass/compassError/compassError.md | 36 +
.../cordova/compass/parameters/compassError.md | 28 +
.../compass/parameters/compassHeading.md | 54 ++
.../compass/parameters/compassOptions.md | 44 ++
.../compass/parameters/compassSuccess.md | 36 +
docs/en/3.3.0/cordova/connection/connection.md | 99 +++
.../3.3.0/cordova/connection/connection.type.md | 125 +++
.../3.3.0/cordova/contacts/Contact/contact.md | 257 +++++++
.../contacts/ContactAddress/contactaddress.md | 169 ++++
.../contacts/ContactError/contactError.md | 42 +
.../contacts/ContactField/contactfield.md | 156 ++++
.../ContactFindOptions/contactfindoptions.md | 109 +++
.../cordova/contacts/ContactName/contactname.md | 144 ++++
.../ContactOrganization/contactorganization.md | 151 ++++
.../3.3.0/cordova/contacts/contacts.create.md | 72 ++
docs/en/3.3.0/cordova/contacts/contacts.find.md | 124 +++
docs/en/3.3.0/cordova/contacts/contacts.md | 139 ++++
.../cordova/contacts/parameters/contactError.md | 26 +
.../contacts/parameters/contactFields.md | 24 +
.../contacts/parameters/contactFindOptions.md | 34 +
.../contacts/parameters/contactSuccess.md | 38 +
docs/en/3.3.0/cordova/device/device.cordova.md | 75 ++
docs/en/3.3.0/cordova/device/device.md | 94 +++
docs/en/3.3.0/cordova/device/device.model.md | 92 +++
docs/en/3.3.0/cordova/device/device.name.md | 95 +++
docs/en/3.3.0/cordova/device/device.platform.md | 83 ++
docs/en/3.3.0/cordova/device/device.uuid.md | 103 +++
docs/en/3.3.0/cordova/device/device.version.md | 79 ++
.../3.3.0/cordova/events/events.backbutton.md | 81 ++
.../cordova/events/events.batterycritical.md | 91 +++
.../3.3.0/cordova/events/events.batterylow.md | 90 +++
.../cordova/events/events.batterystatus.md | 97 +++
.../3.3.0/cordova/events/events.deviceready.md | 90 +++
.../cordova/events/events.endcallbutton.md | 78 ++
docs/en/3.3.0/cordova/events/events.md | 97 +++
.../3.3.0/cordova/events/events.menubutton.md | 80 ++
docs/en/3.3.0/cordova/events/events.offline.md | 99 +++
docs/en/3.3.0/cordova/events/events.online.md | 100 +++
docs/en/3.3.0/cordova/events/events.pause.md | 101 +++
docs/en/3.3.0/cordova/events/events.resume.md | 114 +++
.../3.3.0/cordova/events/events.searchbutton.md | 79 ++
.../cordova/events/events.startcallbutton.md | 79 ++
.../cordova/events/events.volumedownbutton.md | 79 ++
.../cordova/events/events.volumeupbutton.md | 79 ++
.../file/directoryentry/directoryentry.md | 411 ++++++++++
.../file/directoryreader/directoryreader.md | 67 ++
docs/en/3.3.0/cordova/file/file.md | 121 +++
.../3.3.0/cordova/file/fileentry/fileentry.md | 337 ++++++++
.../3.3.0/cordova/file/fileerror/fileerror.md | 47 ++
docs/en/3.3.0/cordova/file/fileobj/fileobj.md | 83 ++
.../3.3.0/cordova/file/filereader/filereader.md | 255 +++++++
.../3.3.0/cordova/file/filesystem/filesystem.md | 91 +++
.../cordova/file/filetransfer/filetransfer.md | 302 ++++++++
.../file/filetransfererror/filetransfererror.md | 44 ++
.../file/fileuploadoptions/fileuploadoptions.md | 48 ++
.../file/fileuploadresult/fileuploadresult.md | 40 +
.../3.3.0/cordova/file/filewriter/filewriter.md | 235 ++++++
docs/en/3.3.0/cordova/file/flags/flags.md | 47 ++
.../file/localfilesystem/localfilesystem.md | 126 +++
docs/en/3.3.0/cordova/file/metadata/metadata.md | 50 ++
.../geolocation/Coordinates/coordinates.md | 130 ++++
.../cordova/geolocation/Position/position.md | 114 +++
.../geolocation/PositionError/positionError.md | 54 ++
.../geolocation/geolocation.clearWatch.md | 114 +++
.../geolocation.getCurrentPosition.md | 126 +++
.../en/3.3.0/cordova/geolocation/geolocation.md | 133 ++++
.../geolocation/geolocation.watchPosition.md | 128 ++++
.../parameters/geolocation.options.md | 38 +
.../geolocation/parameters/geolocationError.md | 31 +
.../parameters/geolocationSuccess.md | 46 ++
.../GlobalizationError/globalizationerror.md | 88 +++
.../globalization/globalization.dateToString.md | 91 +++
.../globalization.getCurrencyPattern.md | 112 +++
.../globalization/globalization.getDateNames.md | 97 +++
.../globalization.getDatePattern.md | 105 +++
.../globalization.getFirstDayOfWeek.md | 77 ++
.../globalization.getLocaleName.md | 77 ++
.../globalization.getNumberPattern.md | 128 ++++
.../globalization.getPreferredLanguage.md | 77 ++
.../globalization.isDayLightSavingsTime.md | 82 ++
.../cordova/globalization/globalization.md | 79 ++
.../globalization.numberToString.md | 85 +++
.../globalization/globalization.stringToDate.md | 114 +++
.../globalization.stringToNumber.md | 88 +++
.../3.3.0/cordova/inappbrowser/inappbrowser.md | 497 ++++++++++++
.../3.3.0/cordova/inappbrowser/window.open.md | 103 +++
.../cordova/media/MediaError/mediaError.md | 42 +
.../cordova/media/Parameters/mediaError.md | 31 +
.../en/3.3.0/cordova/media/capture/CaptureCB.md | 44 ++
.../3.3.0/cordova/media/capture/CaptureError.md | 38 +
.../cordova/media/capture/CaptureErrorCB.md | 41 +
.../cordova/media/capture/ConfigurationData.md | 61 ++
.../media/capture/MediaFile.getFormatData.md | 64 ++
.../en/3.3.0/cordova/media/capture/MediaFile.md | 38 +
.../cordova/media/capture/MediaFileData.md | 92 +++
docs/en/3.3.0/cordova/media/capture/capture.md | 164 ++++
.../3.3.0/cordova/media/capture/captureAudio.md | 145 ++++
.../media/capture/captureAudioOptions.md | 51 ++
.../3.3.0/cordova/media/capture/captureImage.md | 138 ++++
.../media/capture/captureImageOptions.md | 37 +
.../3.3.0/cordova/media/capture/captureVideo.md | 138 ++++
.../media/capture/captureVideoOptions.md | 44 ++
.../cordova/media/media.getCurrentPosition.md | 176 +++++
.../en/3.3.0/cordova/media/media.getDuration.md | 162 ++++
docs/en/3.3.0/cordova/media/media.md | 161 ++++
docs/en/3.3.0/cordova/media/media.pause.md | 162 ++++
docs/en/3.3.0/cordova/media/media.play.md | 185 +++++
docs/en/3.3.0/cordova/media/media.release.md | 154 ++++
docs/en/3.3.0/cordova/media/media.seekTo.md | 154 ++++
docs/en/3.3.0/cordova/media/media.setVolume.md | 171 +++++
.../en/3.3.0/cordova/media/media.startRecord.md | 143 ++++
docs/en/3.3.0/cordova/media/media.stop.md | 167 ++++
docs/en/3.3.0/cordova/media/media.stopRecord.md | 135 ++++
.../cordova/notification/notification.alert.md | 115 +++
.../cordova/notification/notification.beep.md | 111 +++
.../notification/notification.confirm.md | 126 +++
.../3.3.0/cordova/notification/notification.md | 87 +++
.../cordova/notification/notification.prompt.md | 124 +++
.../notification/notification.vibrate.md | 98 +++
.../cordova/splashscreen/splashscreen.hide.md | 83 ++
.../3.3.0/cordova/splashscreen/splashscreen.md | 68 ++
.../cordova/splashscreen/splashscreen.show.md | 79 ++
docs/en/3.3.0/cordova/storage/storage.md | 70 ++
docs/en/3.3.0/guide/appdev/privacy/index.md | 117 +++
docs/en/3.3.0/guide/appdev/whitelist/index.md | 168 ++++
docs/en/3.3.0/guide/cli/index.md | 486 ++++++++++++
docs/en/3.3.0/guide/hybrid/plugins/index.md | 211 +++++
docs/en/3.3.0/guide/hybrid/webviews/index.md | 36 +
docs/en/3.3.0/guide/overview/index.md | 139 ++++
.../guide/platforms/amazonfireos/config.md | 66 ++
.../3.3.0/guide/platforms/amazonfireos/index.md | 145 ++++
.../guide/platforms/amazonfireos/plugin.md | 100 +++
.../guide/platforms/amazonfireos/webview.md | 113 +++
docs/en/3.3.0/guide/platforms/android/config.md | 55 ++
docs/en/3.3.0/guide/platforms/android/index.md | 217 ++++++
docs/en/3.3.0/guide/platforms/android/plugin.md | 220 ++++++
docs/en/3.3.0/guide/platforms/android/tools.md | 85 +++
.../3.3.0/guide/platforms/android/upgrading.md | 441 +++++++++++
.../en/3.3.0/guide/platforms/android/webview.md | 131 ++++
.../guide/platforms/blackberry10/config.md | 51 ++
.../3.3.0/guide/platforms/blackberry10/index.md | 173 +++++
.../guide/platforms/blackberry10/plugin.md | 255 +++++++
.../3.3.0/guide/platforms/blackberry10/tools.md | 178 +++++
.../guide/platforms/blackberry10/upgrading.md | 490 ++++++++++++
docs/en/3.3.0/guide/platforms/index.md | 90 +++
docs/en/3.3.0/guide/platforms/ios/config.md | 107 +++
docs/en/3.3.0/guide/platforms/ios/index.md | 231 ++++++
docs/en/3.3.0/guide/platforms/ios/plugin.md | 246 ++++++
docs/en/3.3.0/guide/platforms/ios/tools.md | 63 ++
docs/en/3.3.0/guide/platforms/ios/upgrading.md | 765 +++++++++++++++++++
docs/en/3.3.0/guide/platforms/ios/webview.md | 185 +++++
docs/en/3.3.0/guide/platforms/tizen/index.md | 116 +++
docs/en/3.3.0/guide/platforms/win8/index.md | 124 +++
docs/en/3.3.0/guide/platforms/win8/tools.md | 50 ++
docs/en/3.3.0/guide/platforms/win8/upgrading.md | 61 ++
docs/en/3.3.0/guide/platforms/wp7/index.md | 131 ++++
docs/en/3.3.0/guide/platforms/wp8/index.md | 162 ++++
docs/en/3.3.0/guide/platforms/wp8/plugin.md | 224 ++++++
docs/en/3.3.0/guide/platforms/wp8/tools.md | 113 +++
docs/en/3.3.0/guide/platforms/wp8/upgrading.md | 435 +++++++++++
docs/en/3.3.0/guide/support/index.md | 303 ++++++++
docs/en/3.3.0/index.md | 142 ++++
docs/en/3.3.0/plugin_ref/plugman.md | 193 +++++
docs/en/3.3.0/plugin_ref/spec.md | 579 ++++++++++++++
190 files changed, 23652 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/VERSION
----------------------------------------------------------------------
diff --git a/VERSION b/VERSION
index a4f52a5..0fa4ae4 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-3.2.0
\ No newline at end of file
+3.3.0
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/config.json
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/config.json b/docs/en/3.3.0/config.json
new file mode 100644
index 0000000..12d3951
--- /dev/null
+++ b/docs/en/3.3.0/config.json
@@ -0,0 +1,190 @@
+{
+ "language": "English",
+ "merge": {
+ "accelerometer.md": [
+ "cordova/accelerometer/accelerometer.md",
+ "cordova/accelerometer/accelerometer.getCurrentAcceleration.md",
+ "cordova/accelerometer/accelerometer.watchAcceleration.md",
+ "cordova/accelerometer/accelerometer.clearWatch.md",
+ "cordova/accelerometer/acceleration/acceleration.md",
+ "cordova/accelerometer/parameters/accelerometerSuccess.md",
+ "cordova/accelerometer/parameters/accelerometerError.md",
+ "cordova/accelerometer/parameters/accelerometerOptions.md"
+ ],
+ "camera.md": [
+ "cordova/camera/camera.md",
+ "cordova/camera/camera.getPicture.md",
+ "cordova/camera/parameter/cameraSuccess.md",
+ "cordova/camera/parameter/cameraError.md",
+ "cordova/camera/parameter/cameraOptions.md",
+ "cordova/camera/parameter/CameraPopoverOptions.md",
+ "cordova/camera/parameter/CameraPopoverHandle.md"
+ ],
+ "capture.md": [
+ "cordova/media/capture/capture.md",
+ "cordova/media/capture/captureAudio.md",
+ "cordova/media/capture/captureAudioOptions.md",
+ "cordova/media/capture/captureImage.md",
+ "cordova/media/capture/captureImageOptions.md",
+ "cordova/media/capture/captureVideo.md",
+ "cordova/media/capture/captureVideoOptions.md",
+ "cordova/media/capture/CaptureError.md",
+ "cordova/media/capture/CaptureCB.md",
+ "cordova/media/capture/CaptureErrorCB.md",
+ "cordova/media/capture/ConfigurationData.md",
+ "cordova/media/capture/MediaFile.md",
+ "cordova/media/capture/MediaFile.getFormatData.md",
+ "cordova/media/capture/MediaFileData.md"
+ ],
+ "compass.md": [
+ "cordova/compass/compass.md",
+ "cordova/compass/compass.getCurrentHeading.md",
+ "cordova/compass/compass.watchHeading.md",
+ "cordova/compass/compass.clearWatch.md",
+ "cordova/compass/compass.watchHeadingFilter.md",
+ "cordova/compass/compass.clearWatchFilter.md",
+ "cordova/compass/parameters/compassSuccess.md",
+ "cordova/compass/parameters/compassError.md",
+ "cordova/compass/parameters/compassOptions.md",
+ "cordova/compass/parameters/compassHeading.md",
+ "cordova/compass/compassError/compassError.md"
+ ],
+ "contacts.md": [
+ "cordova/contacts/contacts.md",
+ "cordova/contacts/contacts.create.md",
+ "cordova/contacts/contacts.find.md",
+ "cordova/contacts/Contact/contact.md",
+ "cordova/contacts/ContactAddress/contactaddress.md",
+ "cordova/contacts/ContactField/contactfield.md",
+ "cordova/contacts/ContactFindOptions/contactfindoptions.md",
+ "cordova/contacts/ContactName/contactname.md",
+ "cordova/contacts/ContactOrganization/contactorganization.md",
+ "cordova/contacts/ContactError/contactError.md",
+ "cordova/contacts/parameters/contactSuccess.md",
+ "cordova/contacts/parameters/contactError.md",
+ "cordova/contacts/parameters/contactFields.md",
+ "cordova/contacts/parameters/contactFindOptions.md"
+ ],
+ "device.md": [
+ "cordova/device/device.md",
+ "cordova/device/device.model.md",
+ "cordova/device/device.cordova.md",
+ "cordova/device/device.platform.md",
+ "cordova/device/device.uuid.md",
+ "cordova/device/device.version.md",
+ "cordova/device/device.name.md"
+ ],
+ "events.md": [
+ "cordova/events/events.md",
+ "cordova/events/events.deviceready.md",
+ "cordova/events/events.pause.md",
+ "cordova/events/events.resume.md",
+ "cordova/events/events.online.md",
+ "cordova/events/events.offline.md",
+ "cordova/events/events.backbutton.md",
+ "cordova/events/events.batterycritical.md",
+ "cordova/events/events.batterylow.md",
+ "cordova/events/events.batterystatus.md",
+ "cordova/events/events.menubutton.md",
+ "cordova/events/events.searchbutton.md",
+ "cordova/events/events.startcallbutton.md",
+ "cordova/events/events.endcallbutton.md",
+ "cordova/events/events.volumedownbutton.md",
+ "cordova/events/events.volumeupbutton.md"
+ ],
+ "file.md": [
+ "cordova/file/file.md",
+ "cordova/file/fileobj/fileobj.md",
+ "cordova/file/filereader/filereader.md",
+ "cordova/file/filewriter/filewriter.md",
+ "cordova/file/filesystem/filesystem.md",
+ "cordova/file/fileentry/fileentry.md",
+ "cordova/file/directoryentry/directoryentry.md",
+ "cordova/file/directoryreader/directoryreader.md",
+ "cordova/file/filetransfer/filetransfer.md",
+ "cordova/file/fileuploadoptions/fileuploadoptions.md",
+ "cordova/file/fileuploadresult/fileuploadresult.md",
+ "cordova/file/flags/flags.md",
+ "cordova/file/localfilesystem/localfilesystem.md",
+ "cordova/file/metadata/metadata.md",
+ "cordova/file/fileerror/fileerror.md",
+ "cordova/file/filetransfererror/filetransfererror.md"
+ ],
+ "geolocation.md": [
+ "cordova/geolocation/geolocation.md",
+ "cordova/geolocation/geolocation.getCurrentPosition.md",
+ "cordova/geolocation/geolocation.watchPosition.md",
+ "cordova/geolocation/geolocation.clearWatch.md",
+ "cordova/geolocation/Coordinates/coordinates.md",
+ "cordova/geolocation/Position/position.md",
+ "cordova/geolocation/PositionError/positionError.md",
+ "cordova/geolocation/parameters/geolocationSuccess.md",
+ "cordova/geolocation/parameters/geolocationError.md",
+ "cordova/geolocation/parameters/geolocation.options.md"
+ ],
+ "globalization.md": [
+ "cordova/globalization/globalization.md",
+ "cordova/globalization/globalization.getPreferredLanguage.md",
+ "cordova/globalization/globalization.getLocaleName.md",
+ "cordova/globalization/globalization.dateToString.md",
+ "cordova/globalization/globalization.stringToDate.md",
+ "cordova/globalization/globalization.getDatePattern.md",
+ "cordova/globalization/globalization.getDateNames.md",
+ "cordova/globalization/globalization.isDayLightSavingsTime.md",
+ "cordova/globalization/globalization.getFirstDayOfWeek.md",
+ "cordova/globalization/globalization.numberToString.md",
+ "cordova/globalization/globalization.stringToNumber.md",
+ "cordova/globalization/globalization.getNumberPattern.md",
+ "cordova/globalization/globalization.getCurrencyPattern.md",
+ "cordova/globalization/GlobalizationError/globalizationerror.md"
+ ],
+ "media.md": [
+ "cordova/media/media.md",
+ "cordova/media/media.getCurrentPosition.md",
+ "cordova/media/media.getDuration.md",
+ "cordova/media/media.pause.md",
+ "cordova/media/media.play.md",
+ "cordova/media/media.release.md",
+ "cordova/media/media.seekTo.md",
+ "cordova/media/media.setVolume.md",
+ "cordova/media/media.startRecord.md",
+ "cordova/media/media.stop.md",
+ "cordova/media/media.stopRecord.md",
+ "cordova/media/MediaError/mediaError.md",
+ "cordova/media/Parameters/mediaError.md"
+ ],
+ "network.md": [
+ "cordova/network/network.md",
+ "cordova/network/network.isReachable.md",
+ "cordova/network/NetworkStatus/NetworkStatus.md",
+ "cordova/network/parameters/reachableCallback.md",
+ "cordova/network/parameters/reachableHostname.md",
+ "cordova/network/parameters/reachableOptions.md"
+ ],
+ "connection.md": [
+ "cordova/connection/connection.md",
+ "cordova/connection/connection.type.md"
+ ],
+ "notification.md": [
+ "cordova/notification/notification.md",
+ "cordova/notification/notification.alert.md",
+ "cordova/notification/notification.confirm.md",
+ "cordova/notification/notification.prompt.md",
+ "cordova/notification/notification.beep.md",
+ "cordova/notification/notification.vibrate.md"
+ ],
+ "splashscreen.md": [
+ "cordova/splashscreen/splashscreen.md",
+ "cordova/splashscreen/splashscreen.show.md",
+ "cordova/splashscreen/splashscreen.hide.md"
+ ],
+ "storage.md": [
+ "cordova/storage/storage.md"
+ ],
+ "inappbrowser.md": [
+ "cordova/inappbrowser/inappbrowser.md",
+ "cordova/inappbrowser/window.open.md"
+ ]
+
+ }
+}
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/config_ref/images.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/config_ref/images.md b/docs/en/3.3.0/config_ref/images.md
new file mode 100644
index 0000000..6c9bf98
--- /dev/null
+++ b/docs/en/3.3.0/config_ref/images.md
@@ -0,0 +1,198 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Icons and Splash Screens
+
+This section shows how to configure an app's icon and optional splash
+screen for various platforms, both when working in the Cordova CLI
+(described in The Command-Line Interface) or using platform-specific
+SDK tools (detailed in the Platform Guides).
+
+## Configuring Icons in the CLI
+
+When working in the CLI, icon source files are located within various
+platform-specific subdirectories within the project's `www/res/icons`
+directory. Newly created projects come with a default set of Cordova
+icons for you to replace for the platforms you wish to target.
+
+Android specifies icons for low, medium, high, and extra-high resolutions:
+
+ android/icon-36-ldpi.png
+ android/icon-48-mdpi.png
+ android/icon-72-hdpi.png
+ android/icon-96-xhdpi.png
+
+The iOS platform specifies 72-pixel-square icons for iPads, and
+57-pixel icons for iPhones and iPods, with high-resolution _2x_
+variants for retina displays:
+
+ ios/icon-57-2x.png
+ ios/icon-57.png
+ ios/icon-72-2x.png
+ ios/icon-72.png
+
+Windows Phone specifies a default 48-pixel icon, along with various
+devices' background tiling images used when representing applications:
+
+ windows-phone/icon-48.png
+ windows-phone/icon-62-tile.png
+ windows-phone/icon-173-tile.png
+
+Blackberry 10 requires an icon element in config.xml:
+
+ <icon src="blackberry10/icon-86.png" />
+
+See BlackBerry's documentation for tareting multiple sizes and locales.
+
+[http://developer.blackberry.com/html5/documentation/icon_element.html]
+
+Tizen requires an 128-pixel icon:
+
+ tizen/icon-128.png
+
+## Configuring Splash Screens in the CLI
+
+Use the Splashscreen API to enable display of an app's introductory
+splash screen on many platforms. When working in the CLI, splash
+screen source files are located within the project's `www/res/screens`
+subdirectory.
+
+Android specifies both portrait- and landscape-oriented splash screen
+images for low, medium, high, and extra-high resolutions:
+
+ android/screen-hdpi-landscape.png
+ android/screen-hdpi-portrait.png
+ android/screen-ldpi-landscape.png
+ android/screen-ldpi-portrait.png
+ android/screen-mdpi-landscape.png
+ android/screen-mdpi-portrait.png
+ android/screen-xhdpi-landscape.png
+ android/screen-xhdpi-portrait.png
+
+The iOS platform specifies variants for iPhone/iPod and iPad, with
+variants for retina displays and different orientations. The _568h_
+file applies to the iPhone 5's taller screen:
+
+ ios/screen-ipad-landscape-2x.png
+ ios/screen-ipad-landscape.png
+ ios/screen-ipad-portrait-2x.png
+ ios/screen-ipad-portrait.png
+ ios/screen-iphone-landscape-2x.png
+ ios/screen-iphone-landscape.png
+ ios/screen-iphone-portrait-2x.png
+ ios/screen-iphone-portrait.png
+ ios/screen-iphone-portrait-568h-2x.png
+
+Windows Phone specifies a single splash screen image:
+
+ windows-phone/screen-portrait.jpg
+
+The following sections detail how to set up splash screens when
+working with SDKs and related command-line tools described in Platform
+Guides.
+
+Don't forget to install the SplashScreen plugin before trying to use the
+`navigator.splashscreen.hide()` or `navigator.splashscreen.show()` methods.
+
+## Splash Screens for the Android Platform
+
+Place [9-patch image](https://developer.android.com/tools/help/draw9patch.html)
+files in the Android project's `platforms/android/res/drawable*` directories.
+
+The size for each should be:
+
+- xlarge (xhdpi): at least 960 × 720
+- large (hdpi): at least 640 × 480
+- medium (mdpi): at least 470 × 320
+- small (ldpi): at least 426 × 320
+
+If you want to use
+the default splash screen images provided in Cordova, you'll need to copy the
+png files from `platforms/android/www/res/screen/android` to
+`platforms/android/res/drawable*/`:
+
+ cd platforms/android/res
+ mkdir drawable-port-ldpi
+ cp -p ../assets/www/res/screen/android/screen-ldpi-portrait.png drawable-port-ldpi/screen.png
+ mkdir drawable-land-ldpi
+ cp -p ../assets/www/res/screen/android/screen-ldpi-landscape.png drawable-land-ldpi/screen.png
+ mkdir drawable-port-mdpi
+ cp -p ../assets/www/res/screen/android/screen-mdpi-portrait.png drawable-port-mdpi/screen.png
+ mkdir drawable-land-mdpi
+ cp -p ../assets/www/res/screen/android/screen-mdpi-landscape.png drawable-land-mdpi/screen.png
+ mkdir drawable-port-hdpi
+ cp -p ../assets/www/res/screen/android/screen-hdpi-portrait.png drawable-port-hdpi/screen.png
+ mkdir drawable-land-hdpi
+ cp -p ../assets/www/res/screen/android/screen-hdpi-landscape.png drawable-land-hdpi/screen.png
+ mkdir drawable-port-xhdpi
+ cp -p ../assets/www/res/screen/android/screen-xhdpi-portrait.png drawable-port-xhdpi/screen.png
+ mkdir drawable-land-xhdpi
+ cp -p ../assets/www/res/screen/android/screen-xhdpi-landscape.png drawable-land-xhdpi/screen.png
+
+The `drawable` directory names must follow the Android conventions for
+supporting
+[screen sizes](http://developer.android.com/guide/practices/screens_support.html) and
+[alternate resources](http://developer.android.com/guide/topics/resources/providing-resources.html#AlternativeResources).
+
+In `config.xml` in the project's `www` directory, add the following preferences:
+
+ <preference name="SplashScreen" value="splash" />
+ <preference name="SplashScreenDelay" value="10000" />
+
+The first line sets the image to display as the splash screen. This is the
+file name of the png in the `drawable*` directories. If you
+name the image anything other than `splash.png`, you need to modify
+this line. Do not include the filename extension (i.e., `.png`).
+If you want to use the default splash screens provided in
+Cordova as listed above, use the value `screen`.
+
+The second line sets the default delay of how long the splashscreen appears in
+milliseconds. This should be the maximum expected start time.
+The default value for SplashScreenDelay is 3000 ms.
+
+Finally, the splash screen should be present only as long as necessary. When
+your app has started and the webview has loaded, your app should hide the
+splash screen so that your main view is visible. Because the app start time
+will vary quite a bit due to a number of factors, it is recommended that your
+app explicitly invoke `navigator.splashscreen.hide()` in the Javascript
+method that responds to the `deviceready` event. Otherwise the splash screen
+will be visible for the SplashScreenDelay value that you configured above.
+This event-driven approach is highly recommended versus having the splash
+screen visible for always a fixed duration.
+
+## Splash Screens for the iOS Platform
+
+Copy splash screen images into the iOS project's `Resources/splash`
+directory. Only add those images for the devices you want to support,
+such as iPad or iPhone. The size of each image should be:
+
+- Default-568h@2x~iphone.png (640x1136 pixels)
+- Default-Landscape@2x~ipad.png (2048x1496 pixels)
+- Default-Landscape~ipad.png (1024x748 pixels)
+- Default-Portrait@2x~ipad.png (1536x2008 pixels)
+- Default-Portrait~ipad.png (768x1004 pixels)
+- Default@2x~iphone.png (640x960 pixels)
+- Default~iphone.png (320x480 pixels)
+
+## Splash Screens for the BlackBerry 10 Platform
+
+Add a rim:splash element to config.xml for each resolution and locale you wish
+to support:
+
+<http://developer.blackberry.com/html5/documentation/rim_splash_element.html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/config_ref/index.md b/docs/en/3.3.0/config_ref/index.md
new file mode 100644
index 0000000..f337324
--- /dev/null
+++ b/docs/en/3.3.0/config_ref/index.md
@@ -0,0 +1,197 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# The config.xml File
+
+Many aspects of an app's behavior can be controlled with a global
+configuration file, `config.xml`, that belongs in the top-level web
+asset directory along with the app's home page. This
+platform-agnostic XML file is arranged based on the W3C's [Packaged
+Web Apps (Widgets)](http://www.w3.org/TR/widgets/) specification, and
+extended to specify core Cordova API features, plugins, and
+platform-specific settings.
+
+For projects created with the Cordova CLI (described in The
+Command-Line Interface), this file can be found in the top-level `www`
+directory:
+
+ app/www/config.xml
+
+When using the CLI to build a project, versions of this file are
+passively copied along with other web-asset source files into various
+`platforms/*/www` subdirectories, for example:
+
+ app/platforms/ios/www/config.xml
+ app/platforms/blackberry10/www/config.xml
+
+An exception is Android, whose path specifies an additional `assets`
+subdirectory:
+
+ app/platforms/android/assets/www/config.xml
+
+If you use the CLI to create a project, but then shift your workflow
+to an SDK, you need to use an alternate set of source files for
+Android and iOS:
+
+ app/platforms/android/res/www/config.xml
+ app/platforms/ios/<APP_NAME>/config.xml
+
+This section details global and cross-platform configuration options.
+See the following sections for platform-specific options:
+
+- iOS Configuration
+- Android Configuration
+- BlackBerry 10 Configuration
+
+In addition to the various configuration options detailed below, you
+can also configure an application's core set of images for each target
+platform. See Icons and Splash Screens for more information.
+
+## Core Configuration Elements
+
+This example shows the default `config.xml` generated by the CLI's
+`create` command, described in The Command-Line Interface:
+
+ <widget id="com.example.hello" version="0.0.1">
+ <name>HelloWorld</name>
+ <description>
+ A sample Apache Cordova application that responds to the deviceready event.
+ </description>
+ <author email="dev@callback.apache.org" href="http://cordova.io">
+ Apache Cordova Team
+ </author>
+ <content src="index.html" />
+ <access origin="*" />
+ <preference name="Fullscreen" value="true" />
+ <preference name="WebViewBounce" value="true" />
+ </widget>
+
+<!-- QUERY: is WebViewBounce superseded by DisallowOverscroll? -->
+
+The following configuration elements appear in the top-level
+`config.xml` file, and are supported across all supported Cordova
+platforms:
+
+- The `<widget>` element's `id` attribute provides the app's
+ reverse-domain identifier, and the `version` its full version number
+ expressed in major/minor/patch notation.
+
+- The `<name>` element specifies the app's formal name, as it appears
+ on the device's home screen and within app-store interfaces.
+
+- The `<description>` and `<author>` elements specify metadata and
+ contact information that may appear within app-store listings.
+
+- The optional `<content>` element defines the app's starting
+ page in the top-level web assets directory. The default value is
+ `index.html`, which customarily appears in a project's top-level
+ `www` directory.
+
+- `<access>` elements define the set of external domains the app is
+ allowed to communicate with. The default value shown above allows
+ it to access any server. See the Domain Whitelist Guide for details.
+
+- The `<preference>` tag sets various options as pairs of
+ `name`/`value` attributes. Each preference's `name` is
+ case-insensitive. Many preferences are unique to specific
+ platforms, as listed at the top of this page. The following sections
+ detail preferences that apply to more than one platform.
+
+## Global Preferences
+
+The following global preferences apply to all platforms:
+
+- `Fullscreen` allows you to hide the status bar at the top of the
+ screen. The default value is `false`. Example:
+
+ <preference name="Fullscreen" value="true" />
+
+- `Orientation` allows you to lock orientation and prevent the
+ interface from rotating in response to changes in orientation.
+ Possible values are `default`, `landscape`, or `portrait`. Example:
+
+ <preference name="Orientation" value="landscape" />
+
+ __NOTE__: The `default` value means _both_ landscape and portrait
+ orientations are enabled. If you want to use each platform's
+ default settings (usually portrait-only), leave this tag out of the
+ `config.xml` file.
+
+## Multi-Platform Preferences
+
+The following preferences apply to more than one platform, but not to
+all of them:
+
+- `DisallowOverscroll` (boolean, defaults to `false`): set to `true`
+ if you don't want the interface to display any feedback when users
+ scroll past the beginning or end of content.
+
+ <preference name="DisallowOverscroll" value="true"/>
+
+ Applies to Android and iOS. On iOS, overscroll gestures cause
+ content to bounce back to its original position. On Android, they
+ produce a more subtle glowing effect along the top or bottom edge of
+ the content.
+
+- `BackgroundColor`: Set the app's background color. Supports a
+ four-byte hex value, with the first byte representing the alpha
+ channel, and standard RGB values for the following three bytes. This
+ example specifies blue:
+
+ <preference name="BackgroundColor" value="0xff0000ff"/>
+
+ Applies to Android and BlackBerry. Overrides CSS otherwise available
+ across _all_ platforms, for example: `body{background-color:blue}`.
+
+- `HideKeyboardFormAccessoryBar` (boolean, defaults to `false`): set
+ to `true` to hide the additional toolbar that appears above the
+ keyboard, helping users navigate from one form input to another.
+
+ <preference name="HideKeyboardFormAccessoryBar" value="true"/>
+
+ Applies to iOS and BlackBerry.
+
+## The _feature_ Element
+
+If you use the CLI to build applications, you use the `plugin` command
+to enable device APIs. This does not modify the top-level `config.xml`
+file, so the `<feature>` element does not apply to your workflow. If
+you work directly in an SDK and using the platform-specific
+`config.xml` file as source, you use the `<feature>` tag to enable
+device-level APIs and external plugins. They typically appear in this
+form:
+
+ <feature name="Plugin" value="PluginID" />
+
+They often appear with custom values in platform-specific `config.xml`
+files. For example, here is how to specify the Device API for Android
+projects:
+
+ <feature name="Device">
+ <param name="android-package" value="org.apache.cordova.device.Device" />
+ </feature>
+
+Here is how the element appears for iOS projects:
+
+ <feature name="Device">
+ <param name="ios-package" value="CDVDevice" />
+ </feature>
+
+See the API Reference for details on how to specify each feature. See
+the Plugin Development Guide for more information on plugins.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/cordova/accelerometer/acceleration/acceleration.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/cordova/accelerometer/acceleration/acceleration.md b/docs/en/3.3.0/cordova/accelerometer/acceleration/acceleration.md
new file mode 100644
index 0000000..ac4042a
--- /dev/null
+++ b/docs/en/3.3.0/cordova/accelerometer/acceleration/acceleration.md
@@ -0,0 +1,104 @@
+---
+ license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Acceleration
+
+Contains `Accelerometer` data captured at a specific point in time.
+
+## Properties
+
+- __x__: Amount of acceleration on the x-axis. (in m/s^2) _(Number)_
+- __y__: Amount of acceleration on the y-axis. (in m/s^2) _(Number)_
+- __z__: Amount of acceleration on the z-axis. (in m/s^2) _(Number)_
+- __timestamp__: Creation timestamp in milliseconds. _(DOMTimeStamp)_
+
+## Description
+
+An `Acceleration` object is populated and returned by any of the API's
+`Accelerometer` methods. Acceleration values include the effect of
+gravity (9.81 m/s^2), so that when a device lies flat and facing up,
+_x_, _y_, and _z_ values returned should be `0`, `0`, and `9.81`.
+
+## Supported Platforms
+
+- Amazon Fire OS
+- Android
+- BlackBerry 10
+- iOS
+- Tizen
+- Windows Phone 7 and 8
+- Windows 8
+
+## Quick Example
+
+ function onSuccess(acceleration) {
+ alert('Acceleration X: ' + acceleration.x + '\n' +
+ 'Acceleration Y: ' + acceleration.y + '\n' +
+ 'Acceleration Z: ' + acceleration.z + '\n' +
+ 'Timestamp: ' + acceleration.timestamp + '\n');
+ };
+
+ function onError() {
+ alert('onError!');
+ };
+
+ navigator.accelerometer.getCurrentAcceleration(onSuccess, onError);
+
+## Full Example
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Acceleration Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ navigator.accelerometer.getCurrentAcceleration(onSuccess, onError);
+ }
+
+ // onSuccess: Get a snapshot of the current acceleration
+ //
+ function onSuccess(acceleration) {
+ alert('Acceleration X: ' + acceleration.x + '\n' +
+ 'Acceleration Y: ' + acceleration.y + '\n' +
+ 'Acceleration Z: ' + acceleration.z + '\n' +
+ 'Timestamp: ' + acceleration.timestamp + '\n');
+ }
+
+ // onError: Failed to get the acceleration
+ //
+ function onError() {
+ alert('onError!');
+ }
+
+ </script>
+ </head>
+ <body>
+ <h1>Example</h1>
+ <p>getCurrentAcceleration</p>
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/cordova/accelerometer/accelerometer.clearWatch.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/cordova/accelerometer/accelerometer.clearWatch.md b/docs/en/3.3.0/cordova/accelerometer/accelerometer.clearWatch.md
new file mode 100644
index 0000000..1a3c378
--- /dev/null
+++ b/docs/en/3.3.0/cordova/accelerometer/accelerometer.clearWatch.md
@@ -0,0 +1,111 @@
+---
+ license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# accelerometer.clearWatch
+
+Stop watching the `Acceleration` referenced by the `watchID` parameter.
+
+ navigator.accelerometer.clearWatch(watchID);
+
+- __watchID__: The ID returned by `accelerometer.watchAcceleration`.
+
+## Supported Platforms
+
+- Amazon Fire OS
+- Android
+- BlackBerry 10
+- iOS
+- Tizen
+- Windows Phone 7 and 8
+- Windows 8
+
+## Quick Example
+
+ var watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);
+
+ // ... later on ...
+
+ navigator.accelerometer.clearWatch(watchID);
+
+## Full Example
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Acceleration Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // The watch id references the current `watchAcceleration`
+ var watchID = null;
+
+ // Wait for device API libraries to load
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ startWatch();
+ }
+
+ // Start watching the acceleration
+ //
+ function startWatch() {
+
+ // Update acceleration every 3 seconds
+ var options = { frequency: 3000 };
+
+ watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);
+ }
+
+ // Stop watching the acceleration
+ //
+ function stopWatch() {
+ if (watchID) {
+ navigator.accelerometer.clearWatch(watchID);
+ watchID = null;
+ }
+ }
+
+ // onSuccess: Get a snapshot of the current acceleration
+ //
+ function onSuccess(acceleration) {
+ var element = document.getElementById('accelerometer');
+
+ element.innerHTML = 'Acceleration X: ' + acceleration.x + '<br />' +
+ 'Acceleration Y: ' + acceleration.y + '<br />' +
+ 'Acceleration Z: ' + acceleration.z + '<br />' +
+ 'Timestamp: ' + acceleration.timestamp + '<br />';
+ }
+
+ // onError: Failed to get the acceleration
+ //
+ function onError() {
+ alert('onError!');
+ }
+
+ </script>
+ </head>
+ <body>
+ <div id="accelerometer">Waiting for accelerometer...</div>
+ <button onclick="stopWatch();">Stop Watching</button>
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/cordova/accelerometer/accelerometer.getCurrentAcceleration.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/cordova/accelerometer/accelerometer.getCurrentAcceleration.md b/docs/en/3.3.0/cordova/accelerometer/accelerometer.getCurrentAcceleration.md
new file mode 100644
index 0000000..19eaf15
--- /dev/null
+++ b/docs/en/3.3.0/cordova/accelerometer/accelerometer.getCurrentAcceleration.md
@@ -0,0 +1,109 @@
+---
+ license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# accelerometer.getCurrentAcceleration
+
+Get the current acceleration along the _x_, _y_, and _z_ axes.
+
+ navigator.accelerometer.getCurrentAcceleration(accelerometerSuccess, accelerometerError);
+
+## Description
+
+The accelerometer is a motion sensor that detects the change (_delta_)
+in movement relative to the current device orientation, in three
+dimensions along the _x_, _y_, and _z_ axis.
+
+These acceleration values are returned to the `accelerometerSuccess`
+callback function.
+
+## Supported Platforms
+
+- Amazon Fire OS
+- Android
+- BlackBerry 10
+- iOS
+- Tizen
+- Windows Phone 7 and 8
+- Windows 8
+
+## Quick Example
+
+ function onSuccess(acceleration) {
+ alert('Acceleration X: ' + acceleration.x + '\n' +
+ 'Acceleration Y: ' + acceleration.y + '\n' +
+ 'Acceleration Z: ' + acceleration.z + '\n' +
+ 'Timestamp: ' + acceleration.timestamp + '\n');
+ };
+
+ function onError() {
+ alert('onError!');
+ };
+
+ navigator.accelerometer.getCurrentAcceleration(onSuccess, onError);
+
+## Full Example
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Acceleration Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ navigator.accelerometer.getCurrentAcceleration(onSuccess, onError);
+ }
+
+ // onSuccess: Get a snapshot of the current acceleration
+ //
+ function onSuccess(acceleration) {
+ alert('Acceleration X: ' + acceleration.x + '\n' +
+ 'Acceleration Y: ' + acceleration.y + '\n' +
+ 'Acceleration Z: ' + acceleration.z + '\n' +
+ 'Timestamp: ' + acceleration.timestamp + '\n');
+ }
+
+ // onError: Failed to get the acceleration
+ //
+ function onError() {
+ alert('onError!');
+ }
+
+ </script>
+ </head>
+ <body>
+ <h1>Example</h1>
+ <p>getCurrentAcceleration</p>
+ </body>
+ </html>
+
+## iOS Quirks
+
+- iOS doesn't recognize the concept of getting the current acceleration at any given point.
+
+- You must watch the acceleration and capture the data at given time intervals.
+
+- Thus, the `getCurrentAcceleration` function yields the last value reported from a `watchAccelerometer` call.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/cordova/accelerometer/accelerometer.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/cordova/accelerometer/accelerometer.md b/docs/en/3.3.0/cordova/accelerometer/accelerometer.md
new file mode 100644
index 0000000..255727e
--- /dev/null
+++ b/docs/en/3.3.0/cordova/accelerometer/accelerometer.md
@@ -0,0 +1,86 @@
+---
+ license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Accelerometer
+
+> Captures device motion in the _x_, _y_, and _z_ direction.
+
+## Methods
+
+- accelerometer.getCurrentAcceleration
+- accelerometer.watchAcceleration
+- accelerometer.clearWatch
+
+## Arguments
+
+- accelerometerSuccess
+- accelerometerError
+- accelerometerOptions
+
+## Objects (Read-Only)
+
+- Acceleration
+
+## Accessing the Feature
+
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-Line
+Interface, to add or remove this feature for a project:
+
+ $ cordova plugin add org.apache.cordova.device-motion
+ $ cordova plugin ls
+ [ 'org.apache.cordova.device-motion' ]
+ $ cordova plugin rm org.apache.cordova.device-motion
+
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
+
+* Amazon Fire OS (in `res/xml/config.xml`)
+
+ <feature name="Accelerometer">
+ <param name="android-package" value="org.apache.cordova.devicemotion.AccelListener" />
+ </feature>
+
+* Android (in `res/xml/config.xml`)
+
+ <feature name="Accelerometer">
+ <param name="android-package" value="org.apache.cordova.devicemotion.AccelListener" />
+ </feature>
+
+* BlackBerry 10
+
+ (in www/config.xml)
+ <feature name="Accelerometer" value="Accelerometer" />
+
+* iOS (in the named application directory's `config.xml`)
+
+ <feature name="Accelerometer">
+ <param name="ios-package" value="CDVAccelerometer" />
+ </feature>
+
+* Windows Phone (in `Properties/WPAppManifest.xml`)
+
+ <Capabilities>
+ <Capability Name="ID_CAP_SENSORS" />
+ </Capabilities>
+
+ Reference: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)
+
+Some platforms may support this feature without requiring any special
+configuration. See Platform Support for an overview.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/cordova/accelerometer/accelerometer.watchAcceleration.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/cordova/accelerometer/accelerometer.watchAcceleration.md b/docs/en/3.3.0/cordova/accelerometer/accelerometer.watchAcceleration.md
new file mode 100644
index 0000000..c0707c2
--- /dev/null
+++ b/docs/en/3.3.0/cordova/accelerometer/accelerometer.watchAcceleration.md
@@ -0,0 +1,142 @@
+---
+ license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# accelerometer.watchAcceleration
+
+At a regular interval, get the acceleration along the _x_, _y_, and _z_ axis.
+
+ var watchID = navigator.accelerometer.watchAcceleration(accelerometerSuccess,
+ accelerometerError,
+ [accelerometerOptions]);
+
+## Description
+
+The accelerometer is a motion sensor that detects the change (delta)
+in movement relative to the current position. The accelerometer can
+detect 3D movement along the _x_, _y_, and _z_ axis.
+
+The `accelerometer.watchAcceleration` method retrieves the device's
+current `Acceleration` at a regular interval, executing the
+`accelerometerSuccess` callback function each time. Specify the
+interval in milliseconds via the `acceleratorOptions` object's
+`frequency` parameter.
+
+The returned watch ID references the accelerometer's watch interval,
+and can be used with `accelerometer.clearWatch` to stop watching the
+accelerometer.
+
+## Supported Platforms
+
+- Amazon Fire OS
+- Android
+- BlackBerry 10
+- iOS
+- Tizen
+- Windows Phone 7 and 8
+- Windows 8
+
+## Quick Example
+
+ function onSuccess(acceleration) {
+ alert('Acceleration X: ' + acceleration.x + '\n' +
+ 'Acceleration Y: ' + acceleration.y + '\n' +
+ 'Acceleration Z: ' + acceleration.z + '\n' +
+ 'Timestamp: ' + acceleration.timestamp + '\n');
+ };
+
+ function onError() {
+ alert('onError!');
+ };
+
+ var options = { frequency: 3000 }; // Update every 3 seconds
+
+ var watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);
+
+## Full Example
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Acceleration Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // The watch id references the current `watchAcceleration`
+ var watchID = null;
+
+ // Wait for device API libraries to load
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ startWatch();
+ }
+
+ // Start watching the acceleration
+ //
+ function startWatch() {
+
+ // Update acceleration every 3 seconds
+ var options = { frequency: 3000 };
+
+ watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);
+ }
+
+ // Stop watching the acceleration
+ //
+ function stopWatch() {
+ if (watchID) {
+ navigator.accelerometer.clearWatch(watchID);
+ watchID = null;
+ }
+ }
+
+ // onSuccess: Get a snapshot of the current acceleration
+ //
+ function onSuccess(acceleration) {
+ var element = document.getElementById('accelerometer');
+ element.innerHTML = 'Acceleration X: ' + acceleration.x + '<br />' +
+ 'Acceleration Y: ' + acceleration.y + '<br />' +
+ 'Acceleration Z: ' + acceleration.z + '<br />' +
+ 'Timestamp: ' + acceleration.timestamp + '<br />';
+ }
+
+ // onError: Failed to get the acceleration
+ //
+ function onError() {
+ alert('onError!');
+ }
+
+ </script>
+ </head>
+ <body>
+ <div id="accelerometer">Waiting for accelerometer...</div>
+ </body>
+ </html>
+
+## iOS Quirks
+
+The API calls the success callback function at the interval requested,
+but restricts the range of requests to the device between 40ms and
+1000ms. For example, if you request an interval of 3 seconds,
+(3000ms), the API requests data from the device every 1 second, but
+only executes the success callback every 3 seconds.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/cordova/accelerometer/parameters/accelerometerError.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/cordova/accelerometer/parameters/accelerometerError.md b/docs/en/3.3.0/cordova/accelerometer/parameters/accelerometerError.md
new file mode 100644
index 0000000..6dda5c2
--- /dev/null
+++ b/docs/en/3.3.0/cordova/accelerometer/parameters/accelerometerError.md
@@ -0,0 +1,26 @@
+---
+ license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# accelerometerError
+
+onError callback function for acceleration functions.
+
+ function() {
+ // Handle the error
+ }
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/cordova/accelerometer/parameters/accelerometerOptions.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/cordova/accelerometer/parameters/accelerometerOptions.md b/docs/en/3.3.0/cordova/accelerometer/parameters/accelerometerOptions.md
new file mode 100644
index 0000000..b9ebcb5
--- /dev/null
+++ b/docs/en/3.3.0/cordova/accelerometer/parameters/accelerometerOptions.md
@@ -0,0 +1,26 @@
+---
+ license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# accelerometerOptions
+
+An optional parameter to customize the retrieval of accelerometer values.
+
+## Options
+
+- __frequency__: How often to retrieve the `Acceleration` in milliseconds. _(Number)_ (Default: 10000)
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/cordova/accelerometer/parameters/accelerometerSuccess.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/cordova/accelerometer/parameters/accelerometerSuccess.md b/docs/en/3.3.0/cordova/accelerometer/parameters/accelerometerSuccess.md
new file mode 100644
index 0000000..c07a617
--- /dev/null
+++ b/docs/en/3.3.0/cordova/accelerometer/parameters/accelerometerSuccess.md
@@ -0,0 +1,39 @@
+---
+ license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# accelerometerSuccess
+
+onSuccess callback function that provides the `Acceleration` information.
+
+ function(acceleration) {
+ // Do something
+ }
+
+## Parameters
+
+- __acceleration__: The acceleration at a single moment in time. (Acceleration)
+
+## Example
+
+ function onSuccess(acceleration) {
+ alert('Acceleration X: ' + acceleration.x + '\n' +
+ 'Acceleration Y: ' + acceleration.y + '\n' +
+ 'Acceleration Z: ' + acceleration.z + '\n' +
+ 'Timestamp: ' + acceleration.timestamp + '\n');
+ };
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/cordova/camera/camera.cleanup.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/cordova/camera/camera.cleanup.md b/docs/en/3.3.0/cordova/camera/camera.cleanup.md
new file mode 100644
index 0000000..f195e70
--- /dev/null
+++ b/docs/en/3.3.0/cordova/camera/camera.cleanup.md
@@ -0,0 +1,48 @@
+---
+ license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# camera.cleanup
+
+Removes intermediate photos taken by the camera from temporary
+storage.
+
+ navigator.camera.cleanup( cameraSuccess, cameraError );
+
+## Description
+
+Removes 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`.
+
+## Supported Platforms
+
+- iOS
+
+## Example
+
+ navigator.camera.cleanup(onSuccess, onFail);
+
+ function onSuccess() {
+ console.log("Camera cleanup success.")
+ }
+
+ function onFail(message) {
+ alert('Failed because: ' + message);
+ }
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/cordova/camera/camera.getPicture.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/cordova/camera/camera.getPicture.md b/docs/en/3.3.0/cordova/camera/camera.getPicture.md
new file mode 100644
index 0000000..955870d
--- /dev/null
+++ b/docs/en/3.3.0/cordova/camera/camera.getPicture.md
@@ -0,0 +1,255 @@
+---
+ license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# camera.getPicture
+
+Takes a photo using the camera, or retrieves a photo from the device's
+image gallery. The image is passed to the success callback as a
+base64-encoded `String`, or as the URI for the image file. The method
+itself returns a `CameraPopoverHandle` object that can be used to
+reposition the file selection popover.
+
+ navigator.camera.getPicture( cameraSuccess, cameraError, [ cameraOptions ] );
+
+## Description
+
+The `camera.getPicture` function opens the device's default camera
+application that allows users to snap pictures. This behavior occurs
+by default, when `Camera.sourceType` equals
+`Camera.PictureSourceType.CAMERA`. Once the user snaps the photo, the
+camera application closes and the application is restored.
+
+If `Camera.sourceType` is `Camera.PictureSourceType.PHOTOLIBRARY` or
+`Camera.PictureSourceType.SAVEDPHOTOALBUM`, then a dialog displays
+that allows users to select an existing image. The
+`camera.getPicture` function returns a `CameraPopoverHandle` object,
+which can be used to reposition the image selection dialog, for
+example, when the device orientation changes.
+
+The return value is sent to the `cameraSuccess` callback function, in
+one of the following formats, depending on the specified
+`cameraOptions`:
+
+- A `String` containing the base64-encoded photo image.
+
+- A `String` representing the image file location on local storage (default).
+
+You can do whatever you want with the encoded image or URI, for
+example:
+
+- Render the image in an `<img>` tag, as in the example below
+
+- Save the data locally (`LocalStorage`, [Lawnchair](http://brianleroux.github.com/lawnchair/), etc.)
+
+- Post the data to a remote server
+
+__NOTE__: Photo resolution on newer devices is quite good. Photos
+selected from the device's gallery are not downscaled to a lower
+quality, even if a `quality` parameter is specified. To avoid common
+memory problems, set `Camera.destinationType` to `FILE_URI` rather
+than `DATA_URL`.
+
+## Supported Platforms
+
+- Amazon Fire OS
+- Android
+- BlackBerry 10
+- iOS
+- Tizen
+- Windows Phone 7 and 8
+- Windows 8
+
+## Amazon Fire OS Quirks
+
+Amazon Fire OS uses intents to launch the camera activity on the device to capture
+images, and on phones with low memory, the Cordova activity may be killed. In this
+scenario, the image may not appear when the cordova activity is restored.
+
+## Android Quirks
+
+*Android 4.4 only*: Android 4.4 introduced a new [Storage Access Framework](https://developer.android.com/guide/topics/providers/document-provider.html) that makes it
+easier for users to browse and open documents across all of their preferred document storage providers.
+Cordova has not yet been fully integrated with this new Storage Access Framework. Because of this, the `getPicture()`
+method will not correctly return pictures when the user selects from the "Recent", "Drive", "Images", or "External
+Storage" folders when the `destinationType` is `FILE_URI`. However, the user will be able to correctly select any pictures
+if they go through the "Gallery" app first. Potential workarounds for this issue are documented on [this StackOverflow question](http://stackoverflow.com/questions/19834842/android-gallery-on-kitkat-returns-different-uri-for-intent-action-get-content/20177611). Please see [CB-5398](https://issues.apache.org/jira/browse/CB-5398) to track this issue.
+
+Android uses intents to launch the camera activity on the device to capture
+images, and on phones with low memory, the Cordova activity may be killed. In this
+scenario, the image may not appear when the Cordova activity is restored.
+
+## iOS Quirks
+
+Including a JavaScript `alert()` in either of the callback functions
+can cause problems. Wrap the alert within a `setTimeout()` to allow
+the iOS image picker or popover to fully close before the alert
+displays:
+
+ setTimeout(function() {
+ // do your thing here!
+ }, 0);
+
+## Windows Phone 7 Quirks
+
+Invoking the native camera application while the device is connected
+via Zune does not work, and triggers an error callback.
+
+## Tizen Quirks
+
+Tizen only supports a `destinationType` of
+`Camera.DestinationType.FILE_URI` and a `sourceType` of
+`Camera.PictureSourceType.PHOTOLIBRARY`.
+
+## Quick Example
+
+Take a photo and retrieve it as a base64-encoded image:
+
+ navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
+ destinationType: Camera.DestinationType.DATA_URL
+ });
+
+ function onSuccess(imageData) {
+ var image = document.getElementById('myImage');
+ image.src = "data:image/jpeg;base64," + imageData;
+ }
+
+ function onFail(message) {
+ alert('Failed because: ' + message);
+ }
+
+Take a photo and retrieve the image's file location:
+
+ navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
+ destinationType: Camera.DestinationType.FILE_URI });
+
+ function onSuccess(imageURI) {
+ var image = document.getElementById('myImage');
+ image.src = imageURI;
+ }
+
+ function onFail(message) {
+ alert('Failed because: ' + message);
+ }
+
+## Full Example
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Capture Photo</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ var pictureSource; // picture source
+ var destinationType; // sets the format of returned value
+
+ // Wait for device API libraries to load
+ //
+ document.addEventListener("deviceready",onDeviceReady,false);
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ pictureSource=navigator.camera.PictureSourceType;
+ destinationType=navigator.camera.DestinationType;
+ }
+
+ // Called when a photo is successfully retrieved
+ //
+ function onPhotoDataSuccess(imageData) {
+ // Uncomment to view the base64-encoded image data
+ // console.log(imageData);
+
+ // Get image handle
+ //
+ var smallImage = document.getElementById('smallImage');
+
+ // Unhide image elements
+ //
+ smallImage.style.display = 'block';
+
+ // Show the captured photo
+ // The in-line CSS rules are used to resize the image
+ //
+ smallImage.src = "data:image/jpeg;base64," + imageData;
+ }
+
+ // Called when a photo is successfully retrieved
+ //
+ function onPhotoURISuccess(imageURI) {
+ // Uncomment to view the image file URI
+ // console.log(imageURI);
+
+ // Get image handle
+ //
+ var largeImage = document.getElementById('largeImage');
+
+ // Unhide image elements
+ //
+ largeImage.style.display = 'block';
+
+ // Show the captured photo
+ // The in-line CSS rules are used to resize the image
+ //
+ largeImage.src = imageURI;
+ }
+
+ // A button will call this function
+ //
+ function capturePhoto() {
+ // Take picture using device camera and retrieve image as base64-encoded string
+ navigator.camera.getPicture(onPhotoDataSuccess, onFail, { quality: 50,
+ destinationType: destinationType.DATA_URL });
+ }
+
+ // A button will call this function
+ //
+ function capturePhotoEdit() {
+ // Take picture using device camera, allow edit, and retrieve image as base64-encoded string
+ navigator.camera.getPicture(onPhotoDataSuccess, onFail, { quality: 20, allowEdit: true,
+ destinationType: destinationType.DATA_URL });
+ }
+
+ // A button will call this function
+ //
+ function getPhoto(source) {
+ // Retrieve image file location from specified source
+ navigator.camera.getPicture(onPhotoURISuccess, onFail, { quality: 50,
+ destinationType: destinationType.FILE_URI,
+ sourceType: source });
+ }
+
+ // Called if something bad happens.
+ //
+ function onFail(message) {
+ alert('Failed because: ' + message);
+ }
+
+ </script>
+ </head>
+ <body>
+ <button onclick="capturePhoto();">Capture Photo</button> <br>
+ <button onclick="capturePhotoEdit();">Capture Editable Photo</button> <br>
+ <button onclick="getPhoto(pictureSource.PHOTOLIBRARY);">From Photo Library</button><br>
+ <button onclick="getPhoto(pictureSource.SAVEDPHOTOALBUM);">From Photo Album</button><br>
+ <img style="display:none;width:60px;height:60px;" id="smallImage" src="" />
+ <img style="display:none;" id="largeImage" src="" />
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/cordova/camera/camera.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/cordova/camera/camera.md b/docs/en/3.3.0/cordova/camera/camera.md
new file mode 100644
index 0000000..a95632f
--- /dev/null
+++ b/docs/en/3.3.0/cordova/camera/camera.md
@@ -0,0 +1,103 @@
+---
+ license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Camera
+
+> The `camera` object provides access to the device's default camera application.
+
+__WARNING__: Collection and use of images from a
+device's camera raises important privacy issues. Your app's privacy
+policy should discuss how the app uses the camera and whether the
+images recorded are shared with any other parties. In addition, if
+the app's use of the camera is not apparent in the user interface, you
+should provide a just-in-time notice before the app accesses the
+camera (if the device operating system doesn't do so already). That
+notice should provide the same information noted above, as well as
+obtaining the user's permission (e.g., by presenting choices for
+__OK__ and __No Thanks__). For more information, please see the
+Privacy Guide.
+
+## Methods
+
+- camera.getPicture
+- camera.cleanup
+
+## Accessing the Feature
+
+As of version 3.0, Cordova implements device-level APIs as _plugins_.
+Use the CLI's `plugin` command, described in The Command-Line
+Interface, to add or remove this feature for a project:
+
+ $ cordova plugin add org.apache.cordova.camera
+ $ cordova plugin ls
+ [ 'org.apache.cordova.camera' ]
+ $ cordova plugin rm org.apache.cordova.camera
+
+These commands apply to all targeted platforms, but modify the
+platform-specific configuration settings described below:
+
+* Amazon Fire OS
+
+ (in app/res/xml/config.xml)
+ <feature name="Camera">
+ <param name="android-package" value="org.apache.cordova.camera.CameraLauncher" />
+ </feature>
+
+ (in app/AndroidManifest)
+ <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+
+* Android
+
+ (in app/res/xml/config.xml)
+ <feature name="Camera">
+ <param name="android-package" value="org.apache.cordova.camera.CameraLauncher" />
+ </feature>
+
+ (in app/AndroidManifest)
+ <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+
+* BlackBerry 10
+
+ (in www/config.xml)
+ <feature name="Camera" value="Camera"/>
+
+* iOS (in the named application directory's `config.xml`)
+
+ <feature name="Camera">
+ <param name="ios-package" value="CDVCamera" />
+ </feature>
+
+* Windows Phone (in `Properties/WPAppManifest.xml`)
+
+ <Capabilities>
+ <Capability Name="ID_CAP_ISV_CAMERA" />
+ <Capability Name="ID_HW_FRONTCAMERA" />
+ </Capabilities>
+
+ Reference: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)
+
+* Tizen (in `config.xml`)
+
+ <feature name="http://tizen.org/api/application" required="true"/>
+ <feature name="http://tizen.org/api/application.launch" required="true"/>
+
+ Reference: [Application Manifest for Tizen Web Application](https://developer.tizen.org/help/topic/org.tizen.help.gs/Creating%20a%20Project.html?path=0_1_1_3#8814682_CreatingaProject-EditingconfigxmlFeatures)
+
+Some platforms may support this feature without requiring any special
+configuration. See Platform Support for an overview.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/cordova/camera/parameter/CameraPopoverHandle.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/cordova/camera/parameter/CameraPopoverHandle.md b/docs/en/3.3.0/cordova/camera/parameter/CameraPopoverHandle.md
new file mode 100644
index 0000000..594f30b
--- /dev/null
+++ b/docs/en/3.3.0/cordova/camera/parameter/CameraPopoverHandle.md
@@ -0,0 +1,63 @@
+---
+ license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# CameraPopoverHandle
+
+A handle to the popover dialog created by `camera.getPicture`.
+
+## Methods
+
+- __setPosition__: Set the position of the popover.
+
+## Supported Platforms
+
+- iOS
+
+## setPosition
+
+Set the position of the popover.
+
+__Parameters__:
+
+- `cameraPopoverOptions`: the `CameraPopoverOptions` that specify the new position
+
+## Quick Example
+
+ var cameraPopoverOptions = new CameraPopoverOptions(300, 300, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY);
+ cameraPopoverHandle.setPosition(cameraPopoverOptions);
+
+## Full Example
+
+ function onSuccess(imageData) {
+ // Do stuff with the image!
+ }
+
+ function onFail(message) {
+ alert('Failed to get the picture: ' + message);
+ }
+
+ var cameraPopoverHandle = navigator.camera.getPicture(onSuccess, onFail,
+ { destinationType: Camera.DestinationType.FILE_URI,
+ sourceType: Camera.PictureSourceType.PHOTOLIBRARY });
+
+ // Reposition the popover if the orientation changes.
+ window.onorientationchange = function() {
+ var cameraPopoverOptions = new CameraPopoverOptions(0, 0, 100, 100, 0);
+ cameraPopoverHandle.setPosition(cameraPopoverOptions);
+ }
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/cordova/camera/parameter/CameraPopoverOptions.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/cordova/camera/parameter/CameraPopoverOptions.md b/docs/en/3.3.0/cordova/camera/parameter/CameraPopoverOptions.md
new file mode 100644
index 0000000..e5d2902
--- /dev/null
+++ b/docs/en/3.3.0/cordova/camera/parameter/CameraPopoverOptions.md
@@ -0,0 +1,77 @@
+---
+ license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# 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.
+
+ { x : 0,
+ y : 32,
+ width : 320,
+ height : 480,
+ arrowDir : Camera.PopoverArrowDirection.ARROW_ANY
+ };
+
+## CameraPopoverOptions
+
+- __x__: x pixel coordinate of screen element onto which to anchor the popover. _(Number)_
+
+- __y__: y pixel coordinate of screen element onto which to anchor the popover. _(Number)_
+
+- __width__: width, in pixels, of the screen element onto which to anchor the popover. _(Number)_
+
+- __height__: height, in pixels, of the screen element onto which to anchor the popover. _(Number)_
+
+- __arrowDir__: Direction the arrow on the popover should point. Defined in `Camera.PopoverArrowDirection` _(Number)_
+
+ Camera.PopoverArrowDirection = {
+ ARROW_UP : 1, // matches iOS UIPopoverArrowDirection constants
+ ARROW_DOWN : 2,
+ ARROW_LEFT : 4,
+ ARROW_RIGHT : 8,
+ ARROW_ANY : 15
+ };
+
+Note that the size of the popover may change to adjust to the
+direction of the arrow and orientation of the screen. Make sure to
+account for orientation changes when specifying the anchor element
+location.
+
+## Quick Example
+
+ var popover = new CameraPopoverOptions(300, 300, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY);
+ var options = {
+ quality : 50,
+ destinationType : Camera.DestinationType.DATA_URL,
+ sourceType : Camera.PictureSource.SAVEDPHOTOALBUM,
+ popoverOptions : popover
+ };
+
+ navigator.camera.getPicture(onSuccess, onFail, options);
+
+ function onSuccess(imageData) {
+ var image = document.getElementById('myImage');
+ image.src = "data:image/jpeg;base64," + imageData;
+ }
+
+ function onFail(message) {
+ alert('Failed because: ' + message);
+ }
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c6219cfc/docs/en/3.3.0/cordova/camera/parameter/cameraError.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/cordova/camera/parameter/cameraError.md b/docs/en/3.3.0/cordova/camera/parameter/cameraError.md
new file mode 100644
index 0000000..33d1e32
--- /dev/null
+++ b/docs/en/3.3.0/cordova/camera/parameter/cameraError.md
@@ -0,0 +1,30 @@
+---
+ license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# cameraError
+
+onError callback function that provides an error message.
+
+ function(message) {
+ // Show a helpful message
+ }
+
+## Parameters
+
+- __message__: The message is provided by the device's native code. _(String)_