Skip to main content

Core Concepts

This page gives an overview of the core concepts and terms used in the Scandit Data Capture SDK.

All of these concepts are implemented as classes or protocols in the ScanditCaptureCore framework and are used by the frameworks that build on it to implement the data capture capabilities such as barcode reading.

Data Capture Context

The data capture context is the central object that orchestrates the data capture and recognition tasks.

It is the object that links all of the different components together. Its main responsibilities are managing and verifying the license key, scheduling when data capture modes process frames, and defining the frame source to be used for recognition. The context itself acts as a scheduler, but does not provide any interfaces for configuring data capture capabilities.

Configuration and result handling is handled by the data capture modes directly.

Relevant classes: SDCDataCaptureContext, SDCDataCaptureMode

Data Capture View

Typically a SDCDataCaptureView is used to visualize the ongoing data capture process on screen together with one or more overlays. However it’s also possible to use the data capture context without a view to perform off-screen processing.

Relevant classes: SDCDataCaptureView, SDCDataCaptureOverlay

Frame Source

The data capture context performs recognition on images (frames).

These images are provided to the context through classes that conform to the frame source protocol. Most applications will use images coming from one of the built-in cameras of the device as implemented by the camera class.

Relevant classes: SDCFrameSource, SDCFrameData, SDCCamera

Data Capture Mode

Recognition capabilities are added to the data capture context through registering one or more data capture modes.

A capture mode is responsible for one particular type of data capture, e.g. capturing barcodes, or tracking barcodes. The mode manages the settings and allows to configure what exactly gets captured, for example in the case of barcode capture, it allows to configure the symbologies of the barcodes to be captured.

Each of the data capture modes follows the same basic structure and is made up of the same building blocks described below.

Relevant classes: SDCDataCaptureMode, SDCBarcodeCapture, SDCBarcodeTracking

Capture Mode Settings

Capture modes are configured through settings.

Settings are specific to each data capture mode and allow to configure the data that is captured. For example, for barcode capture and barcode tracking, the settings allow to configure which symbologies are enabled. Settings are applied to the capture mode, which is when they take effect.

Relevant classes: SDCBarcodeCaptureSettings, SDCBarcodeTrackingSettings

Capture Mode Listeners

Data capture events, such as when a new barcode has been recognized, are propagated to the user of the API through listeners added to the capture mode.

Capture modes allow an arbitrary number of listeners to be registered.

Relevant classes: SDCBarcodeCaptureListener, SDCBarcodeTrackingListener

Capture Mode Sessions

The captured data, such as the list of captured barcodes is available to the event callbacks through a session object.

The session object is only safe to be accessed from the event callbacks themselves and should not be passed to other threads.

Relevant classes: SDCBarcodeCaptureSession, SDCBarcodeTrackingSession

Overlays

Each of the capture modes has one or more overlays that visualize the ongoing data capturing process.

These overlays are added to the data capture view.

Relevant classes: SDCDataCaptureOverlay, SDCBarcodeCaptureOverlay, SDCBarcodeTrackingBasicOverlay