cameraOptions

Optional parameters to customize the camera settings.

{ quality : 75, 
  destinationType : Camera.DestinationType.DATA_URL, 
  sourceType : Camera.PictureSourceType.CAMERA, 
  allowEdit : true,
  encodingType: Camera.EncodingType.JPEG,
  targetWidth: 100,
  targetHeight: 100,
  popoverOptions: CameraPopoverOptions,
  saveToPhotoAlbum: false };

Options

  • quality: Quality of saved image. Range is [0, 100]. (Number)

  • destinationType: Choose the format of the return value. Defined in navigator.camera.DestinationType (Number)

          Camera.DestinationType = {
          DATA_URL : 0,                // Return image as base64 encoded string
          FILE_URI : 1                 // Return image file URI
      };

  • sourceType: Set the source of the picture. Defined in nagivator.camera.PictureSourceType (Number)

      Camera.PictureSourceType = {
      PHOTOLIBRARY : 0,
      CAMERA : 1,
      SAVEDPHOTOALBUM : 2
  };

  • allowEdit: Allow simple editing of image before selection. (Boolean)

  • encodingType: Choose the encoding of the returned image file. Defined in navigator.camera.EncodingType (Number)

          Camera.EncodingType = {
          JPEG : 0,               // Return JPEG encoded image
          PNG : 1                 // Return PNG encoded image
      };
  • targetWidth: Width in pixels to scale image. Must be used with targetHeight. Aspect ratio is maintained. (Number)

  • targetHeight: Height in pixels to scale image. Must be used with targetWidth. Aspect ratio is maintained. (Number)

  • mediaType: Set the type of media to select from. Only works when PictureSourceType is PHOTOLIBRARY or SAVEDPHOTOALBUM. Defined in nagivator.camera.MediaType (Number)

      Camera.MediaType = { 
      PICTURE: 0,             // allow selection of still pictures only. DEFAULT. Will return format specified via DestinationType
      VIDEO: 1,               // allow selection of video only, WILL ALWAYS RETURN FILE_URI
      ALLMEDIA : 2			// allow selection from all media types };
  • correctOrientation: Rotate the image to correct for the orientation of the device during capture. (Boolean)
  • saveToPhotoAlbum: Save the image to the photo album on the device after capture. (Boolean)
  • popoverOptions: iOS only options to specify popover location in iPad. Defined in CameraPopoverOptions

Android Quirks

  • Ignores the allowEdit parameter.
  • Camera.PictureSourceType.PHOTOLIBRARY and Camera.PictureSourceType.SAVEDPHOTOALBUM both display the same photo album.

BlackBerry Quirks

  • Ignores the quality parameter.
  • Ignores the sourceType parameter.
  • Ignores the allowEdit parameter.
  • Application must have key injection permissions to close native Camera application after photo is taken.
  • Using Large image sizes may result in inability to encode image on later model devices with high resolution cameras (e.g. Torch 9800).
  • Camera.MediaType is not supported.
  • Ignores the correctOrientation parameter.

webOS Quirks

  • Ignores the quality parameter.
  • Ignores the sourceType parameter.
  • Ignores the allowEdit parameter.
  • Camera.MediaType is not supported.
  • Ignores the correctOrientation parameter.
  • Ignores the saveToPhotoAlbum parameter.

iOS Quirks

  • Set quality below 50 to avoid memory error on some devices.
  • When destinationType.FILE_URI is used, photos are saved in the application's temporary directory.

Windows Phone 7 Quirks

  • Ignores the allowEdit parameter.
  • Ignores the correctOrientation parameter.

Bada 1.2 Quirks

  • options not supported
  • always returns a FILE URI