Barcode Capture Overlay

Defined in framework ScanditBarcodeCapture

SDCBarcodeCaptureOverlayStyle

Added in version 6.10.0

The style of the SDCBarcodeCaptureOverlay.

SDCBarcodeCaptureOverlayStyleLegacy

Added in version 6.10.0

Legacy style from versions before 6.10.

SDCBarcodeCaptureOverlayStyleFrame

Added in version 6.10.0

Style that draws the highlights as a rectangular frame and adds an animation for when a code is scanned.

SDCBarcodeCaptureOverlay

@interface SDCBarcodeCaptureOverlay : NSObject <SDCDataCaptureOverlay>

Added in version 6.0.0

Overlay for the SDCBarcodeCapture capture mode that displays recognized barcodes on top of a data capture view.

The appearance of the visualized barcodes can be configured or turned off completely through the brush property.

+ overlayWithBarcodeCapture:forDataCaptureView:

+ (instancetype)overlayWithBarcodeCapture:(nonnull SDCBarcodeCapture *)barcodeCapture
                       forDataCaptureView:(nullable SDCDataCaptureView *)view

Added in version 6.0.0

Constructs a new barcode capture overlay for the provided barcode capture instance. When passing a non-nil view instance, the overlay is automatically added to the view.

+ overlayWithBarcodeCapture:forDataCaptureView:withStyle:

+ (instancetype)overlayWithBarcodeCapture:(nonnull SDCBarcodeCapture *)barcodeCapture
                       forDataCaptureView:(nullable SDCDataCaptureView *)view
                                withStyle:(SDCBarcodeCaptureOverlayStyle)style

Added in version 6.10.0

Constructs a new barcode capture overlay for the provided barcode capture instance and style. When passing a non-nil view instance, the overlay is automatically added to the view.

+ barcodeCaptureOverlayFromJSONString:mode:error:

+ (nullable instancetype)barcodeCaptureOverlayFromJSONString:(nonnull NSString *)JSONString
                                                        mode:(nonnull SDCBarcodeCapture *)mode
                                                       error:(NSError **)error

Added in version 6.0.0

Constructs a new barcode capture overlay with the provided JSON serialization. See Serialization for details.

For the overlay to be displayed on screen, it must be added to a SDCDataCaptureView.

+ overlayWithBarcodeCapture:

+ (instancetype)overlayWithBarcodeCapture:(nonnull SDCBarcodeCapture *)barcodeCapture

Added in version 6.0.0

Constructs a new barcode capture overlay for the provided barcode capture instance. For the overlay to be displayed on screen, it must be added to a SDCDataCaptureView.

+ overlayWithBarcodeCapture:withStyle:

+ (instancetype)overlayWithBarcodeCapture:(nonnull SDCBarcodeCapture *)barcodeCapture
                                withStyle:(SDCBarcodeCaptureOverlayStyle)style

Added in version 6.10.0

Constructs a new barcode capture overlay for the provided barcode capture instance and style. For the overlay to be displayed on screen, it must be added to a SDCDataCaptureView.

viewfinder

@property (nonatomic, strong, nullable) id<SDCViewfinder> viewfinder

Added in version 6.0.0

Set the viewfinder. By default, the viewfinder is nil. Set this to an instance of SDCViewfinder if you want to draw a viewfinder.

brush

@property (nonatomic, strong, nonnull) SDCBrush *brush

Added in version 6.0.0

The brush used for visualizing a recognized barcode in the UI. To turn off drawing of locations, set the brush to use both a transparent fill and stroke color. By default, the brush has a transparent fill color, a “Scandit”-blue stroke color, and a stroke width of 1.

defaultBrush

@property (class, nonatomic, nonnull, readonly) SDCBrush *defaultBrush

Added in version 6.0.0

Returns the default brush used by the overlay.

Deprecated since version 6.10.0: The defaultBrush of the overlay depends on the style used, there is no unique default brush. Use defaultBrushForStyle: instead.

+ defaultBrushForStyle:

+ (nonnull SDCBrush *)defaultBrushForStyle:(SDCBarcodeCaptureOverlayStyle)style

Added in version 6.10.1

Returns the default brush for the given style.

shouldShowScanAreaGuides

@property (nonatomic, assign) BOOL shouldShowScanAreaGuides

Added in version 6.0.0

Whether to show scan area guides on top of the preview. This property is useful during development to visualize the current scan areas on screen. It is not meant to be used for production. By default this property is NO.

- updateFromJSONString:error:

- (BOOL)updateFromJSONString:(nonnull NSString *)JSONString
                       error:(NSError **)error

Added in version 6.0.0

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

- setValue:forProperty:

- (void)setValue:(nullable id)value
     forProperty:(nonnull NSString *)property

Added in version 6.0.0

Set barcode capture overlay 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 or may not be used or change in a future release.

style

@property (nonatomic, readonly) SDCBarcodeCaptureOverlayStyle style

Added in version 6.10.0

The overlay style. Defaults to Legacy.

NSStringFromBarcodeCaptureOverlayStyle(overlayStyle)

NSString *_Nonnull NSStringFromBarcodeCaptureOverlayStyle(SDCBarcodeCaptureOverlayStyle overlayStyle)

Added in version 6.10.0

Returns the string representation of the overlay style.

SDCBarcodeCaptureOverlayStyleFromJSONString(JSONString, overlayStyle)

BOOL SDCBarcodeCaptureOverlayStyleFromJSONString(NSString *_Nonnull JSONString, SDCBarcodeCaptureOverlayStyle *_Nonnull overlayStyle)

Added in version 6.10.0

Creates the overlay style from its string representation