Mobile SDK: Atalasoft MobileImage Release Notes 3.0.0

June 22, 2016 Atalasoft General

Please read these notes carefully because they contain information that is not included in the SDK documentation.

Version Information

The SDK version can be found by looking in the versions.txt file included in the delivered product.

Resolved Issues

This section contains information about issues that have been resolved as of this version of the product.

Captured image was Overexposed on Asus Zenfone

When autotorch was on, and an image was captured under low light conditions, the resulting image may have been unevenly over exposed to the extent that half the image is completely white. (691353)

Affected platforms and/or known devices:

  • Android
  • Asus Zenfone x86

Application Crashed Due to OutOfMemoryError

When retaking a picture, the Kony sample app crashed with a java.lang.OutOfMemoryError on the first, and subsequent, retakes. Note that the S2 device did not support Kony. (672677)

Affected platforms and/or known devices:

  • Android
  • Kony
  • S2

Android Packaged Capture Extraction Never Timed Out

If you used an invalid URL in the package capture workflow activities it could have caused extraction to hang. (672632)

Affected platforms and/or known devices:

  • Android

Error When Building KTA Connect From the Build Folder

When building the KTA Connect app from the build folder, the application may have failed to run while reporting: "Unable to open PNG file". (672074)

Affected platforms and/or known devices:

  • Android

Some Images Underexposed

Some images may have been underexposed when using certain devices. (665002)

Affected platforms and/or known devices:

  • Android 6
  • PhoneGap and Kofax Mobile Demo application
  • Nexus 5

Captured Image Not Displayed

When using HTML 5, The captured image was not retrieved, and consequently not displayed, when the native camera option was used. Despite this, the take picture success callback was called. (645168)

Affected platforms and/or known devices:

  • HTML5
  • iOS8.0, iOS8.3
  • Safari

Document Capture Experience Crashed With Languages Other Than English

There may have been a crash in the Document Capture Experience when the device was set to languages other than English. This was only seen with the DocumentCaptureExperience and with those Packaged Capture Experience work flows that used it. (641967)

Affected platforms and/or known devices:

  • Android
  • Document Capture Experience

Moto X Did Not Support Auto Torch

On the Moto X, the LED was always on when the flash mode was set to Auto Torch. Auto Torch worked correctly on other supported Android devices. (636440)

Affected platforms and/or known devices:

  • Android
  • Moto X

Out of Memory When Using Bar Code Reader

There was a random out of memory error that caused the device to crash when using the bar code reader to search for Datamatrix bar codes when there were none. If the bar code reader found a Datamatrix code, this error did not occur. This had not been seen in devices other than the Galaxy S4 with Android version 4.3. Newer versions of Android on this device had not been tested. (612749)

Affected platforms and/or known devices:

  • Android 4.3
  • Samsung Galaxy S4

Message Not Clipped Correctly in Portrait Mode

In some devices, the instruction message was not the clipped correctly when the device screen was in portrait mode. This did not happen when the phone was rotated so that the screen was in portrait mode. (611787)

Note This issue was dependent on the text size and device screen size. The message boundaries were correct if the text size is small. The message boundaries were correct in landscape mode, but not in portrait mode if the text size wasmedium. The message boundaries were incorrect in both landscape and portrait mode if the text size was large.
The text size was in relation to the screen size, so, for example, size 20 text was considered large on a mobile device but small on a tablet.

Affected platforms and/or known devices:

  • Android

EAN Bar Code Returns Wrong Value

When reading EAN bar codes from right to left, the wrong value was returned. (611783)

Affected platforms and/or known devices:

  • Android

Angle Guidance Always OK for Backs of Checks

Regardless of the maxSkewAngle setting, even when very low (for example zero or some other very small number), the turn guidance always said OK. When set to such low levels, some guidance other than OK was expected. (607371 )

Note The maxSkewAngle setting worked as expected for the fronts of checks.

Affected platforms and/or known devices:

  • Android
  • iOS

Unable to Capture Image in Video Mode

Unable to take a picture in video mode if either the doContinuousMode or takePicture method was used. This was a device specific problem. (593874)

Affected platforms and/or known devices:

  • Moto G

BarcodeReader Direction Map Incorrect

The kfxKBRBarcodeReader searchDirection property did not work. This property specified that multiple directions could be combined. However, top_down and right_left were reversed. (593056)

Affected platforms and/or known devices:

  • Android

BarcodeReader Direction Map Incorrect

The kfxKBRBarcodeReader searchDirection property did not work. This property specifies that multiple directions can be combined. However, top_down and right_left were reversed and, for iOS only, combining two or three bar codes together resulted in a read error. (592986)

Affected platforms and/or known devices:

  • iOS

setTargetFramePaddingPercent After Instantiation Didn't Update the UI

If a CheckCaptureExperience eas created (captureExperience = new CheckCaptureExperience(baseCapView, capCriteria), and then the padding percent was changed (capCriteria.getCheckDetectionSettings().setTargetFramePaddingPercent(25);), the settings were applied to the actual CheckDetector. However, the UI was not updated. The frame still appeared to have the original padding. As a result, the check detection algorithm became out of sync with the UI. (590819)

This only happened when updating/setting your CheckDetectionSettings after you instantiated your CheckCaptureExperience. If the padding percent was changed before the CheckCaptureExperience was instantiated, the UI was updated.

This happened when using CheckCaptureExperienceCriteriaHolder.

Affected platforms and/or devices:

  • Android
  • CheckCaptureExperience

Overlapping Messages in AnimatedDocumentCaptureExperience

In the Android AnimatedDocumentCaptureExperience two message objects may have been displayed at the same time. For example, the UserInstructionMessage and the HoldSteadyMessage, or the UserInstructionMessage and the PageOrientationMessage. (583320)

Only one message object at a time should have been displayed. If an additional guidance message popped up, the preceding one should have disappeared.

Affected platforms and/or devices:

  • Android

Different Bar Code Results for Same Image Saved as .jpg or .png

BarcodeReader should have yielded the same results from an image, regardless of the file type used to save the image. However, .png and .jpg versions of the identical image may have yielded different results. (571421)

Affected platforms and/or devices:

  • iOS

NullPointerException After Trying to Write an Image of the Same Mimetype

Twice

In PhoneGap, when processing the same image as the same mimetype twice, the following error was generated: Error! failed to set image - NullPointerException - Image is not a Bitmap. (566909)

Affected platforms and/or devices:

  • Android
  • PhoneGap

Page Detection Events Received Even if Camera is Set to PageDetect.Off

In PhoneGap, when the page detect value was "off", the app should not have received page detect events, and should have been able to capture even when a page was not detected. However, when the page detect value was set to "off", page detect events were received as though the page detect mode had been set to continuous. (566250)

Affected platforms and/or devices:

  • Android
  • PhoneGap

Page Detection Events Received With PageDetect.Off

In PhoneGap, when the page detect value was set to "off", the app should not have received page detect events, and should have been able to capture even when a page was not detected. However, when the page detect value was set to "off", receive page detect events were received as though the page detect mode was set to continuous. (565961)

Affected platforms and/or devices:

  • iOS

setPageDetectionEnabled(false) Did Not Behave Correctly

Setting setPageDetectionEnabled(false) should have made the AnimatedDocumentCaptureExperience ignore all capture constraints related to page detection. In other words, an image should have still been captured even if the flowing criteria were set, but never met: "page area", "page long edge threshold", "page short edge threshold", and "detect page orientation". Instead, an image was never captured, and the "Move Closer" message was always shown. (565653)

Affected platforms and/or devices:

  • Android

_DoRecognizeTextMICR_ Affected Page Detection During Processing

_DoRecognizeTextMICR_ was originally used as a check of the MICR and had no effect on image processing. This was changed in 2.3, which introduced unintended behaviors. For example, in some cases the first characters of the found MICR line were missing. (565539)

Affected platforms and/or devices:

  • All

ImageCaptureView Returned Incorrect onCameraInitialized Events

The application received onCameraInitialized events with the status of CAMERA_USE_VIDEO_FRAME_CHANGED, even though setUseVideo() was not called. It may also have received onCameraInitialized events with the status of CAMERA_IMAGE_RESOLUTION_CHANGED, even though setImageResolution() was not called. This happened if the application started an Intent on top of an Activity and then returned to the original Activity. Although the View was not recreated and the instance of ImageCaptureView has not changed, the application always received either CAMERA_USE_VIDEO_FRAME_CHANGED or CAMERA_IMAGE_RESOLUTION_CHANGED - never both, and never CAMERA_VIEW_CREATED. (564537)

Affected platforms and/or devices:

  • Android

AppStats Image Table Logs Had Incorrect Image Filesize for Bitmaps

If the image processor was set to provide an IMAGE_REP_BITMAP or IMAGE_REP_BOTH, AppStats recorded the number of pixels in the bitmap for the fileSize column of the ImageProcessorEvent table. (562475)

AppStats also has an Image table with a fileSize column. Here, if the image was represented by a bitmap, the fileSize will be 0. These two tables should be consistent. The Image table in AppStats should log the fileSize as the number of pixels in the bitmap for those images that are represented by a bitmap.

Affected platforms and/or devices:

  • Android

Failed to Read Bar Code After Dismissing ReadBarcode Alert

In PhoneGap, while reading a bar code, if the "Read Barcode" button was tapped, an alert was displayed (BarcodeCaptureControl.addEventList error! Action already in progress). After dismissing this, the bar code could not be read. (562375)

Affected platforms and/or devices:

  • Android
  • PhoneGap

Capture View Displayed in Video Mode Even After Switching to Camera

Mode

In PhoneGap, the Capture view was still displayed in Video mode even after switching from Video mode to Camera mode. (562364)

Affected platforms and/or devices:

  • Android

Failed to Process Image with IMAGE_REP_FILE

The image was not processed when ProcessedImageRepresent was set to IMAGE_REP_FILE. An image processing error ("The input image object has no active representation for file, Bitmap or both...") was displayed when processing an image when the image representation is set to file. (562335)

Affected platforms and/or devices:

  • iOS

Flash Mode ON Did Not Work

In PhoneGap, setting the Flash Mode to ON was not functional (there was no flash even after the mode was changed in Settings). (562331)

Affected platforms and/or devices:

  • Android

Unable to Capture Bar Code Second Time After Launch

In the PhoneGap sample application, after capturing a bar code the first time, if the user pressed the back button and then tried to capture the bar code again, the application was not able to capture it the second time. (562319)

Affected platforms and/or devices:

  • Android

setGPSUsageLimits = neverUse Only Worked if Location Permissions are Removed

In the SDK, there was a method that allowed the user to set the GPS usage for the image capture control off: com.kofax.kmc.kui.uicontrols.ImageCaptureView.setGpsUsage(GpsUsageLimits limits). The neverUse functionality only worked if <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> was taken out of the manifest. (561943)

Affected platforms and/or devices:

  • Android

Relative Area Ratio Must Be Approximately 20 or Higher

When the Android relative area ratio functions (setPageAreaForDetection or setPageAreaThreshold) were set to a low value, such as 5, the application should have fired off a page detection event and/or capture when the page occupies at least 5 percent of the view. However, this did not happen. If these values were higher than 20, the pageDetected event \ fired and the image was captured as expected. (561722)

Affected platforms and/or devices:

  • Android

User Instructions Centered Despite Different x and y Coordinates

When using the Android AnimatedDocumentCaptureExperience, you can construct a variety of messages and user instructions. When using the UserInstructionMessage, the text was always set in the exact center of the screen, regardless of the specified x and y coordinates. (560849)

Affected platforms and/or devices:

  • Android

Default Messages Rotated Incorrectly

When using the Check Capture experience or the Animated Capture Experience, the default capture message was initially rotated correctly when the phone is held in the original orientation and 90 degrees to the left. But when the phone was rotated 90 degrees to the right, the message was displayed upside down. (559370)

Affected platforms and/or devices:

  • iOS

GPS Settings Not Recorded on iOS 8

If you enabled Location Services, in order to capture GPS information in the image header, the following needed to be added to your application's info.plist beginning with iOS 8: (557861)

  • One of these keys:

NSLocationWhenInUseUsageDescription or NSLocationAlwaysUsageDescription

  • For the associated key value, include a message string that the user will see when the permission popup appears.

Affected platforms and/or devices:

  • iOS 8

Could Not Upgrade Database from 2.1 into the Schema for 2.2

In AppStats, an error ( KMC_UT_CREATE_DB_FAILED) was generated when attempting to upgrade the AppStats database from SDK version 2.1 into the 2.2 schema. (378258)

This only happened if the SQL Database had exported/written the AppStats data via:

(int)writeToFile

or:

(int) export: (NSString *) exportFilePath
withFormat: (KUTappStatsExportFormat)exportFormat

Affected platforms and/or devices:

  • iOS

Writing AppStats Data to File May Have Caused Issues

To avoid possible synchronization issues, it was necessary to turn AppStats off before writing the data to a file. (376049)

Affected platforms and/or devices:

  • Android

MICR/Signature Not Detected on Clear Image

When a clear image was captured, the MICR or the signature may not have been be detected and error was thrown. This was a random issue. (360700)

Affected platforms and/or devices:

  • iOS
  • Android

Flash Fired Continuously on Some Devices

After abruptly switching from a dark to light environment (such as picking the tablet up from a table), the flash fired repeatedly, resulting in a washed out image. This happened when the flash was set to "Auto". (345226)

If the user moved the device, the flash would pause. As soon as the device was stable again, the flash resumed firing, which made it almost impossible to take a properly exposed image.

Affected platforms and/or devices:

  • Android
  • Samsung S4
  • Samsung S3

S: Unfocused Images Captured Despite the Camera Reporting Focused

It was possible to capture an out of focus image with the Image Capture Control even though the camera reported that the lens was focused. This normally happened when page detect was set to automatic or continuous and when all the stability/levelness settings were satisfied, but the camera physically could not focus because the lens was too close to the document. Despite this, eventually the camera incorrectly reported that it was focused. If the user then gently moved the device far enough away from the document for it to normally be able to focus, the resulting image was still out of focus. In order for this to happen, the device must have been moved gently enough that the settings were continuously satisfied. If the settings were exceeded, even if just for an instant, the camera refocused at the new distance. (343400)

Affected platforms and/or devices:

  • iOS

Some Devices Captured Full Size Images in Video Mode

On some devices, using takePicture while in video mode resulted in capturing a full size image. (324939)

Affected platforms and/or devices:

  • Android

The following devices were known to exhibit this behavior. There may be others.

  • HTC One
  • LG G Pad 8.3
  • Nexus 10
  • Samsung Mega
  • Samsung S3

Nexus 10: Flash Did Not Work in Capture Mode

On the Nexus 10, when in capture mode with the flash setting on, the flash did not fire. (324897)

Affected platforms and/or devices:

  • Android
  • Nexus 10

Could Not Use Flash on Certain Samsung Devices

During image capture with the flash enabled, the level indicator froze and the image capture view was sluggish. (324740)

Affected platforms and/or devices:

  • Android
  • Samsung 12.2
  • Samsung Note 10.1

returnCameraEvents Method

The SDK contains a returnCameraEvents method that must be set to True in order for an app to take advantage of page detect, levelness and stability threshold events. If this value was left at the default or set to False, these threshold events are not returned. iOS was missing this method. (324720)

Affected platforms and/or devices:

  • Android
  • iOS

Tilt Not Required in Image Capture Control

On Android devices, while in continuous capture mode, before recapturing an image, the user should have been required to tilt the device away from level to reset the levelness and stability thresholds. This was not happening, resulting in a continuous stream of images. (324703)

Affected platforms and/or devices:

  • Android

Cannot Capture Back Side of Check

When using a LenovoYoga, an app may not have been able to capture the backside of certain checks. The issue occurred when a check did not have enough data on it for the LenovoYoga camera to focus successfully. (324517)

Affected platforms and/or devices:

  • Android
  • LenovoYoga

Quick Analysis Did Not Consistently Indicate Blurred Images

When requesting a quick analysis with the image processor API, the app may or may not have requested a reference image. When requesting a quick analysis without an image, the "blurry" setting was missed, and consequently the Quick Analysis Results object was not correctly set up. (323424)

Affected platforms and/or devices:

  • iOS

In Video Mode, LED Inconsistent Across Devices

During Capture with Video Mode On and Flash On, there was inconsistent flash lamp behavior across devices. For some devices the lamp was on and for other devices, the lamp was off. (322722)

Affected platforms and/or devices:

  • Android

Android Applications Crash With Invalid License

Attempting to run an Android application without a valid license caused the app to crash. (322330)

Affected platforms and/or devices:

  • Android

Android: Level Indicator Switched Phases Rapidly

On the Motorola Moto G, the level indicator rapidly switched between states. (322233,564550)

Affected platforms and/or devices:

  • Android
  • Moto G

Race Condition Caused iPhones to Crash

A race condition occurred during bar code capture when removing the bar code control from view. This most frequently caused the iPhone 4 with iOS 7.1 to crash. However, in rare instances, this may have also been seen on newer iPhones and older versions of iOS. (316394)

Affected platforms and/or devices:

  • iPhone
  • iOS

Asus Transformer Camera Feed Not Centered

Asus Transformer tablets (where landscape mode is the natural orientation) exhibited a problem where the camera view appeared off center in the tablet screen. (306608)

Affected platforms and/or devices:

  • Android
  • Asus Transformer

Motorola MotoX Sensor Handling

There is a hardware compatibility issue for level detection when using the SKD ImageCaptureView class with the Motorola Moto X. When creating an App for this device, use the setMotionSensorType API method to bypass this compatibility issue. (293678)

Usage example:

((ImageCaptureView) preview).setMotionSensorType(MotionSensorType.RAW); // to force use raw sensors (accelerometer and magnetic sensors) for motion detect.

Note This API method is only supported for this device, do not use with other devices.

Affected platforms and/or devices:

  • Android
  • Motorola Moto X

MICR Data Extracted From Image With No MICR Line

MICR data was returned in metadata when processing an image without a MICR line. (283904)

Affected platforms and/or devices:

  • Android
  • BankRight

Multiple Deprecation Errors While Compiling for iPad2

Developers were likely to see numerous deprecation errors when using XCode to compile the application for iPad2. (00115355)

Affected platforms and/or devices:

  • iOS Sample Apps

Some Android Models May Have Had Imaging Issues

In some cases, pictures taken with some Android phone models may have had poor resolution. (00112259, SPR00115464)

Affected platforms and/or devices:

  • Android

Known Issues

This section contains information about potential problems that you could encounter while using the SDK. Workarounds are provided as applicable.

On Android Kofax Mobile Demo, Kofax Analytics for Mobile Is Currently Not Supported

In Kofax Mobile Demo the app stats reporting/session lifecycle needed to support Kofax Analytics for Mobile 1.0 statistics is not supported. (721141)

Affected platforms and/or known devices:

  • Android

Workaround: However, this works with Kofax Mobile Demo on iOS platforms.

Loader Runs Continuously After Selecting an Image

After selecting an image from the gallery, the loader continuously runs on the screen. (718000)

Affected platforms and/or known devices:

  • Android 4.3 or below
  • Samsung S3
  • Sony Xperia Tab Z

Workaround: Upgrade Android to a version greater than 4.3.

Extraction Not Working on Samsung S3

Extraction not working Samsung S3 when using Phone Gap. (717395)

Affected platforms and/or known devices:

  • Android 4.3 or les
  • Samsung S3
  • Sony Xperia Tab Z

Workaround: Upgrade Android to a version greater than 4.3.

Attachment is Empty in Email Draft

The attachment appears empty when the sending an email using Image Representation - > IMAGE_REP_FILE/BOTH & Mode: BW/color/gray & with Scale(dpi)=400/300/200/no . (717384)

Affected platforms and/or known devices:

  • iOS 9.3.2
  • iPadPro

Workaround: None.

ODE Bar Code Extractor Returns No Error or Data

The ODE kfxKOEIDExtractor returns no error and no data for some bar code images. (712709)

  • iOS

Workaround: None.

ODE Returns XX When the Date Has No Day Value

If there is no date, then On Device Extraction will return YYYY-MM-XX: it will return XX for the day. (712533)

Affected platforms and/or known devices:

  • iOS
  • Android

Workaround: None.

setRequestTimeout Defaults to 8

When the server is unavailable, the connection timeout could fire earlier than the value specified with setRequestTimeout (or the default value, which is 10 sec). (710107)

More information is available at:

  • https://devforums.apple.com/thread/25282?start=0&tstart=0
  • http://stackoverflow.com/questions/34991795/nsurlsession-setting-request-time-out-75-seconds-serverunreachable

Affected platforms and/or known devices:

  • iOS (all versions and devices)

Workaround: None.

ODE Will Not Refill Licenses if Count Reaches Zero

On-Device Extraction will fail with an “out of license error” when the remaining license count on device reaches zero, even if the volume license server connection is available. (707822, 707823)

Affected platforms and/or known devices:

  • Android
  • iOS

Workaround: Explicitly request additional licenses.

Difficult to Capture Credit Card Due to Focus Issue

When using the credit card component in the Kony application with the Sony Xperia Tablet Z, the device has difficulty focusing on the card. (705630)

Affected platforms and/or known devices:

  • Android
  • Sony Xperia Tablet Z

Workaround: Try to capure the image again in a location with more light.

Improper Crop on US DL Back Images

HTML5 processing of the back of IDs is supported, however, on occasion, cropping will not be exact. This will not affect barcode extraction. (698185)

Affected platforms and/or known devices:

  • HTML5

Workaround: None.

Vibrate Function Causes Blurred Pictures

The vibrate function sometimes causes pictures to turn out blurry. The default settings cause the phone vibrate when a picture is being taken. Sometimes this shakes the camera as it captures the image, leading to blur. Testing with the HTC One A9 showed more blur than with the Moto X. (692792)

Affected platforms and/or known devices:

  • Android
  • HTC One A9
  • Moto X
  • Possible others

Workaround: If possible, disable the default vibration.

Camera Cannot be Configured For Any HD Resolution

We have seen cases where Nexus 6 devices, with Android OS version 6.0 and Chrome browser version 48.0.02564.95, are unable to render the HTML5 camera, and "Camera cannot be configured for any HD resolution" is displayed as an alert. (690304)

Affected platforms and/or known devices:

  • Android 6.0
  • Nexus 6

Workaround: In these cases, we advise upgrading your browser version.

Mobile ID Images Not Properly Cropped

Some ID images are not cropped properly. Such images tend to be low contrast images, or images on backgrounds with noticeable noise. (689797):

Affected platforms and/or known devices:

  • HTML

Workaround: Ensure that images have good contrast and low noise.

Not able to see preview of captured image

When using certain unsupported versions of Safari , image previews will not be displayed (689019).

The supported browsers for iPhone and iPad which can load the captured image (either from the gallery or the native camera) into the image blob are Safari 7.1, 8.4, 9.0.

Safari 8.1.x has a limitation where the captured image size should be less than 1MB. On Safari 8.1.x, if the captured image size is more than 1MB, it will not work for some devices such as iPhone4s (OS:8.1.2) and iPadAir2(OS 8.1). In such cases, the user will not be able to see a preview of the captured image.

Affected platforms and/or known devices:

  • iOS 8.1
  • Safari 8.1.x

Workaround: None.

In Some Cases, EVRS Can't Read TIFF Files

EVRS can't read TIFF files if the ImageLength tag does not immediately follow the ImageWidth tag. (685481)

Certain devices may create TIFF files with the ImageWidth and ImageLength tags in the correct order but some other tag (for example, the BitsPerSample tag) inserted between them. In such cases EVRS returns an error.

Affected platforms and/or known devices:

  • EVRS

Workaround: None.

KTA Connect Mobile Capture Won't Load

KTA 7.2.2 does not refer to the correct location for the Cordova 5.4 javascript files, consequently KTA Connect Mobile Capture won't load. (680069)

KTA does not include the latest Cordova 5.4 javascript files, so the SDK project includes the required files along with instructions to copy the files to the correct location. However, the latest version of KTA 7.2.2 looks in the wrong location for the 5.4 Cordova files. As a result, the KTA Connect app will fail to load the Mobile Capture control.

Affected platforms and/or known devices:

  • SDK

Workaround: The steps in the Kofax Mobile SDK Developer's Guide instruct the administrator to copy the files to the "5.4" folder. This will work correctly for KTA 7.2.0.1, but once the software is updated to KTA 7.2.2, this will break. The easiest workaround is to make a second copy of the "5.4" folder and rename it "5_4".

White Image When the fFlash is On

When using the flash on the TC70 you may get a very bright and white image when the flash is on. (676057)

Affected platforms and/or known devices:

  • Android
  • TC70

Workaround: None.

Demo Crashes When Gallery Icon is Tapped

If the Gallery app is disabled in device settings, the Kofax Mobile Demo application will crash if the user taps the icon in the camera view that opens the gallery. (673877)

Affected platforms and/or known devices:

  • Android 6
  • Nexus 5

Workaround: None.

Upon First Launch Display of Capture Guide is Too Short

One the S2 device, in the Kony sample application, the capture guide in the uniform guidance or check capture experience is displayed only for a brief moment when launching the camera for the first time. Note that the S2 device does not support Kony. (672683)

Affected platforms and/or known devices:

  • Android
  • Kony
  • S2

Workaround: None.

Samsung S4 Slow to Return ID Extraction Results

The Samsung S4 takes significantly longer than other devices to do on-device extraction. (672075)

Affected platforms and/or known devices:

  • Samsung S4

Workaround: None.

Kony App Crashes Upon Launching Camera in Android 6

The Android Kony sample app crashes when the camera launch on Android 6 devices. At the moment, Kony does not support API 23. (671960)

Affected platforms and/or known devices:

  • Android 6
  • Nexus 5
  • Nexus 6

Workaround: None.

Distorted Thumbnails in HTML5 Sample App

When using the HTML 5 sample application, thumbnails of captured documents appear normal upon initial viewing, but may become distorted on subsequent viewings. (670606)

Affected platforms and/or known devices:

  • iOS 8.1

Workaround: None.

Frequent Reloaded Alerts While Using HTML5 Sample App

When using the HTML 5 sample application, the application frequently has to reload the current page. The issue occurs in Safari when the app captures a photo via the <input> tag. (668228)

Affected platforms and/or known devices:

  • iOS 8.1. to 8.3
  • Safari Browser

Workaround: Clear the device cache and try again.

Cannot Capture Image with HTML 5

When using HTML 5 on the S4 Mini, the mobile device is not able to capture via the native camera when using Chrome version 46. (663283)

Affected platforms and/or known devices:

  • Android
  • HTML5
  • Samsung Galaxy S4 Mini

Workaround: None.

Talk Back Doesn't Work in Credit Card Viewfinder Screen

In the KMD application, the Credit Card viewfinder screen, the "Hold card here" prompt is not vocalized. This is a third party bug. (654589)

Affected platforms and/or known devices:

  • Android

Workaround: None.

Extractor Results Depend on iOS/iPhone Version

Because of minor differences in the handling of color spaces by iOS, ID extraction results depend on the version of iOS and or the iPhone. The iOS UIImage library appears to switch to sRGB (instead of full RGB) depending on the device's screen characteristics, which may result in a slightly narrower color spectrum. This has a bigger impact on accuracy 32bit iOS devices. (652493)

Affected platforms and/or known devices:

  • iOS (on 32 bit devices)

Workaround: None.

View Finder Turns Black

In the HTML5 sample application, the view finder may display a black screen after completing a single end to end transaction (from capture to submit). (651234)

Affected platforms and/or known devices:

  • HTML5
  • iOS 8.1.2
  • iPhone 4S

Workaround: Even though the view screen is black you can still capture an image by pressing the force capture button, and then tapping Retake.

Browser Not Responding If Native Camera is Disabled

In HTML5 capture, if the user attempts to capture a document when camera access is disabled, clicking "Allow", the browser becomes unresponsive and may crash without displaying an error. (648726)

Affected platforms and/or known devices:

  • HTML5
  • Android 6.0.1
  • Nexus 6

Workaround: None

BarcodeCaptureView

The behavior for this method has changed when capturing multiple bar codes. Now, readBarcode() has to be called again in order to read additional bar codes. See the API reference guide for details. (635412)

Affected platforms and/or known devices:

  • Android

Workaround: None.

Bar Code Extraction Not Working

In the Packaged Capture Experience, when trying to capture a bar code, if you try to do the extraction without also sending the front-side ID image (other than setting the side to BACK), you may receive null extraction results. (633864)

Affected platforms and/or known devices:

  • iOS
  • Packaged Capture API

Workaround: None.

Bar Code Extraction Not Working

In the Packaged Capture Experience, when trying to capture a bar code, if you try to do the extraction without also sending the front-side ID image (other than setting the side to BACK), you may receive null extraction results. (632983)

Affected platforms and/or known devices:

  • Android
  • Packaged Capture API

Workaround: None.

Memory Warnings in Log

When using the Document Capture Experience on an affected device, the user may experience memory issues. (631716)

Affected platforms and/or known devices:

  • iOS
  • iPhone 4s

Workaround: None.

Kony Sample App Stops Working if Email Not Configured

When email is not configured on an iOS device, there is no alert if the user taps the email button. Instead, after tapping the email button, the app stops responding. (630570)

Affected platforms and/or known devices:

  • iOS

Workaround: None.

Fatal Signal 11 on Capture and Retake

On Capture and Retake(Uniform Guidance), the application crashes with Fatal Signal 11 . (628132)

Affected platforms and/or known devices:

  • Android
  • Samsung SIII Mini

Workaround: Develop with different device if you run into this issue.

Galaxy S3 mini Has Trouble Capturing Check Backs

The Samsung Galaxy S3 mini may have trouble capturing check backs in certain situations in video mode, such as with a light check back on a white board, or when there is significant glare. This happens because the highest supported resolution for this device is 1280x720.The problems do not occur in image mode. (626921)

Affected platforms and/or known devices:

  • Android
  • Samsung Galaxy mini

Workaround: Use image mode with this device.

Cannot Use Custom Component with TotalAgility

In this release Kofax Mobile Demo does not support the custom component with TotalAgility integration. (619699)

Affected platforms and/or known devices:

  • Android
  • iOS
  • Kofax Mobile Demo

Workaround: None.

Visibility Setting for Instruction Message Ignored

After setting the user instruction message (fill viewable area), to invisible, the message will still show up. (614559)

Affected platforms and/or known devices:

  • Android

Workaround: To make the user instruction message effectively invisible, set the message property to an empty string.

Page Detect Thresholds Now Based Off Static Frame

The page detect thresholds are now being calculated off the static frame. In past releases, they were based off of the entire capture view. This change does not apply to iOS, which still bases the calculation on the entire capture view. (614546)

Affected platforms and/or known devices:

  • Android

Workaround: None.

Tap to Focus is Not Supported

Tap to focus is not supported on the Samsung S5 because the device uses continuous video mode. Attempting to use "tap to focus" will stop focusing and cause it to be reset every 2 seconds. (613606)

Affected platforms and/or known devices:

  • Android
  • Samsung S5

Workaround: None.

Getting 1 Result when Expecting 3 Bar Code Results

When using bar code automation, when 3 results are expected, only one result is returned. (611781)

Affected platforms and/or known devices:

  • Android

Workaround: None.

Colors are Shifted for TIFF Images on iOS 8.3

Processing images to colored tiffs on iOS 8.3 will result in incorrect colors. The SDK contains code that generates TIFF images in a JPEG compressed YCbCr format. The resulting files conform to TIFF specifications, and the images check out OK with an online TIFF header/viewer. Prior to iOS 8.3, the images displayed properly when reading in with [UIImage imageWithContentsOfFile]. With 8.3, the colors are reversed (BGR instead of RGB). This bug has been reported to Apple. (609601 )

Affected platforms and/or known devices:

  • iOS

Workaround: Avoid using TIFF images.

Processed Image is Inappropriately Deskewed

The processed image is deskewed even though auto deskew is disabled when auto rotate is enabled. If you are going to use auto rotate it is recommended that you enable deskew. (608615)

Affected platforms and/or known devices:

  • iOS

Workaround: None.

Flash Keeps Cycling On/OFF Every Second

On some devices, the flash keeps cycling on and off every second before the image is captured. For these devices, the flash is being used to aid auto-focus and, depending on the diver, may be normal behavior. See the Android Developer guide for details. (607732 )

Affected platforms and/or known devices:

  • Android

Workaround: None.

Shaky Circle and Target While Capturing

The circle and target will keep shaking, even when the device is steady. This can make it difficult to capture, especially when using the default stability settings. (596444)

Affected platforms and/or known devices:

  • Moto G
  • Amazon Kindle Fire HDX 8.9

Workaround: Force capture the images or lower the stability threshold to something like 65.

Unable to Capture Document with Default Page Area Threshold Setting on Certain Devices

When using certain devices, the aspect ratio of the screen makes it difficult to meet the page area threshold. This depends on the page area threshold setting. For example, if the page area threshold is set to 55% when using the Kindle Fire tablet, it is almost impossible to fit a standard sized document within the on screen guides and fill more than 50% of the preview area. Consequently, the image cannot be automatically captured. (591441)

Affected platforms and/or known devices:

  • Kindle Fire
  • Sony Tablet Z
  • Samsung Galaxy Tab S 8.4"

Workaround: Lower the page area threshold as needed to enable capture.

checkCaptureExperience Should Not be Used in Image Mode

The SDK doesn't allow an application to set the preview resolution. Because of this, on certain devices, if the checkCaptureExperice is used in image mode, the captured images are cut off. This occurs even though the default resolution for captured images is higher than 1080p, because the preview resolution is too low. (591091)

Affected platforms and/or devices:

  • Android

Workaround: Always use the checkCaptureExperience in video mode.

Returned BarcodeResult Bounding Box is Null for 2D Bar Codes

After capturing a bar code (PDF 417 or QR) on devices with Android 5.x, the BarcodeResult bounding box that is returned is null. This has been observed when running Android 5.x on Nexus 5, 6, 9. Note that there may be other affected devices, when Android 5.x is used. (568670)

Affected platforms and/or devices:

  • Android 5.x

Workaround: None.

When Image Processing Fails to Write to File, it Fails Silently

In iOS, if the user configures the image processor to write to file after processing, and then specifies a file path that does not exist, the image processor will fail when attempting to write but will not notify the user. (566919)

Affected platforms and/or devices:

  • iOS

Workaround: None.

Calling setPageDetectMode() Causes CheckCaptureExperience to Freeze Sporadically

If setPageDetectMode is called on an ImageCaptureView that's registered to the CheckCaptureExperience, and then the user starts capturing checks, the CheckCaptureExperience will freeze up sporadically. When it freezes up, there is no guidance and you can't use any navigation in your application. (565648)

Affected platforms and/or devices:

  • Android

Workaround: Restart the application.

Captured Image is Cropped

When using the ImageCaptureView, the captured image is cropped. This is seen only in image capture mode and not video capture. This happens with the following image resolutions: 2048x1536 and 2592x1944 (default). (564331)

Affected platforms and/or devices:

  • Android
  • Lenovo Vibe Z2 Pro

Workaround: Change to a different resolution.

Default Resolution for Image Capture Mode Doesn't Capture

When switching to image capture and keeping the default resolution, some devices aren't able to capture because they can't detect the MICR. (564501)

Known affected devices are listed below, there may be others.

Affected platforms and/or devices:

  • Android
  • Moto G
  • Samsung Galaxy Note 1
  • Droid 4
  • Droid Charge
  • Droid Mini
  • Samsung Galaxy S2
  • Nexus 10
  • HTC Thunderbolt

Workaround: If your application needs to support one of these devices, try video mode instead of image capture mode.

Turning Video Frame ON When Camera is Not Open Forces PreviewSize Instead of PictureSize

For the ImageCaptureView, if setUseVideoFrame(true) is called when the camera is not open/ready, then the CameraManager will still set _isUsingVideo to true, even though the camera has not been set to use Video Mode. This causes the camera to use the default PreviewSize instead of the PictureSize when in Image mode, which may cause unintended behavior. (564360)

Affected platforms and/or devices:

  • Android

Workaround: None.

Camera Feed Starts Flickering After A Few Minutes

After leaving the ImageCaptureView open for about 2 minutes, the camera feed flickers, as if some black frames were occasionally showing. (564131)

Affected platforms and/or devices:

  • Android
  • Samsung Mega

Workaround: None.

Default Capture Messages Not in Correct Position Regardless of Device Orientation

On some devices, in the AnimatedDocumentCaptureExperience, the messages are not displayed correctly, regardless of the orientation the device is moved into or the orientation in which the application is launched. This has been observed on the Samsung Tab 10, Samsung Note 10.1 2014 edition, and the Samsung Galaxy Note Pro 12.2. Note that other devices may also be affected. (563887)

Affected platforms and/or devices:

  • Android

Workaround: None.

Level Indicator Freezes After Capture

The level indicator in the ImageCaptureView will not move on the HTC Desire 820 after capturing an image. Intermittently, the level indicator becomes completely stuck for about 5 seconds. (563875)

Affected platforms and/or devices:

  • Android
  • HTC Desire 820

Workaround: None.

Check Detection Does Not on Work Older Versions of Android

Check Detection and the Check Capture Experience are not supported on older versions of Android (Gingerbread and earlier). (560519)

Affected platforms and/or devices:

  • Android

Workaround: For older versions, use the Animated Document Capture Experience instead.

Check Detector Returns Bounds Rotated 90 Degrees

When passing in a portrait image, bounds come back in landscape. These bounds should be transformed back into portrait before they are returned. (556995)

Affected platforms and/or devices:

▪ Android

Workaround: None

CheckCaptureExperience Does Not Work if the Landscape View is Landscape Left

The CheckCaptureExperience works (gives correct guidance) in portrait orientation as well as "landscape right" orientation. If it is in "landscape left" orientation, it will give you the wrong guidance. Android devices display upside down CaptureMessages. (559425)

Affected platforms and/or devices:

  • Android
  • iOS

Workaround: None

CheckDetector Only Works With Landscape Bitmaps

The CheckDetector class only works when passed a landscape-oriented bitmap. With portrait-oriented bitmaps, you either get back a null result, or occasionally a sig 11 crash. (557910)

Affected platforms and/or devices:

  • Android

Workaround: Use only landscape-oriented bitmaps with the CheckDetector. If necessary, you can try manually rotating the image.

CheckDetector Always Returns Null

When passing in CheckSide Back or None, a null result is always returned from the CheckDetector instead of the expected normal contrast-based page detection results when using these modes. (557276)

Affected platforms and/or devices:

  • Android

Workaround: None: This capability has not been implemented. Back and None values will return a null result by design. This may change in a future release.

Check Capture Experience May Display Pulsating MICR Boxes

In some cases, the guidance frame used when capturing the MICR line from a check may incorrectly appear to pulsate and two default messages will appear overlaid on top of each other. This will happen when an application inadvertently constructs two CheckCaptureExperience objects or two AnimatedDocumentCaptureExperience objects on the same image capture control. (557212)

Affected platforms and/or devices:

  • iOS

Workaround: Do not double up on check capture experiences.

Captured Credit Cards May Not Be Displayed Correctly

On certain combinations of phone model and Android version, the embossed credit card (Card.io) capture view displays as an opaque gray rectangle. (554751)

Affected platforms and/or devices:

  • Android

Workaround: Set the hardwareAccelerated flag to true for the io.card.payment.CardIOActivity in your Android manifest file:

<activity
android:name="io.card.payment.CardIOActivity"
android:configChanges="keyboardHidden|orientation"
android:hardwareAccelerated="true" />

Large Images Cause an Error in Check Deposit

There's an issue with large images for Check Deposit that is causing this error: Unhandled Exception: System.AccessViolationException: Attempted to read or write protected memory. This is often an indication that other memory is corrupt. This occurs when the image is large and image processing is done on the image. The dimensions of the images are about 3400x1500 with a DPI of 400. (548315)

Affected platforms and/or devices:

  • iOS
  • Android

Workaround: Do use very large images with Check Deposit.

Sony XPeria Z1s Captures Unfocused Images

When using the image capture control in video capture mode with continuous capture on, it is very easy to capture unfocused images, particularly in low light conditions. (378258)

Affected platforms and/or devices:

  • Android
  • Sony XPeria Z1s

Workaround: Ensure there is adequate lighting and try turning the torch on.

Droid Razr Maxx Stability Value Not Stable

When trying to capture with page detection, the stability value occasionally jumps between 86~87 to 100, even when the phone is motionless. This side effect makes it difficult to capture when page detection is enabled. (375515)

Affected platforms and/or devices:

  • Android
  • Droid Razr Maxx

Workaround: None.

PostNet Bar Code Search is Slower Than Other Bar Code Symbologies

Depending on the device and the bar codes being read, search times will vary but will in general be up to 10 times slower when searching for the same number of PostNet symbologies as when searching for another symbology. (370107)

Affected platforms and/or devices:

  • All

Workaround: None.

HTC Thunderbolt May Crash When Using Torch

In the Android Image Capture control, when using the Torch on the HTC Thunderbolt, the lamp will hold a steady light before capturing the image. But after a continuous capture or force capture event, the torch may occasionally flash and cause the application to crash. (369559)

Affected platforms and/or devices:

  • Android
  • HTC Thunderbolt

Workaround: None, the SDK will throw an exception if this device is used with the torch.

Android App Will Not Run in Emulator with Google Maps API Enabled

The Android BankRight app will not run in the Android emulator when the Google maps API is enabled. (352625)

Affected platforms and/or devices:

  • Android

Workaround: Removing Google Maps from the AndroidManifest.xml will allow the BankRight app to run in the emulator appropriately.

Level Indicator Sluggish With Continuous Page Detection

On the iPhone 4, the motion of the level indicator becomes quite choppy and is difficult to use. In addition, it may jump back to the center of the screen, even if the device is not level. This happens when continuous page is on in either video or capture mode. (346683)

Affected platforms and/or devices:

  • iOS
  • iPhone 4

Workaround: Don't use continuous page detection with this device; use auto page detection instead.

Blue Overlay Obscures Viewer At Certain Sizes

A blue overlay obscures the viewfinder at certain custom X and Y values (both dimensions must be from 200 to 215). This issue has only been observed on the LG Lucid. (346319)

Affected platforms and/or devices:

  • Android
  • LG Lucid

Workaround: If you experience this issue, try changing the size.

Extreme DPI Settings Not Supported

On the low side, setting a DPI below 30 is not supported. On the high side, problems appear when the DPI is set in the thousands, the exact value depending on the device and its configuration. (345439, 345420, 306154, 306152 )

Specific problems may vary, for example there may be memory alerts, parts of the screen may turn black, and in the worst case the application may crash. As a general rule of thumb, try to use a DPI value between 200 and 300.

Affected platforms and/or devices:

  • Android
  • iOS

the application should include logic to confirm and enforce minimum and maximum DPI settings.

Overexposed Images if Lighting Changes from Dark to Bright

When attempting to capture a driver license, check, or bill, if the device camera is in a dark area, the camera compensates for the darkness by setting the exposure to high. If the lighting suddenly changes to bright, the camera does not reset the exposure to compensate when the flash fires as a focus aid. This causes the view to be stuck in an overexposed state, resulting in a badly washed out image. (344839) This may happen, for example, when setting the device on a table top such that virtually all the light entering the lens is blocked by the table surface. When the device is lifted from the table the flash fires, and light floods the lens, but the image does not adjust.

Affected platforms and/or devices:

  • Android
  • Samsung Galaxy Note Pro 12.2
  • Samsung Galaxy Tab 10.1

Workaround: Make sure the flash is off. Or, force the camera to reset the exposure by rotating the device or by relaunching the capture control.

Unable to Capture with Pitch Set to 180

Setting certain pitch (declination) values may prevent the device from capturing an image. The SDK allows a range of declination values based on the limits of the device, and does not prohibit values within that range, even when those values lead to problems, such as setting the pitch to 180 (which would be the equivalent of taking a picture while upside down). It is up to the app to enforce what the developer considers to be a reasonable range of values for the pitch. In general, any value from 0 (horizontal) to 90 (vertical) should work without issues. (344237)

Affected platforms and/or devices:

  • Android
  • iOS

Workaround: Restrict the pitch range to something reasonable.

Certain Screen Resolutions Problematic

Under poor lighting conditions, when the below resolutions are used with the image capture view, the iPhone 4 camera repeatedly seeks focus for a prolonged period of time (up to 30 seconds). When using the video capture frame, camera focus becomes unresponsive. Also, the level indicator remains yellow, and even if the view in the preview screen becomes focused, the camera still does not take a picture. (343578)

Note that this is not unique to the SDK and could occur in any app that attempts to use these resolutions on an iPhone 4.

The resolutions causing these problems are:

  • Preset 1280x720
  • PresetHigh
  • iFrame 1280x720
  • InputPriority

Affected platforms and/or devices:

  • iOS
  • iPhone 4

Workaround: Avoid using these resolutions with the iPhone 4 unless you can ensure ideal lighting. Also, you can disable the video mode and instead use the image capture frame with Photo resolution to capture high resolution images. Other iOS devices do not exhibit this issue.

Note Another alternative is to leave the torch on while capturing images with these resolutions. This may yield better results, but when using this approach, try to minimize glare from the torch lamp.

Removed Images Still Visible in Gallery

After using the SDK to delete images from the image gallery, thumbnails may still be visible when subsequently viewing the gallery. (342182)

Affected platforms and/or devices:

  • Android

Workaround: Make sure your app refreshes the image gallery after removing an image. You can do this by rescanning the media programmatically.

Camera Feed Upside Down on Landscape Tablets

Some tablets (those which are designed such that landscape mode is the natural orientation) may exhibit a problem where the camera view appears inverted in the tablet screen. (306611)

This occurs when rapidly rotating the device 180 degrees one or more times.

Affected platforms and/or devices:

  • Android
  • Asus Transformer
  • Galaxy Tab 10.1
  • Nexus 10
  • Possibly others

Workaround: When rotating the tablet, pause for a few moments every 90 degrees. Alternatively, disable the auto-rotate screen option.

About the Author

Atalasoft General

This is a general account for case studies, product information, and articles about the culture of Atalasoft.

Follow on Twitter More Content by Atalasoft General

No Previous Articles

Next Article
Release Notes:  MobileImage 2.6.0
Release Notes: MobileImage 2.6.0