The Barcode Module provides access to control the functionality of the device’s scanner. Because RhoMobile Suite is designed to run on both Consumer devices and Zebra Technologies' enterprise devices support for the Barcode API will vary for each method and properties depending on which platform you are running on. Please note that a lot these APIs are optimized for the extended functionality that Zebra Technologies devices provide. Check the platform indicators in each property or method section. In general if you are developing for a consumer device the number of symbologies available to you will be limited to just the most common ones, eg EAN13, UPCA etc and your scanning will be via the device camera. If your application is running on Zebra Technologies' hardware you will have much finer control over a more fully featured Scanner, often with a choice of scanner hardware on the device. In general if you wish to capture a single barcode in a ‘one shot’ use case, eg your App just wants to capture a single barcode to be submitted to a price comparison website then use Barcode.take(callback); if your application is expecting a number of barcodes to be received, common in enterprise scenarios for example a user in a warehouse then use Barcode.enable(callback). The Barcode API will not run on non-Zebra Windows Mobile / CE devices.
Only the foreground RhoElements application is given access to the scanning hardware, when an application is sent to the background its state will be saved and it will automatically relinquish control of the scanner. When brought back to the foreground, an application previously using the barcode API will have its previous configuration reapplied automatically.In VC70 scanner will work only if connected in SSI Mode.
In order to use this API you must include the following extension in your build.yml
extensions: ["barcode"]
The barcode
extension is also included automatically if you specify the following in your build.yml
app_type: "rhoelements"
If you are building a Windows Mobile or Windows CE app with this API, you must set your app_type as “rhoelements” in your build.yml as shown here. |
Be sure to review the JavaScript API Usage guide for important information about using this API in JavaScript
Be sure to review the Ruby API Usage guide for important information about using this API in Ruby
Recognizes a barcode on an image. Returns a string with recognized code, or empty string if the barcode is not recognized.
Parameters
Path to the image that contains the barcode to be recognized.
Synchronous Return:
String with recognized code, or empty string if the barcode is not recognized.
Method Access:
myObject.barcode_recognize(STRING imageFilePath)
Rho.Barcode.barcode_recognize(STRING imageFilePath)
Rho::Barcode.barcode_recognize(STRING imageFilePath)
Instruct the connected RS507 scanner to perform some action.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Parameters
The action the RS507 scanner should perform, can be ‘Disconnect’ which disconnects the bluetooth RS507; ‘unpair’ which unpairs the RS507 from the device for association with another device; ‘StartPaging’ or ‘StopPaging’ which will cause the RS507 scanner to start or stop emitting a beep, to allow it to be located.
Synchronous Return:
Method Access:
myObject.commandRemoteScanner(STRING command)
Rho.Barcode.commandRemoteScanner(STRING command)
Rho::Barcode.commandRemoteScanner(STRING command)
Disables the barcode scanner. This reverts the scanner to its default state and flushes any current decoder settings.
(Zebra Technologies' scanners)
Synchronous Return:
Method Access:
myObject.disable()
Rho.Barcode.disable()
Rho::Barcode.disable()
Enabling the scanner puts it in a state where it will respond to the trigger (on devices with a hardware trigger) or will accept a command to initiate a soft scan (start method). Scanned barcodes will be available to the application through the callback provided to this method. Only one scanner on the device can be enabled at any one time, to switch between the imager and camera scanners (for example) then first disable the currently enabled scanner. If you do not specify a callback to this method you will received the scanned data as keystrokes. Note that it is necessary to enable the scanner on WM/CE devices prior to being able to retrieve the state of properties.
This method replaces Barcode.enable from RhoElements 2.2 and takes a different prototype, no longer taking a ‘deviceName’ parameter this method can now be called on the individual scanner instances returned by Barcode.enumerate to control which hardware scanner on the device is enabled. Please consider using Barcode.take if you only require a ‘single shot’ scan and Barcode.enable if your user will be using the trigger to return scan events. |
(Zebra Technologies' Scanners which support a hardware or software trigger to invoke the scan.)
Parameters
Provide a set of properties to configure the scanner, for example enable specific symbologies or check digits.
Valid `properties` for this parameter are the properties avaliable to this API module. Check the property sectionNot providing properties to this function will use the scanner’s default properties, or those previously set on the Scanner instance.
Async Callback Returning Parameters: HASH
The data decoded by the scanner or imaging device.
The source device and human readable decoder type of the decoded barcode or symbol.
Hex value representing the decoder type.
The time at which the decode occurred (hh:mm:ss)
The length of the decoded barcode or symbol.
The direction the barcode was scanned, either forward, reverse or unavailable.
Synchronous Return:
Method Access:
myObject.enable(HASH propertyMap, CallBackHandler callback)
Rho.Barcode.enable(HASH propertyMap, CallBackHandler callback)
Rho::Barcode.enable(HASH propertyMap, CallBackHandler callback)
This method will return all of object/value pairs for the propertyNames of the API class.
Parameters
Async Callback Returning Parameters: HASH
Synchronous Return:
Map of all available properties
: this method also supports async callbacks - check the Callback tab for callback return parameters.
Method Access:
myObject.getAllProperties(CallBackHandler callback)
Rho.Barcode.getAllProperties(CallBackHandler callback)
Rho::Barcode.getAllProperties(CallBackHandler callback)
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.
Synchronous Return:
Default object of Module.
Method Access:
Rho.Barcode.getDefault()
Rho::Barcode.getDefault()
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
List of properties I want to know about
Async Callback Returning Parameters: HASH
Synchronous Return:
Map of properties I want to know about
: this method also supports async callbacks - check the Callback tab for callback return parameters.
Method Access:
myObject.getProperties(ARRAY arrayofNames, CallBackHandler callback)
Rho.Barcode.getProperties(ARRAY arrayofNames, CallBackHandler callback)
Rho::Barcode.getProperties(ARRAY arrayofNames, CallBackHandler callback)
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
The property to return info about.
Async Callback Returning Parameters: STRING
Synchronous Return:
The property to return info about.
: this method also supports async callbacks - check the Callback tab for callback return parameters.Method Access:
myObject.getProperty(STRING propertyName, CallBackHandler callback)
Rho.Barcode.getProperty(STRING propertyName, CallBackHandler callback)
Rho::Barcode.getProperty(STRING propertyName, CallBackHandler callback)
Return array of properties supported by this scanner.
Parameters
Async Callback Returning Parameters: ARRAY
Synchronous Return:
Array of property names supported by this scanner.
: this method also supports async callbacks - check the Callback tab for callback return parameters.
Method Access:
myObject.getSupportedProperties(CallBackHandler callback)
Rho.Barcode.getSupportedProperties(CallBackHandler callback)
Rho::Barcode.getSupportedProperties(CallBackHandler callback)
If you are using an RS507 barcode scanner you can register to receive connected or disconnected events through this method.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Parameters
Async Callback Returning Parameters: HASH
The message describing the bluetooth connection: BluetoothConnected, BluetoothDisconnected or BTScanAssociationBarcode. See below for further descriptions.
Synchronous Return:
Method Access:
myObject.registerBluetoothStatus(CallBackHandler callback)
Rho.Barcode.registerBluetoothStatus(CallBackHandler callback)
Rho::Barcode.registerBluetoothStatus(CallBackHandler callback)
This method allows you to set the attributes of the default object instance by passing in an object of the same class.
Parameters
An instance object that is of the same class.
Synchronous Return:
Method Access:
Rho.Barcode.setDefault(SELF_INSTANCE: Rho::Barcode defaultInstance)
Rho::Barcode.setDefault(SELF_INSTANCE: Rho::Barcode defaultInstance)
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
Map of properties I want to set
Synchronous Return:
Method Access:
myObject.setProperties(HASH propertyMap)
Rho.Barcode.setProperties(HASH propertyMap)
Rho::Barcode.setProperties(HASH propertyMap)
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
The one property name that I want to set
The one property value that I want to set
Synchronous Return:
Method Access:
myObject.setProperty(STRING propertyName, STRING propertyValue)
Rho.Barcode.setProperty(STRING propertyName, STRING propertyValue)
Rho::Barcode.setProperty(STRING propertyName, STRING propertyValue)
Performs a soft trigger start, initiating a scan without pressing the hardware trigger. If the scan does not result in a decode it is necessary to perform a soft stop before another soft start.
(Zebra Technologies' scanners)
Synchronous Return:
Method Access:
myObject.start()
Rho.Barcode.start()
Rho::Barcode.start()
Performs a soft trigger stop.
(Zebra Technologies' scanners)
Synchronous Return:
Method Access:
myObject.stop()
Rho.Barcode.stop()
Rho::Barcode.stop()
Enable the scanner and start capturing the barcode automatically. On Zebra Technologies' devices the amount of time to scan the barcode is defined by the scanTimeout property. On iPhone and Android if a barcode is found, the user can confirm barcode recognition, or continue to try to recognize the barcode. When the user confirms or cancels, the callback is called. Once the callback has been called the barcode hardware is disabled.This method will work only on scanners which support soft scan.
Parameters
Provide a set of properties to configure the scanner, for example enable specific symbologies or check digits.
Valid `properties` for this parameter are the properties avaliable to this API module. Check the property sectionNot providing properties to this function will use the scanner’s default properties, or those previously set on the Scanner instance.
Async Callback Returning Parameters: HASH
The data decoded by the scanner or imaging device.
Whether or not the barcode was successfully scanned, status will be ‘ok’ or ‘cancel’
Synchronous Return:
Method Access:
myObject.take(HASH propertyMap, CallBackHandler callback)
Rho.Barcode.take(HASH propertyMap, CallBackHandler callback)
Rho::Barcode.take(HASH propertyMap, CallBackHandler callback)
deprecated old method for taking barcode.
Parameters
Ruby callback URL.
Provide a set of properties to configure the scanner, for example enable specific symbologies or check digits.
Valid `properties` for this parameter are the properties avaliable to this API module. Check the property sectionNot providing properties to this function will use the scanner’s default properties, or those previously set on the Scanner instance.
Synchronous Return:
Method Access:
myObject.take_barcode(STRING rubyCallbackURL, HASH propertyMap)
Rho.Barcode.take_barcode(STRING rubyCallbackURL, HASH propertyMap)
Rho::Barcode.take_barcode(STRING rubyCallbackURL, HASH propertyMap)
Enables or disables adaptive scanning. When set to true, the scan engine will automatically toggle between 2 scan angles, wide and narrow, allowing the scan engine to decode barcodes both in close proximity and far away (~100 inches). Adaptive scanning is only supported in high performance, long working range scan engines such as SE960.
(Laser Scanners on Zebra Technologies' devices)
Property Access:
myObject.adaptiveScanning
Rho.Barcode.adaptiveScanning
Rho::Barcode.adaptiveScanning
Defines the aiming mode to use.
(Scanners on Zebra Technologies' devices)
Possible Values (STRING):
No Aiming (Can be overridden by picklistMode).
Laser barcode readers will show a dot for aiming.
Laser barcode readers will show a slab for aiming.
Imager barcode readers will show a reticle for aiming.
Property Access:
myObject.aimMode
Rho.Barcode.aimMode
Rho::Barcode.aimMode
Describes the type of aiming to use.
(Scanners on Zebra Technologies' devices)
Possible Values (STRING):
Standard trigger mode. Holding the trigger will start a decoding session.
Aiming lasts for the time specified by ‘timedAimDuration’ before decoding. The opportunity to scan will last until the barcode is decoded or scanTimeout occurs.
Aiming lasts until trigger is released. If the timedAimDuration has expired when the trigger is released then a decode session is started until a barcode is decoded or for the remaining time equal to the scanTimeout value.
Provided to support Kiosk devices. The scanner illuminates when movement is detected in the range of the scanner window. In order to use this mode the scanner must be initiated with a softscan using the Rho.Barcode.start() method and again after each decode. The device must be equipped with a sensor to detect movement to use presentation mode. MK31XX devices come with presentation modes preenabled in scanner driver. Aimtype should not be set to presentation for MK31xx devices as it may produce undesirable results.
Scan will continue after the trigger is released until scanTimeout occurs.
Once the trigger is pulled barcodes will continue to be scanned as long as the trigger is held, enabling rapid scanning, to be used in conjunction with sameSymbolTimeout and differentSymbolTimeout. This value is ignored if viewfinderMode is set to ‘dynamicReticle’
Property Access:
myObject.aimType
Rho.Barcode.aimType
Rho::Barcode.aimType
When set to true, the barcode scanner will read all barcode types that the scanner is capable of reading. When set to false, the barcode scanner will not be able to decode any symbologies, this is most useful if you want to set the scanner to a default state before only enabling your required symbologies. The fewer symbologies that are enabled the faster the decoding performance of the scanning engine will be. This property will return true only if all supported symbologies by the scanner are enabled, if only a subset of supported symbologies are enabled then false will be returned. Note that some decoders will not be enabled as some symbologies use the same systems to encode data, making it impossible to differentiate between them. For example: “canpostal” and “auspostal” both use a 4-state system, so devices will only enable either “canpostal” OR “auspostal” when “alldecoders” is enabled. Note that other symbologies also share the 4-state system.
(Scanners on Zebra Technologies' devices)
Property Access:
myObject.allDecoders
Rho.Barcode.allDecoders
Rho::Barcode.allDecoders
Enables or disables the symbology for Australian Postal barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.ausPostal
Rho.Barcode.ausPostal
Rho::Barcode.ausPostal
When true, automatically appends the character code for ‘enter’ to the end of any barcodes scanned. This is useful if you want to submit forms following a scan without further interaction. This property will only take effect if you have not specified a callback to the enable method. AutoEnter and AutoTab are mutually exclusive properties.
(Scanners on Zebra Technologies' devices)
Property Access:
myObject.autoEnter
Rho.Barcode.autoEnter
Rho::Barcode.autoEnter
When true, automatically appends the tab character to the end of any barcodes scanned. This is useful if you are populating a form and want to jump to the next field in the form without further interaction. This property will only take effect if you have not specified a callback to the enable method. AutoTab and AutoEnter are mutually exclusive properties.
(Scanners on Zebra Technologies' devices)
Property Access:
myObject.autoTab
Rho.Barcode.autoTab
Rho::Barcode.autoTab
Enables or disables the symbology for Aztec barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.aztec
Rho.Barcode.aztec
Rho::Barcode.aztec
Specifies the format in which the barcode data is returned, binary data is returned in Data URI format with the appropriate mime type. This parameter is designed to be used primarily with image based symbologies (eg. Signature). Binary data will not be output as keystrokes, you must set a decode callback in order to receive scanned data.
(Camera / Imager Scanners on Zebra Technologies' devices)
Possible Values (STRING):
Scanned data will be returned in Data URI format.
Scanned data will be returned in Text format.
Property Access:
myObject.barcodeDataFormat
Rho.Barcode.barcodeDataFormat
Rho::Barcode.barcodeDataFormat
Specifies the width of the laser beam. All devices will support normal beam widths but other widths may not be supported on your device.
(Laser Scanners on Zebra Technologies' devices)
Possible Values (STRING):
Laser beam width is normal.
Laser beam width is wide.
Laser beam width is narrow.
Property Access:
myObject.beamWidth
Rho.Barcode.beamWidth
Rho::Barcode.beamWidth
Enables or disables bidirectional redundancy.
(Laser Scanners on Zebra Technologies' devices)
Property Access:
myObject.bidirectionalRedundancy
Rho.Barcode.bidirectionalRedundancy
Rho::Barcode.bidirectionalRedundancy
Enables or disables the symbology for Canadian Postal barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.canPostal
Rho.Barcode.canPostal
Rho::Barcode.canPostal
Enables or disables the symbology for Chinese 2of5 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.chinese2of5
Rho.Barcode.chinese2of5
Rho::Barcode.chinese2of5
Enables or disables the symbology for Codabar barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.codabar
Rho.Barcode.codabar
Rho::Barcode.codabar
Enables Codabar CLSi formatting when set to true.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.codabarClsiEditing
Rho.Barcode.codabarClsiEditing
Rho::Barcode.codabarClsiEditing
Specifies the maximum number of allowable characters in a Codabar barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.codabarMaxLength
Rho.Barcode.codabarMaxLength
Rho::Barcode.codabarMaxLength
Specifies the minimum number of allowable characters in a Codabar barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.codabarMinLength
Rho.Barcode.codabarMinLength
Rho::Barcode.codabarMinLength
Enables Codabar NotisEditing formatting when set to true.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.codabarNotisEditing
Rho.Barcode.codabarNotisEditing
Rho::Barcode.codabarNotisEditing
Sets the Codabar Redundancy property, if set the barcode must be decoded twice before being accepted. This will slow scanning but improve reliability.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.codabarRedundancy
Rho.Barcode.codabarRedundancy
Rho::Barcode.codabarRedundancy
Enables or disables the symbology for Code11 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code11
Rho.Barcode.code11
Rho::Barcode.code11
Specifies whether to verify 0, 1 or 2 check digits.
(Not all scanning engines support all symbologies or all symbology properties)
Possible Values (STRING):
Scanning engine will verify no Code 11 check digits.
Scanning engine will verify one Code 11 check digit.
Scanning engine will verify two Code 11 check digits.
Property Access:
myObject.code11checkDigitCount
Rho.Barcode.code11checkDigitCount
Rho::Barcode.code11checkDigitCount
Specifies the maximum number of allowable characters in a Code 11 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code11maxLength
Rho.Barcode.code11maxLength
Rho::Barcode.code11maxLength
Specifies the minimum number of allowable characters in a Code 11 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code11minLength
Rho.Barcode.code11minLength
Rho::Barcode.code11minLength
Sets the Code 11 Redundancy property, if set the barcode must be decoded twice before being accepted. This will slow scanning but improve reliability.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code11redundancy
Rho.Barcode.code11redundancy
Rho::Barcode.code11redundancy
When true, the barcode check digit(s) will be reported for scanned Code 11 barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code11reportCheckDigit
Rho.Barcode.code11reportCheckDigit
Rho::Barcode.code11reportCheckDigit
Enables or disables the symbology for Code128 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code128
Rho.Barcode.code128
Rho::Barcode.code128
When true, decodes concatenated Code128 output only if the pair belongs to one of the commonly concatenated pairs as defined by the standard.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code128checkIsBtTable
Rho.Barcode.code128checkIsBtTable
Rho::Barcode.code128checkIsBtTable
When true, barcodes with the EAN128 subtype property set will be read.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code128ean128
Rho.Barcode.code128ean128
Rho::Barcode.code128ean128
When true, barcodes with the isbt128 subtype property set will be read.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code128isbt128
Rho.Barcode.code128isbt128
Rho::Barcode.code128isbt128
Sets the Code128 ISBT concatenation mode property. This feature allows a pair of barcodes which meet certain criteria defined in the ISBT128 spec to be reported as a single barcode. This parameter describes the different concatenation modes available for ISBT128.
(Not all scanning engines support all symbologies or all symbology properties)
Possible Values (STRING):
Will ignore the barcode pair and only output decode data for one of the barcodes.
Will not decode if both barcodes are not present or if one of them can not be decoded.
Auto-Discriminate.
Property Access:
myObject.code128isbt128ConcatMode
Rho.Barcode.code128isbt128ConcatMode
Rho::Barcode.code128isbt128ConcatMode
Specifies the maximum number of allowable characters in a Code 128 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code128maxLength
Rho.Barcode.code128maxLength
Rho::Barcode.code128maxLength
Specifies the minimum number of allowable characters in a Code 128 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code128minLength
Rho.Barcode.code128minLength
Rho::Barcode.code128minLength
Sets the other 128 property which enables the non EAN and non ISBT 128 subtype.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code128other128
Rho.Barcode.code128other128
Rho::Barcode.code128other128
Sets the Code 128 Redundancy property, if set the barcode must be decoded twice before being accepted. This will slow scanning but improve reliability.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code128redundancy
Rho.Barcode.code128redundancy
Rho::Barcode.code128redundancy
Sets the Code 128 security level and accepts a value between 0 and 3 inclusive. 0: Allows the scanner to operate in its most aggressive state, while providing sufficient security in decoding most ‘in-spec’ barcodes. 1: Eliminates most mis-decodes. 2: Select this option if security level 1 fails to eliminate mis-decodes. 3: Select this option if security level 1 and 2 fail to eliminate mis-decodes. Be advised that selecting level 3 is an extreme measure against mis-decoding and will significantly impair the decoding ability of the scanner.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code128securityLevel
Rho.Barcode.code128securityLevel
Rho::Barcode.code128securityLevel
Enables or disables the symbology for Code 39 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code39
Rho.Barcode.code39
Rho::Barcode.code39
Enables reporting of the Code32 prefix when a Code39 barcode is converted.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code39code32Prefix
Rho.Barcode.code39code32Prefix
Rho::Barcode.code39code32Prefix
Enables conversion from Code39 to Code 32 barcodes, when set the decoded barcode is converted to Code 32.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code39convertToCode32
Rho.Barcode.code39convertToCode32
Rho::Barcode.code39convertToCode32
Enables full ASCII conversion of Code 39 barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code39fullAscii
Rho.Barcode.code39fullAscii
Rho::Barcode.code39fullAscii
Specifies the maximum number of allowable characters in a Code 39 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code39maxLength
Rho.Barcode.code39maxLength
Rho::Barcode.code39maxLength
Specifies the minimum number of allowable characters in a Code 39 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code39minLength
Rho.Barcode.code39minLength
Rho::Barcode.code39minLength
Sets the Code 39 Redundancy property, if set the barcode must be decoded twice before being accepted. This will slow scanning but improve reliability.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code39redundancy
Rho.Barcode.code39redundancy
Rho::Barcode.code39redundancy
Enables reporting of the Code 39 check digit when a Code 39 barcode is scanned.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code39reportCheckDigit
Rho.Barcode.code39reportCheckDigit
Rho::Barcode.code39reportCheckDigit
Sets the Code 128 security level and accepts a value between 0 and 3 inclusive. 0: This setting allows the scanner to operate in its most aggressive state, while providing sufficient security in decoding most ‘in-spec’ barcodes. 1: This setting eliminates most mis-decodes. 2: Select this option if security level 1 fails to eliminate mis-decodes. 3: Select this option if security level 1 and 2 fail to eliminate mis-decodes. Be advised that selecting level 3 is an extreme measure against mis-decoding and will significantly impair the decoding ability of the scanner.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code39securityLevel
Rho.Barcode.code39securityLevel
Rho::Barcode.code39securityLevel
Turns on verification of the Code 39 check digit.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code39verifyCheckDigit
Rho.Barcode.code39verifyCheckDigit
Rho::Barcode.code39verifyCheckDigit
Enables or disables the symbology for Code 93 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code93
Rho.Barcode.code93
Rho::Barcode.code93
Specifies the maximum number of allowable characters in a Code 93 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code93maxLength
Rho.Barcode.code93maxLength
Rho::Barcode.code93maxLength
Specifies the minimum number of allowable characters in a Code 93 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code93minLength
Rho.Barcode.code93minLength
Rho::Barcode.code93minLength
Sets the Code 93 Redundancy property, if set the barcode must be decoded twice before being accepted. This will slow scanning but improve reliability.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.code93redundancy
Rho.Barcode.code93redundancy
Rho::Barcode.code93redundancy
Enables or disables the symbology for Composite AB barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.compositeAb
Rho.Barcode.compositeAb
Rho::Barcode.compositeAb
Describes whether UCC link mode is enabled.
(Not all scanning engines support all symbologies or all symbology properties)
Possible Values (STRING):
Link flag is ignored.
Composite AB barcodes are always linked.
Auto-discriminate whether Composite AB barcodes are linked.
Property Access:
myObject.compositeAbUccLinkMode
Rho.Barcode.compositeAbUccLinkMode
Rho::Barcode.compositeAbUccLinkMode
This setting causes the UPC rules specified in the UPC EAN parameters to be used when reporting composite decode data.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.compositeAbUseUpcPreambleCheckDigitRules
Rho.Barcode.compositeAbUseUpcPreambleCheckDigitRules
Rho::Barcode.compositeAbUseUpcPreambleCheckDigitRules
Enables or disables the symbology for Composite C barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.compositeC
Rho.Barcode.compositeC
Rho::Barcode.compositeC
Specifies the time, in seconds, that an external scanner will be allowed to remain idle before the connection is terminated to conserve power.
(Bluetooth Scanners on Zebra Technologies' devices)
Property Access:
myObject.connectionIdleTimeout
Rho.Barcode.connectionIdleTimeout
Rho::Barcode.connectionIdleTimeout
Enables or disables the symbology for D2of5 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.d2of5
Rho.Barcode.d2of5
Rho::Barcode.d2of5
Specifies the maximum number of allowable characters in a D2of5 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.d2of5maxLength
Rho.Barcode.d2of5maxLength
Rho::Barcode.d2of5maxLength
Specifies the minimum number of allowable characters in a D2of5 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.d2of5minLength
Rho.Barcode.d2of5minLength
Rho::Barcode.d2of5minLength
Sets the D2of5 Redundancy property, if set the barcode must be decoded twice before being accepted. This will slow scanning but improve reliability.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.d2of5redundancy
Rho.Barcode.d2of5redundancy
Rho::Barcode.d2of5redundancy
Specifies the number of bytes allocated to receive the scanned barcode. This parameter is designed to be used primarily with image based symbologies and should not be modified unless absolutely necessary (eg. Signature).
(Scanners on Zebra Technologies' devices)
Property Access:
myObject.dataBufferSize
Rho.Barcode.dataBufferSize
Rho::Barcode.dataBufferSize
Enables or disables the symbology for Datamatrix barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.datamatrix
Rho.Barcode.datamatrix
Rho::Barcode.datamatrix
Describes the type of Digital Bar Pulse (DBP) being produced by the scan engine.
(Laser Scanners on Zebra Technologies' devices)
Possible Values (STRING):
Tells the scan engine to produce normal DBP.
Tells the scan engine to produce composite DBP, which is 2 different sets of DBP data multiplexed together for better decode performance. In order to enable this mode it must be supported by the scanner.
Property Access:
myObject.dbpMode
Rho.Barcode.dbpMode
Rho::Barcode.dbpMode
The duration of the device beeper when a barcode is scanned, in milliseconds.
(Scanners on Zebra Technologies' devices)
Default: 250
Property Access:
myObject.decodeDuration
Rho.Barcode.decodeDuration
Rho::Barcode.decodeDuration
The frequency of the device beeper when a barcode is successfully decoded. This should be within the range of the beeper but the API will accept values in the range 0 to 65535.
(Scanners on Zebra Technologies' devices)
Default: 3000
Property Access:
myObject.decodeFrequency
Rho.Barcode.decodeFrequency
Rho::Barcode.decodeFrequency
Path to a local wave file to be played when the scanner successfully decodes a barcode. This setting overrides the scanner beeper.
(Scanners on Zebra Technologies' devices)
Property Access:
myObject.decodeSound
Rho.Barcode.decodeSound
Rho::Barcode.decodeSound
The volume of the device beeper when a barcode is scanned. 0 to 5 with 5 being the loudest.
(Scanners on Zebra Technologies' devices)
Default: 5
Property Access:
myObject.decodeVolume
Rho.Barcode.decodeVolume
Rho::Barcode.decodeVolume
When the aimType:continuousRead property is applied this value defines the interval between which different barcodes can be scanned. The value is specified in milliseconds, use 0 to indicate no interval between successive reads. Use this setting to allow time for the operator to reaim the device between successive scans.
(Scanners on Zebra Technologies' devices)
Property Access:
myObject.differentSymbolTimeout
Rho.Barcode.differentSymbolTimeout
Rho::Barcode.differentSymbolTimeout
Forces the scanner to disconnect from the terminal when it is ‘disabled’. Since the scanner is disabled when you navigate to a new page, set this value to false if you want to maintain the bluetooth connection to your remote scanner.
(Bluetooth Scanners on Zebra Technologies' devices)
Property Access:
myObject.disconnectBtOnDisable
Rho.Barcode.disconnectBtOnDisable
Rho::Barcode.disconnectBtOnDisable
If set to true the bluetooth address will be displayed as a barcode on the screen during the pairing process, initiated by calling ‘enable’ on a bluetooth scanner. Not all devices support this functionality. Note you must specify this parameter before or within the call to ‘enable’.
(Bluetooth Scanners on Zebra Technologies' devices)
Property Access:
myObject.displayBtAddressBarcodeOnEnable
Rho.Barcode.displayBtAddressBarcodeOnEnable
Rho::Barcode.displayBtAddressBarcodeOnEnable
Allows Direct Part Marking (DPM) barcodes to be read When true, but may adversely affect overall decoding performance. DPM is a way of stamping barcodes directly on physical objects and is only available on DPM terminals.
(Imager / Camera Scanners on Zebra Technologies' devices. The scanning engine must support DPM barcodes.)
Property Access:
myObject.dpmMode
Rho.Barcode.dpmMode
Rho::Barcode.dpmMode
Enables or disables the symbology for Dutch Postal barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.dutchPostal
Rho.Barcode.dutchPostal
Rho::Barcode.dutchPostal
Enables or disables the symbology for EAN 13 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.ean13
Rho.Barcode.ean13
Rho::Barcode.ean13
Enables or disables the symbology for EAN 8 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.ean8
Rho.Barcode.ean8
Rho::Barcode.ean8
When true, EAN 8 barcodes will be converted to EAN 13 and EAN 13 parameters used.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.ean8convertToEan13
Rho.Barcode.ean8convertToEan13
Rho::Barcode.ean8convertToEan13
Configures the time (in seconds) allowed to pair with the external bluetooth scanner after calling the ‘enable()’ method. You must specify this parameter before calling ‘enable’ to change the default.
(Bluetooth Scanners on Zebra Technologies' devices)
Property Access:
myObject.enableTimeout
Rho.Barcode.enableTimeout
Rho::Barcode.enableTimeout
Sets the focus mode in use.
(Imager / Camera Scanners on Zebra Technologies' devices)
Possible Values (STRING):
Use fixed focus.
Use auto focus.
Property Access:
myObject.focusMode
Rho.Barcode.focusMode
Rho::Barcode.focusMode
Returns the friendly name associated with the scanner.
(Scanners on Zebra Technologies' devices)
Property Access:
myObject.friendlyName
Rho.Barcode.friendlyName
Rho::Barcode.friendlyName
Enables or disables the symbology for GS1 DataBar barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance. This symbology was previously known as rss.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.gs1dataBar
Rho.Barcode.gs1dataBar
Rho::Barcode.gs1dataBar
Enables or disables the symbology for GS1 Databar Expanded barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance. This symbology was previously known as rssExp.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.gs1dataBarExpanded
Rho.Barcode.gs1dataBarExpanded
Rho::Barcode.gs1dataBarExpanded
Enables or disables the symbology for GS1 Databar Limited barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance. This symbology was previously known as rssLim.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.gs1dataBarLimited
Rho.Barcode.gs1dataBarLimited
Rho::Barcode.gs1dataBarLimited
Controls the haptic feedback on decode. This means that if this is set to true, then the device will vibrate when a decode occurs.
(Scanners on Zebra Technologies' devices)
Default: true
Property Access:
myObject.hapticFeedback
Rho.Barcode.hapticFeedback
Rho::Barcode.hapticFeedback
Enables or disables the symbology for I2of5 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.i2of5
Rho.Barcode.i2of5
Rho::Barcode.i2of5
When true, EAN 8 barcodes will be converted to EAN 13 and EAN 13 parameters used.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.i2of5convertToEan13
Rho.Barcode.i2of5convertToEan13
Rho::Barcode.i2of5convertToEan13
Specifies the maximum number of allowable characters in a I2of5 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.i2of5maxLength
Rho.Barcode.i2of5maxLength
Rho::Barcode.i2of5maxLength
Specifies the minimum number of allowable characters in a I2of5 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.i2of5minLength
Rho.Barcode.i2of5minLength
Rho::Barcode.i2of5minLength
Sets the I2of5 Redundancy property, if set the barcode must be decoded twice before being accepted. This will slow scanning but improve reliability.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.i2of5redundancy
Rho.Barcode.i2of5redundancy
Rho::Barcode.i2of5redundancy
When true, the barcode check digit(s) will be reported for scanned I2of5 barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.i2of5reportCheckDigit
Rho.Barcode.i2of5reportCheckDigit
Rho::Barcode.i2of5reportCheckDigit
Enables the verification of the I2of5 check digit.
(Not all scanning engines support all symbologies or all symbology properties)
Possible Values (STRING):
Disables verification of the check digit.
Enables the USS format for the check digit.
Enables the OPCC format for the check digit.
Property Access:
myObject.i2of5verifyCheckDigit
Rho.Barcode.i2of5verifyCheckDigit
Rho::Barcode.i2of5verifyCheckDigit
Selects the illumination mode to use.
(Imager / Camera Scanners on Zebra Technologies' devices)
Possible Values (STRING):
Auto-exposure algorithms will decide whether illumination is required or not. Not available on Android.
External illumination is always on.
External illumination is always off.
Property Access:
myObject.illuminationMode
Rho.Barcode.illuminationMode
Rho::Barcode.illuminationMode
The frequency of the device beeper when a barcode is scanned but not successfully decoded. This should be within the range of the beeper but the API will accept values in the range 0 to 65535.
(Scanners on Zebra Technologies' devices)
Default: 2500
Property Access:
myObject.invalidDecodeFrequency
Rho.Barcode.invalidDecodeFrequency
Rho::Barcode.invalidDecodeFrequency
Path to a local wave file to be played when a barcode is scanned but not successfully decoded. This setting overrides the scanner beeper.
(Scanners on Zebra Technologies' devices)
Property Access:
myObject.invalidDecodeSound
Rho.Barcode.invalidDecodeSound
Rho::Barcode.invalidDecodeSound
Allows the user to select inverse 1D barcodes for decoding.
(Scanners on Zebra Technologies' devices. The scanning engine must support inverse barcodes)
Possible Values (STRING):
Inverse 1D symbology decoding is enabled.
Inverse 1D symbology decoding is disabled.
Allows decoding of both positive and inverse 1D symbologies.
Property Access:
myObject.inverse1dMode
Rho.Barcode.inverse1dMode
Rho::Barcode.inverse1dMode
Enables or disables the symbology for Japanese Postal barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.japPostal
Rho.Barcode.japPostal
Rho::Barcode.japPostal
Enables or disables the Klasse Eins laser on time function.
(Laser Scanners on Zebra Technologies' devices)
Property Access:
myObject.klasseEins
Rho.Barcode.klasseEins
Rho::Barcode.klasseEins
Enables or disables the symbology for Korean 3of5 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.korean3of5
Rho.Barcode.korean3of5
Rho::Barcode.korean3of5
Specifies the maximum number of allowable characters in a Korean 3of5 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.korean3of5maxLength
Rho.Barcode.korean3of5maxLength
Rho::Barcode.korean3of5maxLength
Specifies the minimum number of allowable characters in a Korean 3of5 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.korean3of5minLength
Rho.Barcode.korean3of5minLength
Rho::Barcode.korean3of5minLength
Sets Korean 3of5 Redundancy property, if set the barcode must be decoded twice before being accepted. This will slow scanning but improve reliability.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.korean3of5redundancy
Rho.Barcode.korean3of5redundancy
Rho::Barcode.korean3of5redundancy
Controls whether LCD Mode is enabled on the scanner. LCD Mode makes it easier to scan barcodes off of LCD screens (like mobile device screens)
(Scanners on Zebra Technologies' devices)
Default: false
Property Access:
myObject.lcdMode
Rho.Barcode.lcdMode
Rho::Barcode.lcdMode
Describes the linear security level used during decoding. This determines the number of times a barcode must be read before it is decoded. If the successive reads of the barcode do not match, it will not be decoded.
(Scanners on Zebra Technologies' devices)
Possible Values (STRING):
Double redundancy based on redundancy flags and code length. Only applicable to laser scanners, not BlockBuster imager scanners.
Double redundancy if short barcode or Codabar.
Double redundancy for long barcodes, triple for short barcodes.
Double redundancy for all barcodes.
Triple redundancy for all barcodes.
Property Access:
myObject.linearSecurityLevel
Rho.Barcode.linearSecurityLevel
Rho::Barcode.linearSecurityLevel
Set to false to disable scanning when the battery is low/critical or set to true to enable it.
(Scanners on Zebra Technologies' devices)
Default: false
Property Access:
myObject.lowBatteryScan
Rho.Barcode.lowBatteryScan
Rho::Barcode.lowBatteryScan
Enables or disables the symbology for MacroMicroPDF barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.macroMicroPdf
Rho.Barcode.macroMicroPdf
Rho::Barcode.macroMicroPdf
If true, the scanner driver will return the barcode data only after the complete macroMicroPdf sequence has been read. If false, the scanner driver will return each barcode in the macroMicroPdf sequence as it is read.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.macroMicroPdfBufferLabels
Rho.Barcode.macroMicroPdfBufferLabels
Rho::Barcode.macroMicroPdfBufferLabels
If true, MacroMicroPDF barcodes will be converted to MicroPDF codes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.macroMicroPdfConvertToMicroPdf
Rho.Barcode.macroMicroPdfConvertToMicroPdf
Rho::Barcode.macroMicroPdfConvertToMicroPdf
If true, the scanner driver will not complete read requests while in the middle of a macroMicroPdf sequence. Once a macroMicroPdf sequence has been started it must be completed or canceled before the scan driver will complete other read requests.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.macroMicroPdfExclusive
Rho.Barcode.macroMicroPdfExclusive
Rho::Barcode.macroMicroPdfExclusive
If true, the appended info is concatenated to the decoded data before being returned.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.macroMicroPdfReportAppendInfo
Rho.Barcode.macroMicroPdfReportAppendInfo
Rho::Barcode.macroMicroPdfReportAppendInfo
Enables or disables the symbology for Macro PDF barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.macroPdf
Rho.Barcode.macroPdf
Rho::Barcode.macroPdf
When true, the scanner driver will return he barcode data only after the complete macroPdf sequence has been read. If false, the scan driver will return each barcode in the macroPdf sequence as it is read.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.macroPdfBufferLabels
Rho.Barcode.macroPdfBufferLabels
Rho::Barcode.macroPdfBufferLabels
If true, MacroPDF barcodes will be converted to PDF417 codes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.macroPdfConvertToPdf417
Rho.Barcode.macroPdfConvertToPdf417
Rho::Barcode.macroPdfConvertToPdf417
If true, the scanner driver will not complete read requests while in the middle of a macroPdf sequence. Once a macroPdf sequence has been started it must be completed or canceled before the scan driver will complete other read requests.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.macroPdfExclusive
Rho.Barcode.macroPdfExclusive
Rho::Barcode.macroPdfExclusive
Enables or disables the symbology for Matrix 2of5 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.matrix2of5
Rho.Barcode.matrix2of5
Rho::Barcode.matrix2of5
Specifies the maximum number of allowable characters in a Matrix 2of5 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.matrix2of5maxLength
Rho.Barcode.matrix2of5maxLength
Rho::Barcode.matrix2of5maxLength
Specifies the minimum number of allowable characters in a Matrix 2of5 barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.matrix2of5minLength
Rho.Barcode.matrix2of5minLength
Rho::Barcode.matrix2of5minLength
When true, the barcode check digit(s) will be reported for scanned Matrix 2of5 barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.matrix2of5reportCheckDigit
Rho.Barcode.matrix2of5reportCheckDigit
Rho::Barcode.matrix2of5reportCheckDigit
Enables verification of the Matrix 2of5 symbology check digit.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.matrix2of5verifyCheckDigit
Rho.Barcode.matrix2of5verifyCheckDigit
Rho::Barcode.matrix2of5verifyCheckDigit
Enables or disables the symbology for Maxicode barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.maxiCode
Rho.Barcode.maxiCode
Rho::Barcode.maxiCode
Enables or disables the symbology for Micro PDF barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.microPdf
Rho.Barcode.microPdf
Rho::Barcode.microPdf
Enables or disables the symbology for Micro QR barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.microQr
Rho.Barcode.microQr
Rho::Barcode.microQr
Enables or disables the symbology for MSI barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.msi
Rho.Barcode.msi
Rho::Barcode.msi
Specifies the check digit scheme used to verify MSI barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Possible Values (STRING):
The first check digit is MOD 11, the second is MOD 10.
Both check digits are MOD 10.
Property Access:
myObject.msiCheckDigitScheme
Rho.Barcode.msiCheckDigitScheme
Rho::Barcode.msiCheckDigitScheme
Sets the number of MSI check digits to use.
(Not all scanning engines support all symbologies or all symbology properties)
Possible Values (STRING):
Use one check digit for MSI barcodes.
Use two check digits for MSI barcodes.
Property Access:
myObject.msiCheckDigits
Rho.Barcode.msiCheckDigits
Rho::Barcode.msiCheckDigits
Specifies the maximum number of allowable characters in a MSI barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.msiMaxLength
Rho.Barcode.msiMaxLength
Rho::Barcode.msiMaxLength
Specifies the minimum number of allowable characters in a MSI barcode. If your application only expects barcode lengths in a certain range, reducing the allowed range can improve scanning performance. Allowed values are 0 to 55.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.msiMinLength
Rho.Barcode.msiMinLength
Rho::Barcode.msiMinLength
Sets the MSI Redundancy property, if set the barcode must be decoded twice before being accepted. This will slow scanning but improve reliability.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.msiRedundancy
Rho.Barcode.msiRedundancy
Rho::Barcode.msiRedundancy
When true, the barcode check digit(s) will be reported for scanned MSI barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.msiReportCheckDigit
Rho.Barcode.msiReportCheckDigit
Rho::Barcode.msiReportCheckDigit
Enables or disables the symbology for PDF 417 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.pdf417
Rho.Barcode.pdf417
Rho::Barcode.pdf417
Allows the imager to decode only the barcode that is directly under the cross-hair / center of the reticle. This feature is most useful in applications where multiple barcodes may appear in the field of view during a decode session and only one of them is targeted for decode. When enabled picklistMode will override aimMode or, if no aiming is chosen, and use aimMode:reticle. This mode will also interact with viewfinderMode, see the EMDK for C help file for more information. Enabling picklist mode may adversely affect overall decoding performance.
(Imager / Camera Scanners on Zebra Technologies' devices)
Possible Values (STRING):
Disables picklist mode so any barcode within the field of view can be decoded.
Enables picklist mode so that only the barcode under the projected reticle can be decoded. On Windows, if the imager does not support a projected reticle then the behavior is the same as softwareReticle. On Android, this is only supported for Imager (non-viewfinder) based scanners.
Enables picklist mode so that only the barcode in the center of the image is decoded. This is most useful when used in conjunction with static and dynamic reticle viewfinder modes. On Android, this is only supported for Camera (viewfinder) based scanners.
Property Access:
myObject.picklistMode
Rho.Barcode.picklistMode
Rho::Barcode.picklistMode
Allows poor quality 1D barcodes to be read When true, but this will adversely affect the overall decoding performance.
(Imager / Camera Scanners on Zebra Technologies' devices)
Property Access:
myObject.poorQuality1dMode
Rho.Barcode.poorQuality1dMode
Rho::Barcode.poorQuality1dMode
Enables or disables the symbology for QR Code barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.qrCode
Rho.Barcode.qrCode
Rho::Barcode.qrCode
Vertical rastering height to use, as a percentage, when rasterMode:openAlways is applied. This value must be between 0 and 100.
(Laser Scanners on Zebra Technologies' devices)
Property Access:
myObject.rasterHeight
Rho.Barcode.rasterHeight
Rho::Barcode.rasterHeight
Describes the type of vertical rastering to use.
(Scanners on Zebra Technologies' devices)
Possible Values (STRING):
No vertical rastering.
Vertical rastering is always full open. To adjust the rastering height use the rasterHeight property.
Vertical rastering mode is ‘Smart’.
Vertical rastering mode is ‘Cyclone’.
Property Access:
myObject.rasterMode
Rho.Barcode.rasterMode
Rho::Barcode.rasterMode
The remaining capacity of the battery, in the range 0 to 100. ‘unknown’ will be returned if the capacity could not be determined, for example if the scanner had no battery.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmBatteryCapacity
Rho.Barcode.rsmBatteryCapacity
Rho::Barcode.rsmBatteryCapacity
One of ‘simple’, ‘double’, ‘disabled’ or ‘unknown’
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmBatteryId
Rho.Barcode.rsmBatteryId
Rho::Barcode.rsmBatteryId
Indicates the status of the remote scanner’s battery, will be one of ‘unknown’, ‘full’, ‘medium’, ‘empty’, ‘chargingFullRate’, ‘chargingHalfRate’, ‘chargingTrickle’ or ‘discharging’
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmBatteryStatus
Rho.Barcode.rsmBatteryStatus
Rho::Barcode.rsmBatteryStatus
Bluetooth address as FF:FF:FF:FF:FF:FF where FF is a hex number.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmBluetoothAddress
Rho.Barcode.rsmBluetoothAddress
Rho::Barcode.rsmBluetoothAddress
True if authentication is required.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmBluetoothAuthentication
Rho.Barcode.rsmBluetoothAuthentication
Rho::Barcode.rsmBluetoothAuthentication
Bluetooth reconnection scheme.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Possible Values (STRING):
No scheme.
When powered on.
When device goes out of range.
When powered on or when the device goes out of range.
Property Access:
myObject.rsmBluetoothAutoReconnect
Rho.Barcode.rsmBluetoothAutoReconnect
Rho::Barcode.rsmBluetoothAutoReconnect
When true, scanner will emit 5 beeps every 5 seconds whilst re-connection in progress.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmBluetoothBeepOnReconnectAttempt
Rho.Barcode.rsmBluetoothBeepOnReconnectAttempt
Rho::Barcode.rsmBluetoothBeepOnReconnectAttempt
True if encryption is required.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmBluetoothEncryption
Rho.Barcode.rsmBluetoothEncryption
Rho::Barcode.rsmBluetoothEncryption
Friendly Bluetooth name, e.g. ‘MyBTScanner’
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmBluetoothFriendlyName
Rho.Barcode.rsmBluetoothFriendlyName
Rho::Barcode.rsmBluetoothFriendlyName
‘neverReconnect’, ‘reconnectOnData’ or ‘reconnectImmediately’
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmBluetoothHidAutoReconnect
Rho.Barcode.rsmBluetoothHidAutoReconnect
Rho::Barcode.rsmBluetoothHidAutoReconnect
To use a general inquiry mode, ‘general’ else, ‘limited’
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmBluetoothInquiryMode
Rho.Barcode.rsmBluetoothInquiryMode
Rho::Barcode.rsmBluetoothInquiryMode
Up to 5 character PIN code used for Bluetooth authentication.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmBluetoothPinCode
Rho.Barcode.rsmBluetoothPinCode
Rho::Barcode.rsmBluetoothPinCode
‘UseStored’ will use the PIN code stored in the memory of the ring scanner, by default ‘12345’. ‘PromptUser’ indicates that the ring scanner should be used to scan 5 alpha numeric barcodes to define the PIN, eg. “1”, “2”, “3”, “4”, “5” (for PIN 12345). This parameter is not saved permanently on the ring scanner.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmBluetoothPinCodeType
Rho.Barcode.rsmBluetoothPinCodeType
Rho::Barcode.rsmBluetoothPinCodeType
How long the scanner tries to re-establish connection if it goes out of range, in seconds. This value must be a multiple of 5 and in the range 30 to 60 seconds.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmBluetoothReconnectionAttempts
Rho.Barcode.rsmBluetoothReconnectionAttempts
Rho::Barcode.rsmBluetoothReconnectionAttempts
Ring scanner date of manufacture as DDMMYY.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmDateOfManufacture
Rho.Barcode.rsmDateOfManufacture
Rho::Barcode.rsmDateOfManufacture
Ring scanner date of service as DDMMYY.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmDateOfService
Rho.Barcode.rsmDateOfService
Rho::Barcode.rsmDateOfService
If true, the remote scanner beeps and illuminates its green LED on a successful decode.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmDecodeFeedback
Rho.Barcode.rsmDecodeFeedback
Rho::Barcode.rsmDecodeFeedback
The device class of the ring scanner.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmDeviceClass
Rho.Barcode.rsmDeviceClass
Rho::Barcode.rsmDeviceClass
Scanner’s operating system version.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmFirmwareVersion
Rho.Barcode.rsmFirmwareVersion
Rho::Barcode.rsmFirmwareVersion
Force saving the barcode assigned to the device to which the scanner has been paired.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmForceSavePairingBarcode
Rho.Barcode.rsmForceSavePairingBarcode
Rho::Barcode.rsmForceSavePairingBarcode
Delay between good scans in proximity continuous mode, measured in milliseconds. Range 0 to 15000. This value must be a multiple of 100.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmGoodScansDelay
Rho.Barcode.rsmGoodScansDelay
Rho::Barcode.rsmGoodScansDelay
Feature for ignoring Code 128 barcodes beginning with 420 and 421.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmIgnoreCode128Usps
Rho.Barcode.rsmIgnoreCode128Usps
Rho::Barcode.rsmIgnoreCode128Usps
Whether or not the ring scanner should give a low battery indication.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmLowBatteryIndication
Rho.Barcode.rsmLowBatteryIndication
Rho::Barcode.rsmLowBatteryIndication
Low battery indication cycle time, in seconds. Must be one of 15, 30, 60, 90 or 120.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmLowBatteryIndicationCycle
Rho.Barcode.rsmLowBatteryIndicationCycle
Rho::Barcode.rsmLowBatteryIndicationCycle
If you press the trigger on an RSM scanner, proximity enabled will be turned off, even though it still reports its self as being turned on if you query the property. In order to use ProximityEnable you need to also have Mems enabled, this is the motion sensor and if you disable Mems the scanner will not function.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmMems
Rho.Barcode.rsmMems
Rho::Barcode.rsmMems
Ring scanner model number.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmModelNumber
Rho.Barcode.rsmModelNumber
Rho::Barcode.rsmModelNumber
Range 0 to 15 to specify the pattern for the paging beep sequence.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmPagingBeepSequence
Rho.Barcode.rsmPagingBeepSequence
Rho::Barcode.rsmPagingBeepSequence
Specify whether paging the device is enabled.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmPagingEnable
Rho.Barcode.rsmPagingEnable
Rho::Barcode.rsmPagingEnable
Proximity continuous mode.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmProximityContinuous
Rho.Barcode.rsmProximityContinuous
Rho::Barcode.rsmProximityContinuous
Specify the distance for the proximity feature as ‘short’, ‘medium’ or ‘long’
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmProximityDistance
Rho.Barcode.rsmProximityDistance
Rho::Barcode.rsmProximityDistance
If you press the trigger on an RSM scanner, proximity enabled will be turned off, even though it still reports its self as being turned on if you query the property. In order to use ProximityEnable you need to also have Mems enabled, this is the motion sensor and if you disable Mems the scanner will not function.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmProximityEnable
Rho.Barcode.rsmProximityEnable
Rho::Barcode.rsmProximityEnable
The laser scan line width, ‘wide’ or ‘narrow’.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmScanLineWidth
Rho.Barcode.rsmScanLineWidth
Rho::Barcode.rsmScanLineWidth
Scanner trigger will wakeup the device from a low power state.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmScanTriggerWakeup
Rho.Barcode.rsmScanTriggerWakeup
Rho::Barcode.rsmScanTriggerWakeup
Ring scanner serial number.
(Zebra Technologies' Bluetooth barcode scanners, model RS507)
Property Access:
myObject.rsmSerialNumber
Rho.Barcode.rsmSerialNumber
Rho::Barcode.rsmSerialNumber
When the aimType:continuousRead property is applied this value defines the interval between which the same barcode can be decoded twice. The value is specified in milliseconds, use 0 to indicate no interval between successive reads. Use this value to prevent accidental duplicate scans.
(Scanners on Zebra Technologies' devices)
Property Access:
myObject.sameSymbolTimeout
Rho.Barcode.sameSymbolTimeout
Rho::Barcode.sameSymbolTimeout
Maximum time in milliseconds that laser scanners will emit a beam or imager scanners will enable the imager. A value of 0 indicates an infinite timeout. This parameter is compatible with aimType:trigger, aimType:timedHold, aimType:timedRelease and aimType:pressAndRelease. Note that for regulatory reasons scanTimeout is not configurable on all laser/imager scanners.
(Scanners on Zebra Technologies' devices)
Property Access:
myObject.scanTimeout
Rho.Barcode.scanTimeout
Rho::Barcode.scanTimeout
The type of scanner in use, will be one of ‘Camera’, ‘Imager’ or ‘Laser’. Camera scanners capture and process an image taken via the devices camera. Imager scanners rely on capturing and processing an image of the barcode via dedicated scanning hardware. Both camera and imager scanners are capable of decoding 1D and 2D barcodes. Laser scanners are only capable of decoding 1D barcodes and rely on a sweeping laser.
(All Scanners)
Property Access:
myObject.scannerType
Rho.Barcode.scannerType
Rho::Barcode.scannerType
Enables or disables the symbology for Signature barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance. Signature barcodes return their data in Data URI format, it is recommended you adjust the dataBufferSize and barcodeDataFormat properties when scanning Signature barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.signature
Rho.Barcode.signature
Rho::Barcode.signature
Specifies the output height of the captured signature barcode. Signature barcodes return their data in Data URI format, it is recommended you adjust the dataBufferSize and barcodeDataFormat properties when scanning Signature barcodes. Provide a number greater than or equal to 20.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.signatureImageHeight
Rho.Barcode.signatureImageHeight
Rho::Barcode.signatureImageHeight
Specifies the output quality of the captured signature barcode. Signature barcodes return their data in Data URI format, it is recommended you adjust the dataBufferSize and barcodeDataFormat properties when scanning Signature barcodes. Provide a value between 10 and 100 inclusive.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.signatureImageQuality
Rho.Barcode.signatureImageQuality
Rho::Barcode.signatureImageQuality
Specifies the output width of the captured signature barcode. Signature barcodes return their data in Data URI format, it is recommended you adjust the dataBufferSize and barcodeDataFormat properties when scanning Signature barcodes. Provide a number greater than or equal to 20.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.signatureImageWidth
Rho.Barcode.signatureImageWidth
Rho::Barcode.signatureImageWidth
Duration in milliseconds for aimType:timedHold and aimType:timedRelease.
(Scanners on Zebra Technologies' devices)
Property Access:
myObject.timedAimDuration
Rho.Barcode.timedAimDuration
Rho::Barcode.timedAimDuration
Enables or disables the symbology for TLC 39 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.tlc39
Rho.Barcode.tlc39
Rho::Barcode.tlc39
Only applies to an enabled laser or imaging scanner. Disconnecting the trigger will prevent the scan beam from being emitted, this can temporarily prevent a user from scanning without having to disable the scanner, which can take longer. By default the trigger will be connected when the scanner is first enabled, you do not have to connect it separately. Please note that disconnecting the trigger will also prevent the start method from emitting a laser. This property will only affect the scanner and will have no effect on the ‘captureTrigger’ API.
(Scanners on Zebra Technologies' devices)
Default: true
Property Access:
myObject.triggerConnected
Rho.Barcode.triggerConnected
Rho::Barcode.triggerConnected
Enables or disables the symbology for Trioptic 39 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.trioptic39
Rho.Barcode.trioptic39
Rho::Barcode.trioptic39
Sets the Trioptic 39 Redundancy property, if set the barcode must be decoded twice before being accepted. This will slow scanning but improve reliability.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.trioptic39Redundancy
Rho.Barcode.trioptic39Redundancy
Rho::Barcode.trioptic39Redundancy
Enables or disables the symbology for UK Postal barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.ukPostal
Rho.Barcode.ukPostal
Rho::Barcode.ukPostal
When true, the barcode check digit(s) will be reported for scanned UK Postal barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.ukPostalReportCheckDigit
Rho.Barcode.ukPostalReportCheckDigit
Rho::Barcode.ukPostalReportCheckDigit
Enables or disables decoding of UPC EAN Bookland barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upcEanBookland
Rho.Barcode.upcEanBookland
Rho::Barcode.upcEanBookland
Specifies the bookland format to use when decoding UPC EAN Bookland barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Possible Values (STRING):
Causes 978 bookland barcodes to be reported in 10 digit mode.
Causes 978/979 bookland barcodes to be transmitted as EAN13 as per 2007 ISBN-13 protocol.
Property Access:
myObject.upcEanBooklandFormat
Rho.Barcode.upcEanBooklandFormat
Rho::Barcode.upcEanBooklandFormat
If true, RSS barcodes will be converted to UPC/EAN format. For this setting to work UPC/EAN symbologies must be enabled.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upcEanConvertGs1dataBarToUpcEan
Rho.Barcode.upcEanConvertGs1dataBarToUpcEan
Rho::Barcode.upcEanConvertGs1dataBarToUpcEan
Enables or disables decoding of UPC EAN Coupon barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upcEanCoupon
Rho.Barcode.upcEanCoupon
Rho::Barcode.upcEanCoupon
Sets the linear decode property.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upcEanLinearDecode
Rho.Barcode.upcEanLinearDecode
Rho::Barcode.upcEanLinearDecode
When true, enables random weight check digit verification.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upcEanRandomWeightCheckDigit
Rho.Barcode.upcEanRandomWeightCheckDigit
Rho::Barcode.upcEanRandomWeightCheckDigit
Sets the retry count for auto-discriminating for supplementals. The value must be between 2 – 20 inclusive.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upcEanRetryCount
Rho.Barcode.upcEanRetryCount
Rho::Barcode.upcEanRetryCount
Sets the Security level for decoding UPC EAN barcodes and accepts a value between 0 and 3 inclusive. 0: This setting allows the scanner to operate in its most aggressive state, while providing sufficient security in decoding most ‘in-spec’ barcodes. 1: This setting eliminates most mis-decodes. 2: Select this option if security level 1 fails to eliminate mis-decodes. 3: Select this option if security level 1 and 2 fail to eliminate mis-decodes. Be advised that selecting level 3 is an extreme measure against mis-decoding and will significantly impair the decoding ability of the scanner.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upcEanSecurityLevel
Rho.Barcode.upcEanSecurityLevel
Rho::Barcode.upcEanSecurityLevel
When true, enables the supplemental barcode decoding. Note you must have upcEanSupplementalMode:always set for this parameter to take effect.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upcEanSupplemental2
Rho.Barcode.upcEanSupplemental2
Rho::Barcode.upcEanSupplemental2
When true, enables the supplemental barcode decoding. Note you must have upcEanSupplementalMode:always set for this parameter to take effect.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upcEanSupplemental5
Rho.Barcode.upcEanSupplemental5
Rho::Barcode.upcEanSupplemental5
Describes the UPC EAN Supplemental mode.
(Not all scanning engines support all symbologies or all symbology properties)
Possible Values (STRING):
Supplementals are ignored.
Auto-discriminates supplementals.
Will not decode upc/ean without supplementals.
The decoder will return the decoded value of the main block right away if it does not belong to any of the supplemental types. If the barcode starts with one of the prefixes it will search the image more aggressively for a supplemental. The scanner will try to scan the supplemental if it is present but if that fails, the main barcode will be returned.
Auto-discriminates supplemental for upc/ean codes starting with 378 or 379. Will disable reading of supplementals for any other upc/ean barcodes not starting with these values. The supplemental will be scanned if present but if scanning fails then the main barcode will be returned.
Auto-discriminates supplemental for upc/ean codes starting with 978 or 979. Will disable reading of supplementals for any other upc/ean barcodes not starting with these values. The supplemental will be scanned if present but if scanning fails then the main barcode will be returned.
Auto-discriminates supplemental for upc/ean codes starting with 414 or 419 or 434 or 439. Will disable reading of supplementals for any other upc/ean barcodes not starting with these values. The supplemental will be scanned if present but if scanning fails then the main barcode will be returned.
Property Access:
myObject.upcEanSupplementalMode
Rho.Barcode.upcEanSupplementalMode
Rho::Barcode.upcEanSupplementalMode
Enables or disables the symbology for UPCA barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upca
Rho.Barcode.upca
Rho::Barcode.upca
Controls the preamble applied to the UPCA barcode.
(Not all scanning engines support all symbologies or all symbology properties)
Possible Values (STRING):
Applies no preamble to the bar code.
Applies system character preamble to the bar code.
Applies both system and country code preamble to the bar code.
Property Access:
myObject.upcaPreamble
Rho.Barcode.upcaPreamble
Rho::Barcode.upcaPreamble
When true, the barcode check digit(s) will be reported for scanned UPCA barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upcaReportCheckDigit
Rho.Barcode.upcaReportCheckDigit
Rho::Barcode.upcaReportCheckDigit
Enables or disables the symbology for UPCE0 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upce0
Rho.Barcode.upce0
Rho::Barcode.upce0
When true, scanned UPCE0 barcodes will be converted to UPCA and UPCA parameters used.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upce0convertToUpca
Rho.Barcode.upce0convertToUpca
Rho::Barcode.upce0convertToUpca
Controls the preamble applied to the UPCE0 barcode.
(Not all scanning engines support all symbologies or all symbology properties)
Possible Values (STRING):
Applies no preamble to the bar code.
Applies system character preamble to the bar code.
Applies both system and country code preamble to the bar code.
Property Access:
myObject.upce0preamble
Rho.Barcode.upce0preamble
Rho::Barcode.upce0preamble
When true, the barcode check digit(s) will be reported for scanned UPCE0 barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upce0reportCheckDigit
Rho.Barcode.upce0reportCheckDigit
Rho::Barcode.upce0reportCheckDigit
Enables or disables the symbology for UPCE1 barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upce1
Rho.Barcode.upce1
Rho::Barcode.upce1
When true, scanned UPCE1 barcodes will be converted to UPCA and UPCA parameters used.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upce1convertToUpca
Rho.Barcode.upce1convertToUpca
Rho::Barcode.upce1convertToUpca
Controls the preamble applied to the UPCE1 barcode.
(Not all scanning engines support all symbologies or all symbology properties)
Possible Values (STRING):
Applies no preamble to the bar code.
Applies system character preamble to the bar code.
Applies both system and country code preamble to the bar code.
Property Access:
myObject.upce1preamble
Rho.Barcode.upce1preamble
Rho::Barcode.upce1preamble
When true, the barcode check digit(s) will be reported for scanned UPCE1 barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.upce1reportCheckDigit
Rho.Barcode.upce1reportCheckDigit
Rho::Barcode.upce1reportCheckDigit
Enables or disables the symbology for US 4-State barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.us4state
Rho.Barcode.us4state
Rho::Barcode.us4state
Enables or disables the symbology for US 4-State FICS barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.us4stateFics
Rho.Barcode.us4stateFics
Rho::Barcode.us4stateFics
Enables or disables the symbology for US Planet barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.usPlanet
Rho.Barcode.usPlanet
Rho::Barcode.usPlanet
When true, the barcode check digit(s) will be reported for scanned US Planet barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.usPlanetReportCheckDigit
Rho.Barcode.usPlanetReportCheckDigit
Rho::Barcode.usPlanetReportCheckDigit
Enables or disables the symbology for US Post Net barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.usPostNet
Rho.Barcode.usPostNet
Rho::Barcode.usPostNet
When true, the barcode check digit(s) will be reported for scanned US Post Net barcodes.
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.usPostNetReportCheckDigit
Rho.Barcode.usPostNetReportCheckDigit
Rho::Barcode.usPostNetReportCheckDigit
Configures the feedback given after a successful scan. This value is ignored if aimType is set to continuousRead and no feedback will be given.
(Camera Scanners on Zebra Technologies' devices)
Possible Values (STRING):
The last image that was successfully decoded is displayed. The time for which the image is displayed can be configured by the viewfinderFeedbackTime parameter.
No feedback is given in the viewfinder after a successful decode.
The last image that was successfully decoded is displayed along with a red reticle in the center of the image. The time for which the image is displayed can be configured by the viewfinderFeedbackTime parameter.
Property Access:
myObject.viewfinderFeedback
Rho.Barcode.viewfinderFeedback
Rho::Barcode.viewfinderFeedback
If the viewfinderFeedback:enabled or viewfinderFeedback:reticle are applied then the decoded barcode will remain on the screen for this duration. Specified in milliseconds.
(Camera Scanners on Zebra Technologies' devices)
Property Access:
myObject.viewfinderFeedbackTime
Rho.Barcode.viewfinderFeedbackTime
Rho::Barcode.viewfinderFeedbackTime
When scanning a barcode using a Camera scanner the viewfinder preview window will be this number of pixels in height. The images displayed in the viewfinder will be scaled as appropriate.
(Camera Scanners on Zebra Technologies' devices)
Property Access:
myObject.viewfinderHeight
Rho.Barcode.viewfinderHeight
Rho::Barcode.viewfinderHeight
Configures the mode of the scanner viewfinder window. This attribute is not supported on all Scanners and will interact with the picklistMode parameter, see the EMDK for C help file for more information.
(Camera Scanners on Zebra Technologies' devices)
Possible Values (STRING):
Only the viewfinder is enabled (not the reticle). Displays a viewfinder on the screen showing the image being captured by the camera.
The viewfinder will not be displayed during aiming or scanning.
Displays the viewfinder as well as draws a red reticle in the center of the image which helps with tracking the barcode.
Displays the viewfinder as well as draws a red reticle in the center of the image. If the barcode in the image is ‘decodable’ the reticle turns green to indicate this. This mode requires a second trigger press to decode the barcode after the reticle turns green. Not supported on Android.
Property Access:
myObject.viewfinderMode
Rho.Barcode.viewfinderMode
Rho::Barcode.viewfinderMode
When scanning a barcode using a Camera scanner the viewfinder preview window will be this number of pixels wide. The images displayed in the viewfinder will be scaled as appropriate.
(Camera Scanners on Zebra Technologies' devices)
Property Access:
myObject.viewfinderWidth
Rho.Barcode.viewfinderWidth
Rho::Barcode.viewfinderWidth
When scanning a barcode using a Camera scanner the viewfinder preview window will appear this number of pixels from the left hand side of the screen. The images displayed in the viewfinder will be scaled as appropriate.
(Camera Scanners on Zebra Technologies' devices)
Property Access:
myObject.viewfinderX
Rho.Barcode.viewfinderX
Rho::Barcode.viewfinderX
When scanning a barcode using a Camera scanner the viewfinder preview window will appear this number of pixels from the top of the screen. The images displayed in the viewfinder will be scaled as appropriate.
(Camera Scanners on Zebra Technologies' devices)
Property Access:
myObject.viewfinderY
Rho.Barcode.viewfinderY
Rho::Barcode.viewfinderY
Enables or disables the symbology for Webcode barcodes. If your application does not expect to scan this symbology you should disable it to improve scanning performance. Deprecated in Android 4.1 (Jelly Bean).
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.webcode
Rho.Barcode.webcode
Rho::Barcode.webcode
If true, the GT Webcode subtype will be decoded. Deprecated in Android 4.1 (Jelly Bean).
(Not all scanning engines support all symbologies or all symbology properties)
Property Access:
myObject.webcodeDecodeGtSubtype
Rho.Barcode.webcodeDecodeGtSubtype
Rho::Barcode.webcodeDecodeGtSubtype
Getting started with barcode scanning is very straightforward. If you do not need to customize the defaults, you need very little code.
function scan_using_default_scanner(){ // Scan with default options Rho.Barcode.take({}, scan_received); } function scan_received(params) // Did we actually find a barcode ? // If status is not 'ok', the scan was canceled if (params["status"]=="ok") { alert('Barcode scanning complete. Scanned barcode: '+params["barcode"]); } else { alert('Barcode scanning aborted'); } Rho.Barcode.stop(); }
def scan_using_default_scanner # Scan with default options Rho::Barcode.take({}, url_for(:action => :scan_received)) end def scan_received # Did we actually find a barcode ? # If status is not 'ok', the scan was canceled if @params["status"] == "ok" Rho::Log.info(@params["barcode"],"Barcode result") else Rho::Log.info("canceled", "Barcode result") end end
By default, Rho::Barcode will select a hardware scanner if present on the device. If you want to let the user choose which scanner to use at any particular time, you must enumerate the available scanners and select one from the set.
var scanners; function choose_scanner(){ // Enumerate returns an array of scanner objects // Devices without a hardware scanner will return a software-based recognizer scanners = Rho.Barcode.enumerate(); } function scan_using_chosen_scanner(scanner_index) { var scanner = scanners[scanner_index]; scanner.take({}, scan_received_callback); } function scan_received_callback(params) { // Did we actually find a barcode ? // If status is not 'ok', the scan was canceled if (params["status"]=="ok") { alert('Barcode scanning complete. Scanned barcode: '+params["barcode"]); } else { alert('Barcode scanning aborted'); } Rho.Barcode.stop(); }
# --------------- # controller.rb # --------------- def choose_scanner # Obtain list of available scanners on the system. Devices without a hardware scanner will return a software-based recognizer $scanners = Rho::Barcode.enumerate render end def scan_using_chosen_scanner # receive an integer as parameter, which represent the number of the scanner we wish to use scanner = $scanners[@params["scannerIndex"].to_i] scanner.take({}, url_for(:action => :scan_received_callback)) end def scan_received_callback # Did we actually find a barcode ? # If status is not 'ok', the scan was canceled if @params["status"] == "ok" Rho::Log.info(@params["barcode"],"Barcode result") else Rho::Log.info("canceled", "Barcode result") end end # --------------- # choose_scanner.erb # --------------- <ul data-role="listview"> <% $scanners.each_with_index do |scanner, index| %> <li><a href="<%= url_for(:action => :scan_using_chosen_scanner, :query => {:scanner_index => index}) %>"><%= scanner.friendlyName %></li> <% end %> </ul>
Specify which symbologies the barcode scanner must recognize.
// For the purpose of this example, let's say our application only needs to recognize one type of barcode. // In that case, we will disable all decoders... Rho.Barcode.allDecoders = false; // ... and enable only the one we are interested in: Rho.Barcode.upca = true; // All other barcode symbologies will be ignored Rho.Barcode.take({}, scan_received_callback);
# For the purpose of this example, let's say our application only needs to recognize one type of barcode. # In that case, we will disable all decoders... Rho::Barcode.allDecoders = false # ... and enable only the one we are interested in: Rho::Barcode.upca = true # All other barcode symbologies will be ignored Rho::Barcode.take({}, url_for(:action => :scan_received_callback))
Examples of setting barcode scanner properties.
// There are over 200 properties to fine-tune the barcode scanner functionality and adapt it to suit your application. // Almost all properties depend on the scanner hardware for support, please check the documentation to see if your device // supports a particular setting // Here are examples of setting some of the properties. The documentation lists the acceptable values for each of them // Aiming mode (visual cue): Rho.Barcode.aimMode = "none"; Rho.Barcode.aimMode = "dot"; Rho.Barcode.aimMode = "slab"; Rho.Barcode.aimMode = "reticle"; // Aiming type (processing mode): Rho.Barcode.aimType = "trigger"; Rho.Barcode.aimType = "timedHold"; Rho.Barcode.aimType = "timedRelease"; Rho.Barcode.aimType = "presentation"; Rho.Barcode.aimType = "pressAndRelease"; Rho.Barcode.aimType = "continuousRead"; // Generate an "Enter" keypress after a barcode is recognized. Useful for sending forms automatically after a scan Rho.Barcode.autoEnter = true; // Select the beam width of the scanner (only supported on some devices) Rho.Barcode.beamWidth = "normal"; Rho.Barcode.beamWidth = "narrow"; Rho.Barcode.beamWidth = "wide";
# There are over 200 properties to fine-tune the barcode scanner functionality and adapt it to suit your application. # Almost all properties depend on the scanner hardware for support, please check the documentation to see if your device # supports a particular setting # Here are examples of setting some of the properties. The documentation lists the acceptable values for each of them # Aiming mode (visual cue): Rho::Barcode.aimMode = "none" Rho::Barcode.aimMode = "dot" Rho::Barcode.aimMode = "slab" Rho::Barcode.aimMode = "reticle" # Aiming type (processing mode): Rho::Barcode.aimType = "trigger" Rho::Barcode.aimType = "timedHold" Rho::Barcode.aimType = "timedRelease" Rho::Barcode.aimType = "presentation" Rho::Barcode.aimType = "pressAndRelease" Rho::Barcode.aimType = "continuousRead" # Generate an "Enter" keypress after a barcode is recognized. Useful for sending forms automatically after a scan Rho::Barcode.autoEnter = true # Select the beam width of the scanner (only supported on some devices) Rho::Barcode.beamWidth = "normal" Rho::Barcode.beamWidth = "narrow" Rho::Barcode.beamWidth = "wide"
You can customize or eliminate the beep that the device emits when a barcode is recognized. Support and valid ranges for these values depend on the device.
// Maximum volume (default) Rho.Barcode.decodeVolume = 5; // Low-pitched sound Rho.Barcode.decodeFrequency = 1000; // One-second long Rho.Barcode.decodeDuration = 1000; Rho.Barcode.take({}, scan_received_callback);
# Maximum volume (default) Rho::Barcode.decodeVolume = 5 # Low-pitched sound Rho::Barcode.decodeFrequency = 1000 # One-second long Rho::Barcode.decodeDuration = 1000 Rho::Barcode.take({}, url_for(:action => :scan_received_callback))
Once associated with the Device a Bluetooth Scanner will remain associated even after losing the BT connection. In order to associate a different Bluetooth scanner with the device it is necessary to scan the ‘unpairing’ barcode and then invoke the ‘disabled’ method followed by the ‘enabled’ method, this will allow you to scan the BT association barcode with a different scanner. You can override this default behavior using the disconnectBtOnDisable property.
The following messages will be received from the Bluetooth Scanner in the bluetoothStatus event:
‘BTScanAssociationBarcode’ Means the device is ready to be associated with a BT scanner. You must scan the association barcode. It is only necessary to scan the association barcode when you first associate a scanner with the device, this pairing will be remembered until you scan the unpairing barcode.
‘BluetoothConnected’ The remote scanner has successfully connected to the device.
‘BluetoothDisconnected’ The remote scanner has become disconnected from the device, this may be due to loss of battery, being out of range or scanning the ‘unpairing’ barcode. The scanner will attempt to reconnect automatically for a period of time once it regains power or goes out of range, if it fails to reconnect after the specified timeout the reconnect button on the device should be pushed. Once the unpairing barcode is scanned it is necessary to disable the scanner and then re-enable it before another scanner can be associated.
On Zebra Technologies' scanners the scanner viewfinder window is not infinitely resizable, when setting ViewFinderX, ViewFinderY, ViewFinderWidth and ViewFinderHeight ensure you do not exceed the size of the screen and it is recommended to use the same aspect ratio as your device. For applications designed to handle screen rotation it is recommended to use a scan window whose longest side will fit within both the screen width and screen height. If your viewfinder position fails to be applied it is recommended you query your log file to see which parameter is causing trouble, or reposition the window away from the edges of the screen.
In some device configurations the scanner and camera share the same hardware. Where two modules share the same physical hardware they cannot be enabled simultaneously, in this circumstance once the scanner is enabled it must be disabled before the camera can be used, and vice versa.
On WM/CE, it is first necessary to enable the scanner before most of the properties can be retrieved. The case of scanner properties will differ across platforms. In WM/CE, some of the scanner properties are not exposed to set but can be retrieved. In Android, only supported scanner properties can be retrieved in “getAllProperties” method.
In order to use the scanner with RhoElements Native Apps you will need to either disable DataWedge or create a DataWedge profile for your app.
Disabling Datawedge
RhoElements Datawedge Profile