Text Capture Settings#

Defined in namespace Scandit.Datacapture.Text

TextCaptureSettings#
class TextCaptureSettings

Added in version 6.5.0

Loads the text capture configuration and holds all the text recognition related settings, such as text selection area. To use the settings, use them when creating a text capture instance.

FromJson()#
static TextCaptureSettings FromJson(string jsonData)

Added in version 6.5.0

Construct a new text capture settings with the provided JSON string. The JSON contains the necessary configuration for the text capture back-end.

For details about the format of the JSON check Text Capture Settings’s JSON Structure.

DuplicateFilter#
TimeSpan DuplicateFilter { get;set; }

Added in version 6.5.0

Determines the time interval in which captured texts with the same value are filtered out as duplicates. By default, when the same text is captured in consecutive frames, it is reported again as a new recognition. Use this property to change the interval or completely turn off duplicate filtering:

  • Setting this property to value smaller than zero, means that the same text will not be reported again until the capturing session has been stopped.

  • Setting this property to a value of zero means that the same text will be reported every time it is found.

  • Setting this property to a value larger than zero indicates the time that must pass between the same text to be reported again.

LocationSelection#
ILocationSelection LocationSelection { get;set; }

Added in version 6.5.0

Defines the strategy with which to select one out of many visible texts. See Scan Area Guide. By default, this property is null and text selection is disabled.

RecognitionDirection#
Direction RecognitionDirection { get;set; }

Added in version 6.5.0

The recognition direction tells text capture in what direction text is expected.

SetProperty()#
void SetProperty(string name, object value)

Added in version 6.5.0

Sets a property to the provided value. Use this method to set properties that are not yet part of a stable API. Properties set through this method may change in a future release.

GetProperty()#
object GetProperty(string name)

Added in version 6.5.0

Retrieves the value of a previously set property. In case the property does not exist, null is returned. Use this method to get properties that are not yet part of a stable API. These properties may change in a future release.

GetProperty()#
T GetProperty<T>(string name)

Added in version 6.5.0

Retrieves the value of a previously set property. In case the property does not exist, an ArgumentException is thrown.

TryGetProperty()#
bool TryGetProperty<T>(string name, out T result)

Added in version 6.5.0

The non-throwing version of the method GetProperty(). It retrieves the value of a previously set property as the second passed argument and returns true. In case the property does not exist, false will be returned.

UpdateFromJson()#
void UpdateFromJson(string jsonData)

Added in version 6.5.0

Updates the settings according to a JSON serialization. See Serialization for details.