axMobileCamera

Description

axMobileCamera allows a mobile device's camera to set the image to be displayed on the 5250 screen.

Usability

Context

Supported

Input screen fields

No

Output screen fields

Yes

Input subfile fields

No

Output subfile fields

No

New screen elements

Yes

Axes Mobile Execution

Only

Properties

Name

Description and Comments

JavaScript

Shipped default

allowsEditing

Indicates whether the editing function of the camera will be enabled. The editing features are device specific.

Yes. Must return a Boolean.

True

caption

Specifies the text that is to appear on the image. The text will be displayed depending on the device.

Yes. Must return a string.

Mobile Camera

enableAnnotation

Indicates whether taking a photo from the existing gallery and functionality to do annotation is enabled. When set to false, only taking photo using the camera will be enabled.

Yes. Must return a Boolean.

True

enabled

Indicates whether this element is enabled.

TS2 only.

Yes. Must return a Boolean.

True

imagePath

Path to save the image file

Yes. Must return a string.

/media

imageName

Name of the image file

Yes. Must return a string.

None

onClick

Javascript code to be executed when the user clicks on this eXtension or on some specific part of this eXtension.

Yes

None

onMouseOut

Javascript code to be executed when the mouse point moves out of this eXtension.

Yes

None

onMouseOver

Javascript code to be executed when the mouse pointer hovers on this eXtension.

Yes

None

saveToPhotoGallery

Indicates whether any photo chosen or taken using the camera will be saved to the device’s gallery or not.

Yes. Must return a Boolean.

False

sizeToField

Indicates whether the image should be sized to fill its containing field or automatically sized to match its content.

Yes. Must return a Boolean.

True

style

Additional style properties that should be applied to the button.

Yes. Must return a valid style object.

None

Notes, Comments and Warnings

Some of the functionality of this extension is dependent on the device (for example allowsEditing and caption) just like the operation and screens. So these functions vary from device to device.

The extension display is very similar to the axImage component with added functionality similar to the axPushButton. Touching/Clicking the image will automatically launch the Camera application of the device.

When saveToPhotoGallery is true and enableAnnotation is true, even choosing an existing photo from the Gallery will automatically save another copy of that photo in the Gallery.

When enableAnnotation is set to false, it will not be possible to choose an existing photo from the Gallery when the camera application is launched. Only taking pictures using the camera will be allowed.

The imagePath is a local folder on the device in which the imageName will be saved. When an image is taken or selected using the axMobileCamera extension, the image will be saved locally to the imagePath + “/” + imageName location. Therefore, when viewing it on the PC, any saved images will not be viewable. Note that the imagePath should not contain any trailing slash (“/”) characters.

The function to capture video is not currently available.

In Application, appStylesTheme property = JQueryUI

When JQueryUI is selected from Application->Styling->appStylesTheme property, a border will appear around the image when the mouse is hovered over it. The style of the border will be based on the theme that was set in the Application’s jqueryTheme property.

The following shows the aXes logo image when the mouse is hovered over it:

Image

In Application, appStylesTheme property = Material Design

When Material Design is selected from Application->Styling->appStylesTheme property, an overlay will appear on the image when the mouse is hovered over it.

The following shows the image when the mouse is hovered over it:

Image

Examples

Just like the axImage extension, the location of the image to be displayed can be set using the imagePath and imageName properties.

Image

Using the final output screen of the eXtensions Tutorial 3 – Advanced Screen Enhancement, in Developer mode, set the name of the employee ID field to EmpID.

Image

Replace the axImage extension with the axMobileCamera extension.

Image

Set the imageName property with this code:

FIELDS("EmpID").getValue() + ".jpg";

Access the definition set you used above using aXes Mobile and tap on the axMobileCamera image.

Choose or take a photo and use it. The photo will be displayed inside the axMobileCamera extension.

Log out and view the screen again. The photo you have set will still be displayed inside the axMobileCamera extension.

See Also

Tutorial 3 - Advanced Screen Enhancement

Administrators

Legal Mentions

aXes is brought to you by:

LANSA

Serving the IBM i community for 30 years.