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 
73 
74 
92 @interface SBSOverlayController : UIViewController
93 
94 
100 @property (nullable, nonatomic, strong, readonly) UIToolbar *toolBar;
101 
107 @property (nullable, nonatomic, weak) id<SBSOverlayControllerDidCancelDelegate> cancelDelegate;
108 
117 @property (nonatomic, assign) SBSGuiStyle guiStyle;
118 
122 
134 - (void)setBeepEnabled:(BOOL)enabled;
135 
146 - (void)setVibrateEnabled:(BOOL)enabled;
147 
164 - (BOOL)setScanSoundResource:(nonnull NSString *)path ofType:(nonnull NSString *)extension;
166 
167 
171 
183 - (void)setTorchEnabled:(BOOL)enabled;
184 
197 - (BOOL)setTorchOnImage:(nonnull UIImage *)torchOnImage
198  pressed:(nonnull UIImage *)torchOnPressedImage;
199 
218 - (BOOL)setTorchOnImageResource:(nonnull NSString *)fileName
219  pressedResource:(nonnull NSString *)pressedFileName
220  ofType:(nonnull NSString *)extension;
221 
234 - (BOOL)setTorchOffImage:(nonnull UIImage *)torchOffImage
235  pressed:(nonnull UIImage *)torchOffPressedImage;
236 
253 - (BOOL)setTorchOffImageResource:(nonnull NSString *)fileName
254  pressedResource:(nonnull NSString *)pressedFileName
255  ofType:(nonnull NSString *)extension;
256 
269 - (void)setTorchButtonLeftMargin:(float)leftMargin
270  topMargin:(float)topMargin
271  width:(float)width
272  height:(float)height SBS_SWIFT_NAME(setTorchButton(leftMargin:topMargin:width:height:));
273 
286 - (void)setTorchOffButtonAccessibilityLabel:(nonnull NSString *)label
287  hint:(nonnull NSString *)hint;
288 
301 - (void)setTorchOnButtonAccessibilityLabel:(nonnull NSString *)label
302  hint:(nonnull NSString *)hint;
303 
305 
306 
310 
323 - (void)setCameraSwitchVisibility:(SBSCameraSwitchVisibility)visibility;
324 
337 - (BOOL)setCameraSwitchImage:(nonnull UIImage *)cameraSwitchImage
338  pressed:(nonnull UIImage *)cameraSwitchPressedImage;
339 
358 - (BOOL)setCameraSwitchImageResource:(nonnull NSString *)fileName
359  pressedResource:(nonnull NSString *)pressedFileName
360  ofType:(nonnull NSString *)extension;
361 
377 - (void)setCameraSwitchButtonRightMargin:(float)rightMargin
378  topMargin:(float)topMargin
379  width:(float)width
380  height:(float)height SBS_SWIFT_NAME(setCameraSwitchButton(rightMargin:topMargin:width:height:));
381 
395 - (void)setCameraSwitchButtonBackAccessibilityLabel:(nonnull NSString *)label
396  hint:(nonnull NSString *)hint;
397 
411 - (void)setCameraSwitchButtonFrontAccessibilityLabel:(nonnull NSString *)label
412  hint:(nonnull NSString *)hint;
413 
415 
416 
420 
436 - (void)drawViewfinder:(BOOL)draw SBS_DEPRECATED;
437 
458 - (void)setViewfinderHeight:(float)h
459  width:(float)w
460  landscapeHeight:(float)lH
461  landscapeWidth:(float)lW SBS_SWIFT_NAME(setViewfinder(height:width:landscapeHeight:landscapeWidth:));
462 
481 - (void)setViewfinderPortraitWidth:(float)w
482  height:(float)h SBS_SWIFT_NAME(setViewfinderPortrait(width:height:));
483 
484 
503 - (void)setViewfinderLandscapeWidth:(float)w
504  height:(float)h SBS_SWIFT_NAME(setViewfinderLandscape(width:height:));
505 
519 - (void)setViewfinderColor:(float)r green:(float)g blue:(float)b SBS_SWIFT_NAME(setViewfinderColor(red:green:blue:));
520 
534 - (void)setViewfinderDecodedColor:(float)r green:(float)g blue:(float)b SBS_SWIFT_NAME(setViewfinderDecodedColor(red:green:blue:));
535 
536 
545 - (void)resetUI;
547 
548 
552 
561 - (void)showToolBar:(BOOL)show;
562 
572 - (void)setToolBarButtonCaption:(nonnull NSString *)caption;
574 
575 
579 
592 - (void)setMissingCameraPermissionInfoText:(nonnull NSString *)infoText;
594 
595 @end
596 
Definition: SBSOverlayController.h:66
Controls the camera and orchestrates the barcode scanning process.
Definition: SBSBarcodePicker.h:118
controls the scan screen user interface.
Definition: SBSOverlayController.h:92
UIToolbar * toolBar
The tool bar that can be shown at the bottom of the scan screen.
Definition: SBSOverlayController.h:100
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:118
id< SBSOverlayControllerDidCancelDelegate > cancelDelegate
The overlay controller delegate that handles the didCancelWithStatus callback.
Definition: SBSOverlayController.h:107
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:117
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:65
SBSCameraSwitchVisibility
Definition: SBSOverlayController.h:63
#define SBS_ENUM_BEGIN(name)
Definition: SBSCommon.h:16