Deprecation warning

Please note that this is outdated documentation for an older release of the Scandit Barcode Scanner SDK.

We are deprecating the 5.x API on all platforms (except Linux). Release 5.19 in April 2021 will be our final. Applications running 5.x will continue to work, and we will continue to release critical bug fixes and security patches only, for one year. We encourage you to migrate to 6.x and take advantage of our latest / advanced features and improved performance.

You'll find the updated documentation at: Data Capture SDK Documentation for iOS

SBSOverlayController.h
Go to the documentation of this file.
1 //
2 // SBSOverlayController.h
3 // ScanditBarcodeScanner
4 //
5 // Created by Marco Biasini on 09/06/15.
6 // Copyright (c) 2015 Scandit AG. All rights reserved.
7 //
8 
9 #import <Foundation/Foundation.h>
10 
26 #import <UIKit/UIKit.h>
27 #import "AudioToolbox/AudioServices.h"
28 
29 #import "SBSCommon.h"
30 
32 @class SBSBarcodePicker;
33 
40 
53 - (void)overlayController:(nonnull SBSOverlayController *)overlayController
54  didCancelWithStatus:(nullable NSDictionary *)status;
55 
56 @end
57 
71 
82 
84 
85 
103 @interface SBSOverlayController : UIViewController
104 
105 
111 @property (nullable, nonatomic, strong, readonly) UIToolbar *toolBar;
112 
118 @property (nullable, nonatomic, weak) id<SBSOverlayControllerDidCancelDelegate> cancelDelegate;
119 
128 @property (nonatomic, assign) SBSGuiStyle guiStyle;
129 
133 
145 - (void)setBeepEnabled:(BOOL)enabled;
146 
157 - (void)setVibrateEnabled:(BOOL)enabled;
158 
175 - (BOOL)setScanSoundResource:(nonnull NSString *)path ofType:(nonnull NSString *)extension;
177 
178 
182 
194 - (void)setTorchEnabled:(BOOL)enabled;
195 
208 - (BOOL)setTorchOnImage:(nonnull UIImage *)torchOnImage
209  pressed:(nonnull UIImage *)torchOnPressedImage SBS_SWIFT_NAME(setTorchOnImage(torchOnImage:torchOnPressedImage:));
210 
229 - (BOOL)setTorchOnImageResource:(nonnull NSString *)fileName
230  pressedResource:(nonnull NSString *)pressedFileName
231  ofType:(nonnull NSString *)extension;
232 
245 - (BOOL)setTorchOffImage:(nonnull UIImage *)torchOffImage
246  pressed:(nonnull UIImage *)torchOffPressedImage SBS_SWIFT_NAME(setTorchOffImage(torchOffImage:torchOffPressedImage:));
247 
264 - (BOOL)setTorchOffImageResource:(nonnull NSString *)fileName
265  pressedResource:(nonnull NSString *)pressedFileName
266  ofType:(nonnull NSString *)extension;
267 
280 - (void)setTorchButtonLeftMargin:(float)leftMargin
281  topMargin:(float)topMargin
282  width:(float)width
283  height:(float)height SBS_SWIFT_NAME(setTorchButton(leftMargin:topMargin:width:height:));
284 
297 - (void)setTorchOffButtonAccessibilityLabel:(nonnull NSString *)label
298  hint:(nonnull NSString *)hint;
299 
312 - (void)setTorchOnButtonAccessibilityLabel:(nonnull NSString *)label
313  hint:(nonnull NSString *)hint;
314 
316 
317 
321 
334 - (void)setCameraSwitchVisibility:(SBSCameraSwitchVisibility)visibility;
335 
348 - (BOOL)setCameraSwitchImage:(nonnull UIImage *)cameraSwitchImage
349  pressed:(nonnull UIImage *)cameraSwitchPressedImage;
350 
369 - (BOOL)setCameraSwitchImageResource:(nonnull NSString *)fileName
370  pressedResource:(nonnull NSString *)pressedFileName
371  ofType:(nonnull NSString *)extension;
372 
388 - (void)setCameraSwitchButtonRightMargin:(float)rightMargin
389  topMargin:(float)topMargin
390  width:(float)width
391  height:(float)height SBS_SWIFT_NAME(setCameraSwitchButton(rightMargin:topMargin:width:height:));
392 
406 - (void)setCameraSwitchButtonBackAccessibilityLabel:(nonnull NSString *)label
407  hint:(nonnull NSString *)hint;
408 
422 - (void)setCameraSwitchButtonFrontAccessibilityLabel:(nonnull NSString *)label
423  hint:(nonnull NSString *)hint;
424 
426 
427 
431 
441 - (void)setTextRecognitionSwitchVisible:(BOOL)visible;
443 
444 
448 
464 - (void)drawViewfinder:(BOOL)draw SBS_DEPRECATED;
465 
486 - (void)setViewfinderHeight:(float)h
487  width:(float)w
488  landscapeHeight:(float)lH
489  landscapeWidth:(float)lW SBS_SWIFT_NAME(setViewfinder(height:width:landscapeHeight:landscapeWidth:));
490 
509 - (void)setViewfinderPortraitWidth:(float)w
510  height:(float)h SBS_SWIFT_NAME(setViewfinderPortrait(width:height:));
511 
512 
531 - (void)setViewfinderLandscapeWidth:(float)w
532  height:(float)h SBS_SWIFT_NAME(setViewfinderLandscape(width:height:));
533 
547 - (void)setViewfinderColor:(float)r green:(float)g blue:(float)b SBS_SWIFT_NAME(setViewfinderColor(red:green:blue:));
548 
562 - (void)setViewfinderDecodedColor:(float)r green:(float)g blue:(float)b SBS_SWIFT_NAME(setViewfinderDecodedColor(red:green:blue:));
563 
564 
573 - (void)resetUI;
575 
576 
580 
589 - (void)showToolBar:(BOOL)show;
590 
600 - (void)setToolBarButtonCaption:(nonnull NSString *)caption;
602 
603 
607 
620 - (void)setMissingCameraPermissionInfoText:(nonnull NSString *)infoText;
622 
631 - (void)setMatrixScanHighlightingColor:(nonnull UIColor *)color forState:(SBSMatrixScanHighlightingState)state;
632 
633 @end
634 
Definition: SBSOverlayController.h:66
Controls the camera and orchestrates the barcode scanning process.
Definition: SBSBarcodePicker.h:118
SBSMatrixScanHighlightingState
Definition: SBSOverlayController.h:77
controls the scan screen user interface.
Definition: SBSOverlayController.h:103
Definition: SBSOverlayController.h:78
Definition: SBSOverlayController.h:80
UIToolbar * toolBar
The tool bar that can be shown at the bottom of the scan screen.
Definition: SBSOverlayController.h:111
Definition: SBSOverlayController.h:67
Definition: SBSOverlayController.h:64
#define SBS_ENUM_END(name)
Definition: SBSCommon.h:17
SBSGuiStyle
Enumeration of different GUI styles.
Definition: SBSCommon.h:114
id< SBSOverlayControllerDidCancelDelegate > cancelDelegate
The overlay controller delegate that handles the didCancelWithStatus callback.
Definition: SBSOverlayController.h:118
Definition: SBSOverlayController.h:69
SBSGuiStyle guiStyle
The GUI style drawn to display the indicator where the code should be scanned and the visualization o...
Definition: SBSOverlayController.h:128
void resetUI()
Resets the scan screen user interface to its initial state.
#define SBS_DEPRECATED
Definition: SBSCommon.h:9
Protocol cancel events.
Definition: SBSOverlayController.h:39
Definition: SBSOverlayController.h:68
Definition: SBSOverlayController.h:79
Definition: SBSOverlayController.h:65
SBSCameraSwitchVisibility
Definition: SBSOverlayController.h:63
#define SBS_ENUM_BEGIN(name)
Definition: SBSCommon.h:16