Symbology Settings#

Defined in package com.scandit.datacapture.barcode.capture

SymbologySettings#
class SymbologySettings

Added in version 6.0.0

Settings specific to a particular barcode symbology.

Learn more on how to use symbology settings in our Configure Which Barcodes Are Read guide.

symbology#
Symbology getSymbology()

Added in version 6.4.0

The symbology that this symbology settings affect.

isEnabled#
boolean isEnabled()
void setEnabled(boolean value)

Added in version 6.0.0

By default decoding of all symbologies is disabled. To enable decoding of a symbology, set this property to true. It is advised to only enable symbologies that are required by the application as every enabled symbology adds processing overhead.

This property only enables decoding of dark codes on bright background. If color-inverted (bright on dark) codes for this symbology are required, enable them by changing the isColorInvertedEnabled property.

isColorInvertedEnabled#
boolean isColorInvertedEnabled()
void setColorInvertedEnabled(boolean value)

Added in version 6.0.0

Determines whether decoding of color-inverted (bright on dark) codes for this symbology is enabled. By default, decoding of color inverted codes is disabled. Currently, the isEnabled property will also have to be set to true for bright on dark codes to be scanned, though this may change in a future release.

checksums#
@NonNull EnumSet<Checksum> getChecksums()
void setChecksums(@NonNull EnumSet<Checksum> value)

Added in version 6.0.0

Set of optional checksums to be used for this symbology. The code is accepted if any of the checksums matches in addition to any mandatory checksum of the symbology.

enabledExtensions#
@NonNull Set<@NonNull String> getEnabledExtensions()

Added in version 6.0.0

The set of enabled extensions of this symbology. Extensions allow to configure features that are specific to a small number of symbologies. For example, there is an extension to configure how to treat the leading zero for UPC-A codes. For a list of supported extensions, refer to Symbology Properties.

activeSymbolCounts#
@NonNull Set<@NonNull Short> getActiveSymbolCounts()
void setActiveSymbolCounts(@NonNull Set<@NonNull Short> value)

Added in version 6.0.0

This property determines the active symbol counts of the symbology, e.g. the supported length of barcodes to be decoded. Change this property to include symbol counts that are not enabled by default, or to optimize decoding performance for a certain number of symbols.

The mapping from characters to symbols is symbology-specific. For some symbologies, the start and end characters are included, others include checksums characters in the symbol counts.

The active symbol count setting is ignored for fixed-size barcodes (the EAN and UPC family of codes) as well as 2d codes. For other symbologies, refer to Symbology Properties.

When changing the active symbol count, the provided active symbol count values are intersected with the supported active symbol count values of the symbology. Values that are not part of the supported symbol count range are ignored.

setExtensionEnabled(extension, enabled)#
void setExtensionEnabled(@NonNull String extension,
        boolean enabled)

Added in version 6.0.0

Activates/Deactivates a custom extension for the symbology.

isExtensionEnabled(extension)#
boolean isExtensionEnabled(@NonNull String extension)

Added in version 6.0.0

Checks if the extension is enabled.

toJson()#
@NonNull String toJson()

Added in version 6.4.0