com.symbol.emdk.barcode

Class ScannerConfig.ReaderParams.ReaderSpecific.LaserSpecific

java.lang.Object

com.symbol.emdk.barcode.ScannerConfig.ReaderParams.ReaderSpecific.LaserSpecific

Enclosing class:

ScannerConfig.ReaderParams.ReaderSpecific

public class ScannerConfig.ReaderParams.ReaderSpecific.LaserSpecific
extends Object

LaserSpecific class provides access to the laser scanner specific parameters.

Field Summary

Fields

Modifier and Type	Field and Description
ScannerConfig.AdaptiveScanning	adaptiveScanning This parameter enables or disables the adaptive scanning.
int	aimTimer Duration in milliseconds for timed aim types ScannerConfig.AimType.TIMED_HOLD and ScannerConfig.AimType.TIMED_RELEASE.
ScannerConfig.AimType	aimType Describes the type of aiming to use.
ScannerConfig.AutoCharacterSetFailureOption	autoCharacterSetFailureOption If the system cannot find a character set from the preferred order that can correctly decode the data, this will be used as the character set.
ScannerConfig.AutoCharacterSetPreference[]	autoCharacterSetPreferredOrder Sets the preferred character set order to decode the barcode data when character set selection is set to "Auto".
int	beamTimer Sets the maximum amount of time that the reader remains on (0 - 60,000 ms in increments of 100 ms).
ScannerConfig.BeamWidth	beamWidth Controls the beam width of a laser scanner.
ScannerConfig.CharacterSet	characterSetSelection Sets the character set to be used to decode the returned barcode data.
int	connectionIdleTime This is the time (in seconds) when an external scanner is idle in a particular state (ScannerStates.IDLE to ScannerStates.WAITING) after which the connection between the terminal and the scanner is severed to conserve power.
ScannerConfig.ReaderParams.ReaderSpecific.ContinuousRead	continuousRead Deprecated. We recommend using the new fields aimType, sameSymbolTimeout, differentSymbolTimeout in your new applications. ContinuousRead class provides access to continuous scanning related parameters.
int	differentSymbolTimeout This setting is used to prevent the scanner from decoding another symbol within this time interval.
boolean	disconnectOnExit This parameter indicates to the scan driver to disconnect any existing connection between an external Bluetooth scanner and the terminal.
ScannerConfig.Inverse1DMode	inverse1DMode This parameter allows the user to select decoding on inverse 1D barcodes.
ScannerConfig.LinearSecurityLevel	linearSecurityLevel Sets the number of times a barcode is read to confirm an accurate decode.
ScannerConfig.OneDQuietZoneLevel	oneDQuietZoneLevel This parameter sets the effort at which the decoder will attempt to decode margin-less barcodes.
ScannerConfig.PairAfterScannerReboot	pairAfterScannerReboot Enable/disable automatic reconnection after scanner reboot.
ScannerConfig.PoorQualityDecodeEffortLevel	poorQualityDecodeEffortLevel This parameter permits selection of enhancement modes for decoding barcodes of poor or degraded quality.
ScannerConfig.PowerMode	powerMode Set scanner power mode.
int	sameSymbolTimeout This setting is used to prevent the scanner driver from decoding the same symbol within this time interval.

Method Summary

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

continuousRead

@Deprecated
public ScannerConfig.ReaderParams.ReaderSpecific.ContinuousRead continuousRead

Deprecated.

We recommend using the new fields aimType, sameSymbolTimeout, differentSymbolTimeout in your new applications.

ContinuousRead class provides access to continuous scanning related parameters.

beamTimer

public int beamTimer

Sets the maximum amount of time that the reader remains on (0 - 60,000 ms in increments of 100 ms). A value of 0 sets the reader to stay on indefinitely.

 
 	Example Usage:
 	readerParams.beamTimer = 1500;
 

linearSecurityLevel

public ScannerConfig.LinearSecurityLevel linearSecurityLevel

Sets the number of times a barcode is read to confirm an accurate decode. Use enum ScannerConfig.LinearSecurityLevel.

 
 	Example Usage:
 	readerParams.linearSecurityLevel = LinearSecurityLevel.ALL_THRICE;
 

inverse1DMode

public ScannerConfig.Inverse1DMode inverse1DMode

This parameter allows the user to select decoding on inverse 1D barcodes. Use enum ScannerConfig.Inverse1DMode.

 
 	Example Usage:
 	readerParams.cameraSpecific.inverse_1d_mode = Inverse1DMode.AUTO;
 

powerMode

public ScannerConfig.PowerMode powerMode

Set scanner power mode. Use enum ScannerConfig.PowerMode.

oneDQuietZoneLevel

public ScannerConfig.OneDQuietZoneLevel oneDQuietZoneLevel

This parameter sets the effort at which the decoder will attempt to decode margin-less barcodes. Behavior of the level set to this parameter will vary based on the margin-less decoder selected. Note: Higher margin-less levels will increase decoding times and the risk of decoding errors. Zebra therefore recommends enabling only the symbologies that require a higher margin-less level, and leaving all other symbologies at the default level of 1. Use enum ScannerConfig.OneDQuietZoneLevel.

 
 	Example Usage:
 	readerParams.laserSpecific.oneDQuietZoneLevel = OneDQuietZoneLevel.LEVEL_0;
 

poorQualityDecodeEffortLevel

public ScannerConfig.PoorQualityDecodeEffortLevel poorQualityDecodeEffortLevel

This parameter permits selection of enhancement modes for decoding barcodes of poor or degraded quality. Use enum ScannerConfig.PoorQualityDecodeEffortLevel.

 
 	Example Usage:
 	readerParams.laserSpecific.poorQualityDecodeEffortLevel = PoorQualityDecodeEffortLevel.LEVEL_0;
 

adaptiveScanning

public ScannerConfig.AdaptiveScanning adaptiveScanning

This parameter enables or disables the adaptive scanning. When adaptive scanning is enabled, the scan engine will automatically toggle between 2 scan angles, wide and narrow, allowing the scan engine to decode barcodes based on the distance. Use enum ScannerConfig.AdaptiveScanning.

 
 	Example Usage:
 	readerParams.laserSpecific.adaptiveScanning = AdaptiveScanning.ENABLE;
 

beamWidth

public ScannerConfig.BeamWidth beamWidth

Controls the beam width of a laser scanner. Laser beam width can be shortened or widened using this parameter. Use enum ScannerConfig.BeamWidth.

 
 	Example Usage:
 	readerParams.laserSpecific.beamWidth = BeamWidth.NORMAL;
 

aimType

public ScannerConfig.AimType aimType

Describes the type of aiming to use.

Note: Setting aimType is recommended instead of ScannerConfig.ReaderParams.ReaderSpecific.ContinuousRead.isContinuousScan. If the application modifies ScannerConfig.ReaderParams.ReaderSpecific.ContinuousRead.isContinuousScan and aimType, the aimType settings will take precedence.

aimTimer

public int aimTimer

Duration in milliseconds for timed aim types ScannerConfig.AimType.TIMED_HOLD and ScannerConfig.AimType.TIMED_RELEASE. Note than this duration must be less than the beamTimer.

sameSymbolTimeout

public int sameSymbolTimeout

This setting is used to prevent the scanner driver from decoding the same symbol within this time interval. This is applicable only for the aim type ScannerConfig.AimType.CONTINUOUS_READ. Basically in the continuous mode the user can perform rapid scan and to prevent the user from decoding the same barcode twice user can set this value to an appropriate interval (in milliseconds). A value of 0 means no interval is required between two successive reads. Boundary values are 0 to 5000 in milliseconds in 500 increments such as 0, 500, 1000... etc

Note: If the application modifies ScannerConfig.ReaderParams.ReaderSpecific.ContinuousRead.sameSymbolTimeout and sameSymbolTimeout, the sameSymbolTimeout settings will take precedence.

differentSymbolTimeout

public int differentSymbolTimeout

This setting is used to prevent the scanner from decoding another symbol within this time interval. This is applicable only for the aim type ScannerConfig.AimType.CONTINUOUS_READ. The user may want to prevent decoding too quickly and set an interval that the user can aim before decoding the next barcode. A value of 0 means no interval is required between two successive reads. Boundary values are 0 to 5000 in milliseconds in 500 increments such as 0, 500, 1000... etc

Note: If the application modifies ScannerConfig.ReaderParams.ReaderSpecific.ContinuousRead.differentSymbolTimeout and differentSymbolTimeout, the differentSymbolTimeout settings will take precedence.

characterSetSelection

public ScannerConfig.CharacterSet characterSetSelection

Sets the character set to be used to decode the returned barcode data. This is generally set to match the encoding of the physical barcode to be scanned. If not set, default character set UTF-8 is used.

 
 	Example Usage:
 	readerParams.readerSpecific.laserSpecific.characterSetSelection = CharacterSet.UTF_8;
 

autoCharacterSetFailureOption

public ScannerConfig.AutoCharacterSetFailureOption autoCharacterSetFailureOption

If the system cannot find a character set from the preferred order that can correctly decode the data, this will be used as the character set. The output string may not fully accurate.

 
 	Example Usage:
 	readerParams.readerSpecific.laserSpecific.autoCharacterSetFailureOption = AutoCharacterSetFailureOption.UTF_8;
 

autoCharacterSetPreferredOrder

public ScannerConfig.AutoCharacterSetPreference[] autoCharacterSetPreferredOrder

Sets the preferred character set order to decode the barcode data when character set selection is set to "Auto". Preference order cannot be empty.

 
 	Example Usage:
 	readerParams.readerSpecific.laserSpecific.autoCharacterSetPreferredOrder = new AutoCharacterSetPreference[]{AutoCharacterSetPreference.GB2312, AutoCharacterSetPreference.UTF_8};
 

disconnectOnExit

public boolean disconnectOnExit

This parameter indicates to the scan driver to disconnect any existing connection between an external Bluetooth scanner and the terminal. When a BT scanner establishes connection to the terminal it will not automatically disconnect when the scanner is disabled by calling Scanner.disable(). If this parameter is set the scanning driver will force the scanner to disconnect. Note: If this parameter is set to false, it will not fire the DISCONNECTED state. This parameter will be ignored, if the scanner is being used by any other application. For example, EMDK Notification APIs, RSM CSP, Battery notification. This parameter will be ignored till the last client releases the scanner.

connectionIdleTime

public int connectionIdleTime

This is the time (in seconds) when an external scanner is idle in a particular state (ScannerStates.IDLE to ScannerStates.WAITING) after which the connection between the terminal and the scanner is severed to conserve power. This is currently applicable to Bluetooth scanners only. For Android L and above the valid range start from 0. When time is set to 0, BT scanner will remain connected with terminal.

pairAfterScannerReboot

public ScannerConfig.PairAfterScannerReboot pairAfterScannerReboot

Enable/disable automatic reconnection after scanner reboot. Applicable to DS3678 Bluetooth scanner only. Use enum ScannerConfig.PairAfterScannerReboot.

 
 	Example Usage:
 	readerParams.laserSpecific.pairAfterScannerReboot = PairAfterScannerReboot.ENABLE;