Camera - Zebra Technologies TechDocs

Overview

The Camera API provides access to the device camera(s). Use this API to give users the ability to take a photo via one of the cameras and return it to the application. Photos can either be stored on the device as an image file or returned as a DataURI object for storage and/or display. Optionally, image files also can be transfered to online storage using the Network API.

Enabling the API

There are two methods of enabling the Camera API:

Include all 'ebapi' modules
Include only the required API modules

Both methods are explained below.

Either way, the included files will be found in: /Enterprise Browser/JavaScript Files/Enterprise Browser, a directory on the computer that contains the Enterprise Browser installation.

Include all API modules

To include all JavaScript APIs, copy the ebapi-modules.js file to a location accessible by the app's files and include the JavaScript modules file in the app. For instance, to include the modules file in the app's index.html, copy the file to the same directory as the index.html and add the following line to the HEAD section of the index.html file:


<script type="text/javascript" charset="utf-8" src="ebapi-modules.js"></script>

This will define the EB class within the page. Note that the path for this file is relative to the current page (index.html). Any page on which the modules are required will need to have the required .js file(s) included in this fashion.

Include only the required modules

To include individual APIs, first include a reference to the ebapi.js in the HTML, and then the additional required API file(s). For instance, to use the Camera API, add the following code to the HTML file(s). Again, this assumes that relevant API files have been copied to the same directory as the HTML.


<script type="text/javascript" charset="utf-8" src="ebapi.js"></script>
<script type="text/javascript" charset="utf-8" src="eb.camera.js"></script>

In the code lines above, notice that ebapi.js is included first, followed by eb.camera.js, which is the Camera API for Enterprise Browser. This coding is required on each HTML page whenever an individual API will be called from that page.

Methods

capture()

Capture the image and save it to a file.

Parameters

callback : CallBackHandler

Callback

Async Callback Returning Parameters: HASH

status : STRING
Whether or not the image was successfully captured. The returned string will be one of 'ok' or 'error'.
imageUri : STRING
If the specified 'outputFormat' was 'image' then this field is the URI to the taken image stored on the device. If the specified 'outputFormat' was 'dataUri' then this field will be the image encoded as a Data URI, If the specified 'outputFormat' was 'imagePath' then this field will have the image path on the device. User can use image path to transfer image over http.
imageHeight : INTEGER
The actual height of the image that was captured, this may differ from the requested height as the Camera will only support a finite resolutions.
imageWidth : INTEGER
The actual width of the image that was captured, this may differ from the requested width as the Camera will only support a finite resolutions.
imageFormat : STRING
The format in which the image was captured, either 'png' or 'jpg'.
message : STRING
If the returned status is 'error' then this field will contain more information on the error.

Returns

Synchronous Return:

Void

Platforms

Windows Mobile
Windows CE

Method Access:

Instance Method: This method can be accessed via an instance object of this class:
- myObject.capture()
Default Instance: This method can be accessed via the default instance object of this class.
- EB.Camera.capture()

choosePicture(HASH propertyMap)

Choose a picture from the album.

Parameters

propertyMap : HASH Optional
Provide a set of properties to configure an image, for example to specify the image size or color mode. In WM/CE,Android devices user can only specify the outputFormat in the property bag. Valid `properties` for this parameter are the properties available to this API module. Check the property section for applicable properties. Not providing properties to this function will use the Camera's default properties, or those previously set on the Camera instance.
callback : CallBackHandler

Callback

Async Callback Returning Parameters: HASH

status : STRING
Whether or not the image was successfully chosen from the gallery. The returned string will be one of 'ok', 'cancel' or 'error'.
imageUri : STRING
If the specified 'outputFormat' was 'image' then this field is the URI to the taken image stored on the device. If the specified 'outputFormat' was 'dataUri' then this field will be the image encoded as a Data URI, If the specified 'outputFormat' was 'imagePath' then this field will have the image path on the device. User can use image path to transfer image over http. Platforms: Android, WM, CE
imageHeight : INTEGER
The height of the image.
imageWidth : INTEGER
The width of the image.
imageFormat : STRING
The format of the image, either 'png' or 'jpg'.
message : STRING
If the returned status is 'error' then this field will contain more information on the error. To maintain backward compatibility WM and Android platforms provides message for cancel status as well.
image_uri : STRING
If the specified 'outputFormat' was 'image' then this field is the URI to the taken image stored on the device. If the specified 'outputFormat' was 'dataUri' then this field will be the image encoded as a Data URI, If the specified 'outputFormat' was 'imagePath' then this field will have the image path on the device. User can use image path to transfer image over http. Platforms: Android, WM, CE
image_height : INTEGER
It is recommended to use imageHeight in preference to this parameter.
image_width : INTEGER
It is recommended to use imageWidth in preference to this parameter.
image_format : STRING
It is recommended to use imageFormat in preference to this parameter.

Returns

Synchronous Return:

Void

Platforms

Android
Windows Mobile

Method Access:

Class Method: This method can only be accessed via the API class object.
- EB.Camera.choosePicture(HASH propertyMap)

copyImageToDeviceGallery(STRING pathToImage)

Save an image to the device gallery.

Parameters

pathToImage : STRING
The real path to the image that is to be saved in the device gallery. You need to use the RhoApplication method `expandDatabaseBlobFilePath` to have the real path, such as `Rho::RhoApplication::expandDatabaseBlobFilePath(img.image_uri)`.
callback : CallBackHandler

Returns

Synchronous Return:

Void

Platforms

Android

Method Access:

Class Method: This method can only be accessed via the API class object.
- EB.Camera.copyImageToDeviceGallery(STRING pathToImage)

enumerate()

Returns the cameras present on your device, allowing you to access your device's front or back camera.

Parameters

callback : CallBackHandler

Callback

Async Callback Returning Parameters: ARRAY

cameraArray : SELF_INSTANCE: EB.Camera

Returns

Synchronous Return:

ARRAY : Array of objects.
- cameraArray : SELF_INSTANCE: EB.Camera

Platforms

Android
Windows Mobile
Windows CE

Method Access:

Class Method: This method can only be accessed via the API class object.
- EB.Camera.enumerate()

getAllProperties()

This method will return all of object/value pairs for the propertyNames of the API class.

Parameters

callback : CallBackHandler

Callback

Async Callback Returning Parameters: HASH

: STRING

Returns

Synchronous Return:

HASH : Map of all available properties
- : STRING

Platforms

Android
Windows Mobile

Method Access:

Instance Method: This method can be accessed via an instance object of this class:
- myObject.getAllProperties()
Default Instance: This method can be accessed via the default instance object of this class.
- EB.Camera.getAllProperties()

getCameraByType(STRING cameraType)

Returns the camera of requested type if that camera exist - else return nil.

Parameters

cameraType : STRING
CameraType: 'back' or 'front' in the case of Android and 'color' or 'imager' in the case of WM, CE devices
callback : CallBackHandler

Callback

Async Callback Returning Parameters: SELF_INSTANCE

Returns

Synchronous Return:

SELF_INSTANCE : Camera with requested type or nil if not requested type does not exist. Refer example section for more details.

Platforms

Android
Windows Mobile
Windows CE

Method Access:

Class Method: This method can only be accessed via the API class object.
- EB.Camera.getCameraByType(STRING cameraType)

getDefault()

This method will return an object that represents the default instance of the API Class. For example Camera.getDefault will return a Camera object that represents the default camera.

Parameters

callback : CallBackHandler

Callback

Async Callback Returning Parameters: SELF_INSTANCE

Returns

Synchronous Return:

SELF_INSTANCE : Default object of Module.

Platforms

Android
Windows Mobile

Method Access:

Class Method: This method can only be accessed via the API class object.
- EB.Camera.getDefault()

getProperties(ARRAY arrayofNames)

This method will return a set of object/value pairs for the list of the propertyName that is passed in. The propertyNames must be a valid property of the API class.

Parameters

arrayofNames : ARRAY
List of properties I want to know about

Object : STRING

callback : CallBackHandler

Callback

Async Callback Returning Parameters: HASH

: STRING

Returns

Synchronous Return:

HASH : Map of properties I want to know about
- : STRING

Platforms

Android
Windows Mobile

Method Access:

Instance Method: This method can be accessed via an instance object of this class:
- myObject.getProperties(ARRAY arrayofNames)
Default Instance: This method can be accessed via the default instance object of this class.
- EB.Camera.getProperties(ARRAY arrayofNames)

getProperty(STRING propertyName)

This method will return the value of the propertyName that is passed in. The propertyName must be a valid property of the API class.

Parameters

propertyName : STRING
The property to return info about.
callback : CallBackHandler

Callback

Async Callback Returning Parameters: STRING

Returns

Synchronous Return:

STRING : The property to return info about.

Platforms

Android
Windows Mobile

Method Access:

Instance Method: This method can be accessed via an instance object of this class:
- myObject.getProperty(STRING propertyName)
Default Instance: This method can be accessed via the default instance object of this class.
- EB.Camera.getProperty(STRING propertyName)

hidePreview()

Hides the preview opened by using showPreview.

Parameters

callback : CallBackHandler

Returns

Synchronous Return:

Void

Platforms

Windows Mobile
Windows CE

Method Access:

Instance Method: This method can be accessed via an instance object of this class:
- myObject.hidePreview()
Default Instance: This method can be accessed via the default instance object of this class.
- EB.Camera.hidePreview()

setDefault(SELF_INSTANCE: EB.Camera defaultInstance)

This method allows you to set the attributes of the default object instance by passing in an object of the same class.

Parameters

defaultInstance : SELF_INSTANCE: EB.Camera
An instance object that is of the same class.
callback : CallBackHandler

Returns

Synchronous Return:

Void

Platforms

Android
Windows Mobile

Method Access:

Class Method: This method can only be accessed via the API class object.
- EB.Camera.setDefault(SELF_INSTANCE: EB.Camera defaultInstance)

setProperties(HASH propertyMap)

This method will set the values of a list of properties for the API class. The propertyName must be a valid property for the class and must also not be read only.

Parameters

propertyMap : HASH
Map of properties I want to set

Object : STRING

callback : CallBackHandler

Returns

Synchronous Return:

Void

Platforms

Android
Windows Mobile

Method Access:

Instance Method: This method can be accessed via an instance object of this class:
- myObject.setProperties(HASH propertyMap)
Default Instance: This method can be accessed via the default instance object of this class.
- EB.Camera.setProperties(HASH propertyMap)

setProperty(STRING propertyName, STRING propertyValue)

This method will set the value of a property for the API class. The propertyName must be a valid property for the class and must also not be read only.

Parameters

propertyName : STRING
The one property name that I want to set
propertyValue : STRING
The one property value that I want to set
callback : CallBackHandler

Returns

Synchronous Return:

Void

Platforms

Android
Windows Mobile

Method Access:

Instance Method: This method can be accessed via an instance object of this class:
- myObject.setProperty(STRING propertyName, STRING propertyValue)
Default Instance: This method can be accessed via the default instance object of this class.
- EB.Camera.setProperty(STRING propertyName, STRING propertyValue)

showPreview(HASH propertyMap)

Shows the preview in user configurable viewer window.

Parameters

propertyMap : HASH Optional
Provide a set of properties to configure the camera. Valid `properties` for this parameter are the properties available to this API module. Check the property section for applicable properties. Not providing properties to this function will use the Camera's default properties, or those previously set on the Camera instance.
callback : CallBackHandler

Returns

Synchronous Return:

Void

Platforms

Windows Mobile
Windows CE

Method Access:

Instance Method: This method can be accessed via an instance object of this class:
- myObject.showPreview(HASH propertyMap)
Default Instance: This method can be accessed via the default instance object of this class.
- EB.Camera.showPreview(HASH propertyMap)

takePicture(HASH propertyMap)

Start the camera application to take a picture. The user can capture the displayed image by interacting with the resident camera app. In Windows, this method always shows the preview in full screen and user can use the native button to capture the image. Refer examples mentioned below when outputFormat is set to image or dataUri.

Note: To display an image, it is recommended that you use the full path to the image instead of a relative path. To do this, you can use the expandDatabaseBlobFilePath method of the Application module as such:

JavaScript


Rho.RhoApplication.expandDatabaseBlobFilePath(x.image_uri)

Parameters

propertyMap : HASH Optional
Provide a set of properties to configure the camera, for example to specify the flashMode or compressionFormat. Valid `properties` for this parameter are the properties available to this API module. Check the property section for applicable properties. Not providing properties to this function will use the Camera's default properties, or those previously set on the Camera instance.
callback : CallBackHandler

Callback

Async Callback Returning Parameters: HASH

status : STRING
Whether or not the image was successfully captured. The returned string will be one of 'ok', 'cancel' or 'error'. Platforms: Android, WM, CE
imageUri : STRING
If the specified 'outputFormat' was 'image' then this field is the URI to the taken image stored on the device. If the specified 'outputFormat' was 'dataUri' then this field will be the image encoded as a Data URI, If the specified 'outputFormat' was 'imagePath' then this field will have the image path on the device. User can use image path to transfer image over http. Platforms: Android, WM, CE
imageHeight : INTEGER
The actual height of the image that was captured, this may differ from the requested height as the Camera will only support a finite resolutions. Platforms: Android, WM, CE
imageWidth : INTEGER
The actual width of the image that was captured, this may differ from the requested width as the Camera will only support a finite resolutions. Platforms: Android, WM, CE
imageFormat : STRING
The format in which the image was captured, either 'png' or 'jpg'. Platforms: Android, WM, CE
message : STRING
If the returned status is 'error' then this field will contain more information on the error. To maintain backward compatibility WM and Android platforms provides message for cancel status as well. Platforms: Android, WM, CE
image_uri : STRING
If the specified 'outputFormat' was 'image' then this field is the URI to the taken image stored on the device. If the specified 'outputFormat' was 'dataUri' then this field will be the image encoded as a Data URI, If the specified 'outputFormat' was 'imagePath' then this field will have the image path on the device. User can use image path to transfer image over http. Platforms: Android, WM, CE
image_height : INTEGER
It is recommended to use imageHeight in preference to this parameter. Platforms: Android, WM, CE
image_width : INTEGER
It is recommended to use imageWidth in preference to this parameter. Platforms: Android, WM, CE
image_format : STRING
It is recommended to use imageFormat in preference to this parameter. Platforms: Android, WM, CE

Returns

Synchronous Return:

Void

Platforms

Android
Windows Mobile
Windows CE

Method Access:

Instance Method: This method can be accessed via an instance object of this class:
- myObject.takePicture(HASH propertyMap)
Default Instance: This method can be accessed via the default instance object of this class.
- EB.Camera.takePicture(HASH propertyMap)

Properties

aimMode

Type

STRING

Description

Specifies the aim behaviour when taking a picture. Applicable only for imager module. This Property shall accept/return one among the values mentioned in constant section which starts with AIM_...

Access

Instance: This property can be accessed via an instance object of this class: myObject.aimMode
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.aimMode

Platforms

Windows Mobile
Windows CE

cameraType

Type

STRING Read Only

Description

Replaces:camera_type This property is device specific. The value for this property can be either 'back' or 'front' in the case of Android devices.In the case of windows it could be either 'imager' or 'color'. WM/CE devices will use 'color'as default and if color camera not available the default value will be 'imager'. Android devices will use 'back'as default and if back camera not available the default value will be 'front'. This Property shall return one among the values mentioned in constant section which starts with CAMERA_TYPE_...

Access

Instance: This property can be accessed via an instance object of this class: myObject.cameraType
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.cameraType

Platforms

Android
Windows Mobile
Windows CE

captureSound

Type

STRING

Description

Path to a sound file resident on the device which will be played when the image is captured.

Access

Instance: This property can be accessed via an instance object of this class: myObject.captureSound
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.captureSound

Platforms

Android
Windows Mobile
Windows CE

colorModel

Type

STRING

Description

Replaces:color_model Where supported by the hardware this property can be used to select whether to capture a color or a grayscale image. This Property shall accept/return one among the values mentioned in constant section which starts with COLOR_MODEL_...

Params

Default: rgb

Access

Instance: This property can be accessed via an instance object of this class: myObject.colorModel
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.colorModel

Platforms

Android

compressionFormat

Type

STRING

Description

Replaces:format The format of the captured image in subsequent calls to takePicture(). On WM/CE devices, only '.jpeg' or '.jpg' format is supported. This property will accept/return one among the values mentioned under constant section which starts with COMPRESSION_FORMAT_...

Params

Default: jpg

Access

Instance: This property can be accessed via an instance object of this class: myObject.compressionFormat
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.compressionFormat

Platforms

Android
Windows Mobile
Windows CE

desiredHeight

Type

INTEGER

Description

Replaces:desired_height Camera hardware is limited to taking photos in a finite number of resolutions, eg 2048x1536, 640x480 etc. Specifying a desiredHeight will request to take the photo with the specified height but if it is not supported by the hardware then the closest match will be selected. The callback received when a photo is taken contains the actual resolution of the captured photo.

Access

Instance: This property can be accessed via an instance object of this class: myObject.desiredHeight
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.desiredHeight

Platforms

Android
Windows Mobile
Windows CE

desiredWidth

Type

INTEGER

Description

Replaces:desired_width Camera hardware is limited to taking photos in a finite number of resolutions, eg 2048x1536, 640x480 etc. Specifying a desiredWidth will request to take the photo with the specified width but if it is not supported by the hardware then the closest match will be selected. The callback received when a photo is taken contains the actual resolution of the captured photo.

Access

Instance: This property can be accessed via an instance object of this class: myObject.desiredWidth
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.desiredWidth

Platforms

Android
Windows Mobile
Windows CE

fileName

Type

STRING

Description

The image file path without file extension to store captured image in subsequent calls to takePicture() or capture(). Default filename will be IMG_timestamp and will be saved under root directory. The filename extension will be added automatically according to compressionFormat property value.

Access

Instance: This property can be accessed via an instance object of this class: myObject.fileName
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.fileName

Platforms

Android
Windows Mobile
Windows CE

flashMode

Type

STRING

Description

Replaces:flash_mode Specifies the flash behavior when taking a picture. This Property shall accept/return one among the values mentioned in constant section which starts with FLASH_...

Access

Instance: This property can be accessed via an instance object of this class: myObject.flashMode
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.flashMode

Platforms

Android
Windows Mobile
Windows CE

maxHeight

Type

INTEGER Read Only

Description

The maximum height of images which can be captured. This is measured in pixels. On WM/CE devices this is applicable only for color camera. Imager does not support this property.

Access

Instance: This property can be accessed via an instance object of this class: myObject.maxHeight
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.maxHeight

Platforms

Android
Windows Mobile
Windows CE

maxWidth

Type

INTEGER Read Only

Description

The maximum width of images which can be captured. This is measured in pixels. On WM/CE devices this is applicable only for color camera. Imager does not support this property.

Access

Instance: This property can be accessed via an instance object of this class: myObject.maxWidth
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.maxWidth

Platforms

Android
Windows Mobile
Windows CE

outputFormat

Type

STRING

Description

Specifies the way to return the captured image to the application. This Property shall accept/return one among the values mentioned in constant section which starts with OUTPUT_FORMAT_...

Params

Default: imagePath

Access

Instance: This property can be accessed via an instance object of this class: myObject.outputFormat
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.outputFormat

Platforms

Android
Windows Mobile
Windows CE

previewHeight

Type

INTEGER

Description

In cases where the resident camera application on the device is not used this API is used to control the position of the viewfinder preview window when taking a photo.

Access

Instance: This property can be accessed via an instance object of this class: myObject.previewHeight
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.previewHeight

Platforms

Windows Mobile
Windows CE

previewLeft

Type

INTEGER

Description

Replaces:left In cases where the resident camera application on the device is not used this API is used to control the position of the viewfinder preview window when taking a photo.

Access

Instance: This property can be accessed via an instance object of this class: myObject.previewLeft
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.previewLeft

Platforms

Windows Mobile
Windows CE

previewTop

Type

INTEGER

Description

Replaces:top In cases where the resident camera application on the device is not used this API is used to control the position of the viewfinder preview window when taking a photo.

Access

Instance: This property can be accessed via an instance object of this class: myObject.previewTop
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.previewTop

Platforms

Windows Mobile
Windows CE

previewWidth

Type

INTEGER

Description

In cases where the resident camera application on the device is not used this API is used to control the position of the viewfinder preview window when taking a photo.

Access

Instance: This property can be accessed via an instance object of this class: myObject.previewWidth
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.previewWidth

Platforms

Windows Mobile
Windows CE

saveToDeviceGallery

Type

BOOLEAN

Description

Replaces:save_to_shared_gallery If true, the picture you take will be added to the device photo gallery.

Params

Default: false

Access

Instance: This property can be accessed via an instance object of this class: myObject.saveToDeviceGallery
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.saveToDeviceGallery

Platforms

Android

supportedSizeList

Type

ARRAY Read Only

Description

List of resolutions (width and height in pixels) supported by the camera. On WM/CE devices this feature is supported only by color camera and it is not supported by imager. Refer example section for more details.

Params

Object : HASH

width : INTEGER
height : INTEGER

Access

Instance: This property can be accessed via an instance object of this class: myObject.supportedSizeList
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.supportedSizeList

Platforms

Android
Windows Mobile
Windows CE

useSystemViewfinder

Type

BOOLEAN

Description

Setting the value of this property to "true", shall open the System ViewFinder with its properties. None of the Rho camera properties shall be applicable.

Params

Default: false

Access

Instance: This property can be accessed via an instance object of this class: myObject.useSystemViewfinder
Default Instance: This property can be accessed via the default instance object of this class.
- EB.Camera.useSystemViewfinder

Platforms

Android

Constants

CAMERA_TYPE_BACKBack camera. This is not supported in WM/CE devices.
CAMERA_TYPE_FRONTFront camera. This is not supported in WM/CE devices.
CAMERA_TYPE_IMAGERCamera is an imager. This is supported only in WM/CE devices.
CAMERA_TYPE_COLORCamera is color camera. This is supported only in WM/CE devices.
COMPRESSION_FORMAT_JPGJPG compression.
COMPRESSION_FORMAT_PNGPNG compression.
OUTPUT_FORMAT_IMAGEThis shall provide the image uri. This can be used to display image directly on the page. An example is shown in the example section
OUTPUT_FORMAT_DATAURIThis is a base 64 encoding of the image and can be used to easily embed the image on the page or store the image in a database.
OUTPUT_FORMAT_IMAGE_PATHIf this value used for setting the outputFormat property, the takePicture or capture API will return imageUri as the path to the saved image in the device. User can use this image path to transfer the file to an http server if required. An example is given to demonstrate, transferring a file to http server.This property is not applicable for Android and windows phone 8.
COLOR_MODEL_RGBA colour image is captured.
COLOR_MODEL_GRAYSCALEA grayscale image is captured.
FLASH_ONFlash will be used.
FLASH_OFFFlash will not be used.
FLASH_AUTOFlash will be used if lighting conditions deem it necessary. This is not supported in WM/CE devices.
FLASH_RED_EYEFlash with red eye reduction is used. This is supported only in Android devices.
FLASH_TORCHThe flash is turned on in torch mode. This is supported only in Android devices.
AIM_ONSwitches the imager's aim to ON
AIM_OFFSwitches the imager's aim to OFF

Remarks

SD Card Access

SD Card access is enabled by default; grants of additional access will be ignored. The following extensions are able to write to the SD card by default.

Camera Preview

Despite a user-selected full screen mode, preview rendering size will be overridden by the driver on some WM/CE devices.

DataUri

DataUri output is dependent on availability of virtual space. DataUri may fail, be unresponsive, cause reboot, degraded performance or fail to load in certain devices. In such cases, image path is recommended.

ImageUri

Image Uri display is dependent on browser capability.

colorModel as Grayscale in Android

Grayscale is not supported on Android devices.

Invalid/Null values for properties in Android and iOS

Only valid and non-empty values for properties are supported in Android and iOS.

Camera in Suspend mode

All WM and CE7 devices automatically turn off both color and imager cameras when the device is suspended. User must restart the camera to resume. Whereas CE5 (eg: MC9000) and CE6 (eg: MC31) devices retain the preview on resuming from suspend state.

Image saving after taking picture

In some devices, an image will be saved in landscape mode even if captured in portrait mode. This behavior is determined by the device's default settings.

WM/CE devices lacking support

Due to platform limitations, the ES400, MC65 and MC67 do not support the color camera.

takePicture resolution issue on low-memory devices with WM

Due to platform limitations, the ES400, MC65 and MC67 do not support a color camera. The imager on the MC55 with WM does not support the Fullscreen window (eg: takePicture). Parameters such as previewLeft, previewWidth, previewTop and previewHeight are supported by the device to set up a user-defined viewer window.

takePicture resolution issue on low-memory devices with WM

Processor limitations of some devices may cause a low-resolution image captures to appear as a small preview with a black background when transitioning back to the application.

Android KitKat gallery displays black image

For images captured with the camera using a Rho app, the image might initially appear black. Refresh the view to correct the problem.

Android preview

High-resolution settings are not recommended for low-memory devices. Image previews on tablet devices might appear stretched or shrunken.

Devices lacking support

The Camera API is not supported from Enterprise Browser apps on the following Zebra Technologies devices:

Workabout Pro 4
Omnii XT15
VH10

Examples

Take picture with default camera

Take an image with as little code as possible, using all default values.


function take_picture_with_default_camera() {
  // Capture an image from the default camera on the device, using the default image settings
  EB.Camera.takePicture({}, picture_taken_callback);
}

function picture_taken_callback(params) {
  // Did we receive an image?
  if (params["status"]=="ok") {
    // Assuming we have an  tag, we will be able to see the image that was just captured
    $("#captured_image").attr("src", EB.Application.expandDatabaseBlobFilePath(params["imageUri"]));
  }
}

Dispalying an image using image uri

This example demonstrate how user can dispaly an image using image uri. The callback will return an image uri when ‘image' is set as the outputFormat.


//enumerate the available cameras on the device
var camArray = EB.Camera.enumerate();

//below is the camera call back fired after takePicture is called
var camera_callbackFunc = function(cbData){ 

  //uri will have relative path info only
  //user has to form the absolute local server path as shown below
  uri = 'http://localhost:'+EB.System.localServerPort + cbData.imageUri;
  //set the image uri to the image element
  document.getElementById('imageUri').src = uri ;

};

//below is the test function which is used for capturing an image with outputFormat set as image
function Test_image_uri()
{ 
  //invoke takePicture API with outputFormat as image and set the callback method
  camArray[0].takePicture({'outputFormat': 'image'}, camera_callbackFunc);
}

Dispalying an image using data uri

This example demonstrate how user can dispaly an image using data uri. The callback will return a data uri when 'dataUri' is set as the outputFormat.


//enumerate the available cameras on the device
var camArray = EB.Camera.enumerate();

 //below is the camera call back fired after takePicture is called
var camera_callbackFunc = function(cbData){ 
  //set the image uri to the image element
  document.getElementById('imageUri').src = cbData.imageUri ;  
};

 //below is the test function which is used for capturing an image with outputFormat set as dataUri
function Test_image_uri()
{ 
  //invoke takePicture API with outputFormat as dataUri and set the callback method
  camArray[0].takePicture({'outputFormat': 'dataUri'}, camera_callbackFunc);
}

Choose which camera to use when taking images

On devices with more than one camera, you can select which camera to use for taking pictures.


<div id="camera_list">
</div>

var cameras = [];

function choose_camera() {
  // get all available cameras
  cameras = EB.Camera.enumerate();

  // build an HTML list
  var cameraList = "<ul>";

  for (var cameraIndex = 0 ; cameraIndex < cameras.length; cameraIndex++) {
    var camera = cameras[cameraIndex];
    // Create a link for each camera with an onclick handler
    cameraList = cameraList + '<li><a href="#" class="take_picture_with_selected_camera" onclick="take_picture_with_camera('+cameraIndex+')">' + camera.cameraType + '</a></li>';
  }

  cameraList = cameraList+"</ul>";

  // make camera list visible to the user
  $("#camera_list").html(cameraList);
}

function take_picture_with_camera(cameraIndex) {
  var camera = cameras[cameraIndex];
  camera.takePicture({}, picture_taken_callback);
}

Saving a picture to the device's gallery

Apart from taking new pictures, you can also save images to the built-in gallery. In the following examples, the picture we are adding to the gallery is one that was just taken with the camera, but you can add any other image you can access by filename.


function take_picture_and_save_it_to_gallery() {
  EB.Camera.choosePicture({}, picture_taken_callback_save_to_gallery);
}

function picture_taken_callback_save_to_gallery(params) {
  if (params["status"]=="ok") {
    EB.Camera.copyImageToDeviceGallery(EB.Application.expandDatabaseBlobFilePath(params["imageUri"]));

    alert("Image saved to gallery");
  }
}

Control image properties

You can tweak multiple options to get an image exactly as you need it.


function control_image_properties() {
  // Instead of accepting the defaults, let's set some properties to our liking

  // We will ask for a PNG file...
  EB.Camera.compressionFormat = "png";

  // ...a particular image size...
  EB.Camera.desiredWidth = 1024;
  EB.Camera.desiredHeight = 768;

  // ...and force the flash to be used
  EB.Camera.flashMode = "on";

  // Now, take the picture
  EB.Camera.takePicture({}, picture_taken_callback);
}

function picture_taken_callback(params) {
  // Did we receive an image?
  if (params["status"]=="ok") {
    // show it in our <img id="captured_image"< tag
    $("#captured_image").attr("src", EB.Application.expandDatabaseBlobFilePath(params["imageUri"]));
  }

}

Determine camera capabilities

You can get all available camera properties in a single call.


function determine_camera_capabilities() {
  var capabilitiesList = "<ul>";

  // Get all capabilities of the camera...
  var capabilities = EB.Camera.getAllProperties();

  // ... compose a nicely formatted list with their names and values ...
  for (var capability in capabilities) {
    capabilitiesList+="<li>"+capability+": "+capabilities[capability]+"</li>";
  }

  capabilitiesList += "</ul>";

  // ... and show it
  $("#camera_capabilities").html(capabilitiesList);
}

Select picture from device gallery

Apart from taking new pictures, the Camera API also lets you access existing images on the device’s gallery.


function select_picture_from_gallery() {
  EB.Camera.choose_picture({}, picture_taken_callback);
}

function picture_taken_callback(params) {
  // Did we receive an image?
  if (params["status"]=="ok") {
    // Show it in an <img> tag
    $("#captured_image").attr("src", EB.Application.expandDatabaseBlobFilePath(params["imageUri"]));
  }
}

Getting a camera instance by cameraType

Camera API also lets you access camera instance by cameraType.


//get the instance by cameraType and takePicture using that instance
function get_color_camera_instance() {
  var camInst = EB.Camera.getCameraByType('color');
  camInst.takePicture({'outputFormat':'image'}, my_callback);
}

Getting the list of resolutions supported by the camera

Camera resolution is hardware specific. Camera API supports getting the supported resolutions of a camera instance.


function getsupporteSizeList()
{
    var instArray = EB.Camera.enumerate();
    var reslnArray = instArray[0].supportedSizeList;
    alert(reslnArray[0].width);
    alert(reslnArray[0].height);
    alert(reslnArray[1].width);
    alert(reslnArray[1].height);
}

Transfering an image to HTTP server

This example demonstrate how user can transfer an image to http server. This will be useful when application is running on a remote server.


//enumerate the available cameras on the device
var camArray = EB.Camera.enumerate();

//below is the callback fired by network api after image upload to the server is completed
var upload_file_callback = function (args){
        status = args['status'];
        //a status ok indicates image transferred successfully
        alert(status);
       }

//below is the camera call back fired after takePicture is called
var camera_callbackFunc = function(cbData){ 
  alert(cbData.imageUri); 
  //set the upload file properties; Refer network module for more details
  var uploadfileProps = {
           url: 'http://10.233.82.51:8081/upload_image_file',
          //authType: "basic",
          //authUser: "admin",
          //authPassword: "password",
          filename: cbData.imageUri,
          body: "uploading file",
          fileContentType: "image/jpeg"
        };

   //below is the network module API used for uploading images when camera fire the callback
   EB.Network.uploadFile(uploadfileProps, upload_file_callback);      
 };

 //below is the test function which is used for capturing an image with outputFormat set as imagePath
function Test_image_transfer1()
{ 
  //invoke takePicture API with outputFormat as imagePath and set the callback method
  camArray[0].takePicture({'fileName' : '/Application/Test/myImagename', 'outputFormat': 'imagePath'}, camera_callbackFunc);
}
 //below is the test function which is used for choosing a picture from device with outputFormat set as imagePath
function Test_image_transfer2()
{ 
  //invoke choosePicture API with outputFormat as imagePath and set the callback method
  EB.Camera.choosePicture({'outputFormat': 'image'}, camera_callbackFunc);
}